Skip to content

Commit dc4162c

Browse files
authored
add docs/governance/CHANGE_CONTROL.md — receipt-update triggers and standing rule
This document outlines the rules for updating receipts and claim boundaries in response to code or claim changes. It specifies triggers for updates and clarifies what does not require a receipt entry.
1 parent f22638f commit dc4162c

1 file changed

Lines changed: 58 additions & 0 deletions

File tree

docs/governance/CHANGE_CONTROL.md

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
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

Comments
 (0)