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

AGENTS - Scanner.MaterialChanges Library

Roles

• Backend engineer: maintain material change orchestration and card generation.
• QA / test engineer: validate deterministic report outputs and ordering.

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.MaterialChanges
• Related tests: src/Scanner/__Tests/StellaOps.Scanner.MaterialChanges.Tests
• Avoid cross-module edits unless explicitly noted in the sprint file.

Determinism and Safety

• Ensure report ordering and hashes are deterministic (stable sort, canonical inputs).
• Avoid culture-sensitive comparisons when mapping severity or kinds.

Testing

• Cover report ID determinism, summary aggregation, and option handling.