Skip to content

Meta-rules (MR-1 ... MR-12)

Cross-cutting invariants for the doc/agent system itself. These are meta — they govern the docs that govern the code. If one of these is violated, the system rots from underneath.

These rules apply across all phases, all subagents, all docs. They are the glue. Numbered MR-N to distinguish from project invariants I-N.


  • MR-1 — North-star outranks the backlog
  • MR-2 — Friction surfaced in phase N’s verification round becomes phase N+1’s input
  • MR-3 — Sibling files stay sibling
  • MR-4 — Dates are absolute
  • MR-5 — Direct push for small fixes; PR for checkpoints
  • MR-6 — Subagents read from AGENTS.xml, not from inferred patterns
  • MR-7 — Decision docs are append-only
  • MR-8 — Invariants are numbered and stable
  • MR-9 — Don’t invent invariants
  • MR-10 — The verification round is mandatory at phase close
  • MR-11 — Anti-shapes are named, catalogued, and watched
  • MR-12 — The CLAUDE.md is the projection, not the source

Meta-rule changes are the highest-stakes documentation event. Process: open a decision doc proposing the change, get explicit human approval, bump the meta-rules version line. Renumbering ripples — grep -r "MR-N" before changing IDs.