git.stella-ops.org/src/Scanner/__Libraries/StellaOps.Scanner.Gate/AGENTS.md

AGENTS - Scanner Gate Library

Roles

• Backend engineer: .NET 10 gate policy, DI wiring, configuration, and determinism.
• QA / bench engineer: tests for policy evaluation, caching, audit logging, and config validation.

Required Reading

• docs/README.md
• docs/07_HIGH_LEVEL_ARCHITECTURE.md
• docs/modules/platform/architecture-overview.md
• docs/modules/scanner/architecture.md
• src/Scanner/AGENTS.md
• Current sprint file under docs/implplan/SPRINT_*.md

Working Directory & Boundaries

• Primary scope: src/Scanner/__Libraries/StellaOps.Scanner.Gate
• Test scope: src/Scanner/__Tests/StellaOps.Scanner.Gate.Tests (create if missing)
• Avoid cross-module edits unless explicitly allowed in the sprint file.

Determinism and Safety

• Inject TimeProvider and IGuidGenerator; no DateTime.UtcNow or Guid.NewGuid in production code.
• Use InvariantCulture for parsing/formatting and stable ordering for rule evaluation.

Testing

• Cover policy evaluation, options validation, caching behavior, and audit logging.
• Use deterministic fixtures and fixed time providers in tests.