Blacksite/docs/AGENTS.md

587 B

Documentation subtree rules

  • Read docs/authority.toml before treating a document as current.
  • Canonical docs describe current behavior; active plans describe incomplete work; accepted ADRs describe decisions and constraints; evaluations describe dated evidence.
  • Historical and superseded documents are not current requirements.
  • Do not duplicate detailed contracts across README, guides, plans, ADRs, and tracker bodies.
  • Update the smallest canonical surface that owns the changed behavior.
  • Run scripts/codex/docs_audit.py through the documentation-integrity workflow.