# 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.