Skip to content

Changing a meta-rule

Meta-rule changes are the highest-stakes documentation event in the petrova line. They ripple through every consumer repo’s CLAUDE.md projection, every verb’s upholds list, every PR body’s MR citations.

  1. Open a dated decision doc in petrova-hq’s own docs/decisions/ proposing the change. Cite the trigger (a finding, a friction round, a structural inconsistency).
  2. Get explicit human countersign before merging the decision.
  3. Edit core/templates/META-RULES.md. Bump the version line at the foot of the file.
  4. Grep MR-<N> across petrova-hq, kahn-hq, smo1-io and any other consumer; update references.
  5. Update verb schemas’ upholds arrays where impacted.
  6. The next sync-docs.mjs run regenerates the affected MR pages.
  • Renumbering an MR without a decision doc (breaks every existing citation).
  • “Clarifying” an MR’s text in place without a supersession doc (violates MR-7’s append-only rule, which itself is an MR).
  • Adding a new MR without a process trigger (decisions are reactive, not proactive).