Refactor code structure for improved readability and maintainability; optimize performance in key functions.
This commit is contained in:
@@ -0,0 +1,36 @@
|
||||
# AGENTS - Scanner Reachability Library
|
||||
|
||||
## Mission
|
||||
Deliver deterministic reachability analysis, slice generation, and evidence artifacts used by Scanner and downstream policy/VEX workflows.
|
||||
|
||||
## Roles
|
||||
- Backend engineer (.NET 10, C# preview).
|
||||
- QA engineer (unit/integration tests with deterministic fixtures).
|
||||
|
||||
## Required Reading
|
||||
- `docs/README.md`
|
||||
- `docs/07_HIGH_LEVEL_ARCHITECTURE.md`
|
||||
- `docs/modules/platform/architecture-overview.md`
|
||||
- `docs/modules/scanner/architecture.md`
|
||||
- `docs/reachability/DELIVERY_GUIDE.md`
|
||||
- `docs/reachability/slice-schema.md`
|
||||
- `docs/reachability/replay-verification.md`
|
||||
|
||||
## Working Directory & Boundaries
|
||||
- Primary scope: `src/Scanner/__Libraries/StellaOps.Scanner.Reachability/`
|
||||
- Tests: `src/Scanner/__Tests/StellaOps.Scanner.Reachability.Tests/`
|
||||
- Avoid cross-module edits unless explicitly noted in the sprint.
|
||||
|
||||
## Determinism & Offline Rules
|
||||
- Stable ordering for graphs, slices, and diffs.
|
||||
- UTC timestamps only; avoid wall-clock nondeterminism.
|
||||
- Offline-first: no external network calls; use CAS and local caches.
|
||||
|
||||
## Testing Expectations
|
||||
- Add schema validation and round-trip tests for slice artifacts.
|
||||
- Ensure deterministic serialization bytes for any DSSE payloads.
|
||||
- Run `dotnet test src/Scanner/StellaOps.Scanner.sln` when feasible.
|
||||
|
||||
## Workflow
|
||||
- Update sprint status on task transitions.
|
||||
- Record decisions/risks in sprint Execution Log and Decisions & Risks.
|
||||
Reference in New Issue
Block a user