|
| 1 | +# CHANGE CONTROL |
| 2 | + |
| 3 | +Short rule file for when claim or invariant changes require a receipt update. |
| 4 | + |
| 5 | +This file governs **when** documentation must be updated alongside a code or claim change. It is intentionally short. The PR template enforces the checklist; this file defines the triggers. |
| 6 | + |
| 7 | +--- |
| 8 | + |
| 9 | +## Triggers requiring a BUILD_RECEIPTS.md update |
| 10 | + |
| 11 | +A receipt entry **must** be added to `docs/governance/BUILD_RECEIPTS.md` when a commit: |
| 12 | + |
| 13 | +1. Adds, removes, or modifies an invariant in `INVARIANTS.md` |
| 14 | +2. Adds, removes, or modifies an adversarial vector in `INVARIANT_TEST_VECTORS_v1.json` |
| 15 | +3. Changes the behaviour of `scripts/verify_adversarial_invariants.py` |
| 16 | +4. Adds, removes, or modifies a claim in `ADMISSIBLE_CLAIM_REGISTER_v1.md` |
| 17 | +5. Changes the CI workflow in a way that affects enforcement scope |
| 18 | +6. Changes the PR template in a way that affects contributor obligations |
| 19 | + |
| 20 | +--- |
| 21 | + |
| 22 | +## Triggers requiring a claim-boundary review |
| 23 | + |
| 24 | +The standing claim boundary **must** be re-stated (not silently widened) when a commit: |
| 25 | + |
| 26 | +1. Promotes a configured surface to an evidenced one (e.g. CI green proof) |
| 27 | +2. Adds a new proof surface visible from README or entry |
| 28 | +3. Removes or weakens an existing proof surface |
| 29 | + |
| 30 | +--- |
| 31 | + |
| 32 | +## Triggers NOT requiring a receipt update |
| 33 | + |
| 34 | +To prevent ledger bloat, the following do **not** require a receipt entry: |
| 35 | + |
| 36 | +- Typo fixes |
| 37 | +- Formatting-only changes |
| 38 | +- Internal comments and docstrings without behavioural change |
| 39 | +- Dependency bumps that do not affect verifier output |
| 40 | + |
| 41 | +--- |
| 42 | + |
| 43 | +## Receipt entry shape |
| 44 | + |
| 45 | +Each receipt entry in `BUILD_RECEIPTS.md` should record: |
| 46 | + |
| 47 | +- Commit SHA (short) |
| 48 | +- File(s) affected |
| 49 | +- Structural layer |
| 50 | +- What is now held |
| 51 | +- What is still not held |
| 52 | +- Safe claim |
| 53 | + |
| 54 | +--- |
| 55 | + |
| 56 | +## Standing rule |
| 57 | + |
| 58 | +*No claim is upgraded without an evidenced trigger. No surface is widened without a receipt. The boundary is re-stated, never assumed.* |
0 commit comments