git.stella-ops.org/policies/AGENTS.md

policies/AGENTS.md

Purpose & Scope

• Working directory: policies/ (policy packs, overrides, and metadata).
• Roles: policy engineer, QA, docs contributor.

Required Reading (treat as read before DOING)

• docs/README.md
• docs/modules/policy/architecture.md
• docs/policy/dsl-reference.md (if present)
• Relevant sprint file(s).

Working Agreements

• Policy packs must be versioned and deterministic.
• Use clear comments for default rules and override precedence.
• Keep offline-friendly defaults; avoid network dependencies in policy evaluation examples.
• When policy behavior changes, update corresponding docs under docs/policy/.

Validation

• Validate policy YAML against schema when available.
• Add/extend tests in Policy module to cover policy pack behavior.