up

src/Scanner/__Libraries/StellaOps.Scanner.SmartDiff/AGENTS.md

@@ -0,0 +1,28 @@
+# StellaOps.Scanner.SmartDiff — Agent Charter
+
+## Mission
+Deliver Smart-Diff primitives and detection logic that enable deterministic, attestable differential analysis between two scans, reducing noise to material risk changes.
+
+## Responsibilities
+- Define Smart-Diff predicate models and deterministic serialization helpers.
+- Implement reachability gate computation and Smart-Diff delta structures.
+- Provide material change detection and scoring (see `SPRINT_3500*`).
+
+## Interfaces & Dependencies
+- Consumed by Scanner WebService/Worker and downstream policy/VEX flows.
+- Predicate schemas are versioned/registered under `src/Attestor/StellaOps.Attestor.Types`.
+
+## Testing Expectations
+- Unit tests for reachability gate computation and enum serialization.
+- Golden predicate fixtures to ensure deterministic output.
+
+## Required Reading
+- `docs/product-advisories/14-Dec-2025 - Smart-Diff Technical Reference.md`
+- `docs/modules/scanner/architecture.md`
+- `docs/modules/platform/architecture-overview.md`
+
+## Working Agreement
+- 1. Update task status to `DOING`/`DONE` in the sprint file `/docs/implplan/SPRINT_*.md` when starting/finishing work.
+- 2. Keep outputs deterministic (stable ordering, UTC timestamps, invariant formatting).
+- 3. Avoid cross-module edits unless explicitly referenced in the sprint and recorded in Decisions & Risks.
+