# AGENTS.md

## Scope

- This file contains agent-kit repository-specific instructions only.
- Global Codex defaults are versioned in `CODEX_AGENTS.md` and live-loaded through
  `$CODEX_HOME/AGENTS.md`.
- Do not duplicate global guidance here; add only local overrides or local document
  pointers.

## Local Source Of Truth

- Development contract: `DEVELOPMENT.md`
- Global Codex policy source: `CODEX_AGENTS.md`
- Agent-docs dispatch config: `AGENT_DOCS.toml`
- Heuristic System framework: `HEURISTIC_SYSTEM.md`
- Hook source and managed config: `hooks/codex/`

## Repository Maintenance

- Before repository edits, tests, commits, or delivery, resolve:
  `agent-docs --docs-home "$AGENT_HOME" resolve --context startup --strict --format checklist`
  then:
  `agent-docs --docs-home "$AGENT_HOME" resolve --context project-dev --strict --format checklist`
- Before skill lifecycle work, resolve `startup` then `skill-dev`.
- Use `DEVELOPMENT.md` for repository maintenance and validation details.
- Run `scripts/check.sh --all` before reporting maintenance complete.
