§0statement
§1why
Why it works
An agentAn AI program that writes and changes code, for example Claude Code or Cursor. On this site, "agent" means a coding agent. that finds two conflicting rules picks one, often the last it read. A declared order turns that guess into a lookup.
§2example
Copy this
## Authority
When two files disagree, the higher one wins:
1. AGENTS.md
2. DECISIONS.md (the register)
3. components/*/README.md
4. skills/
5. generated catalogs
§3breaks
Where it breaks
The order only helps if the conflict is noticed. A rule that is silently stale in the higher file still wins.
§4cases