§0statement
← All patterns

Authority order

When two files disagree, a declared rank decides.

§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

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

Used in: Case 5, Case 6, and this site's AGENTS.md.