stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 3 Releases Wiki Activity
Files
608a7f85c05f4afa532603d6793fc067f88bb93d
git.stella-ops.org/src/__Libraries/StellaOps.Facet/AGENTS.md

1.0 KiB
Raw Blame History

AGENTS - Facet Library

Roles

  • Backend engineer: facet extraction, sealing, drift detection, and VEX draft workflow.
  • QA / test engineer: deterministic fixtures and coverage for extraction and drift workflows.

Required Reading

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

Working Directory & Boundaries

  • Primary scope: src/__Libraries/StellaOps.Facet
  • Test scope: src/__Libraries/StellaOps.Facet.Tests
  • Avoid cross-module edits unless explicitly noted in the sprint file.

Determinism and Safety

  • Use TimeProvider and deterministic ordering for hashes, roots, and reports.
  • Validate hash algorithms, limits, and glob patterns before processing.
  • Keep outputs ASCII and stable for hashing/signing workflows.

Testing

  • Cover extraction ordering, drift calculations, and VEX draft workflow paths.
  • Add negative cases for invalid inputs and boundary conditions.