|
19 | 19 |
|
20 | 20 | ## Decision |
21 | 21 |
|
22 | | -`docs/plans/` is a **fourth document category**: **mutable, non-authoritative design notes that accompany a milestone's implementation**. Its contract: |
| 22 | +`docs/plans/` is a **fourth document category**: **mutable, non-authoritative design notes**. These are either *milestone plans* that accompany an implementation (the M4/M5 plans) or *pre-implementation scoping notes* that capture the constraint set and options for future work before it is scheduled (e.g. a Phase-3 privilege-separation scoping note; issue #79 asked whether the lane covers such non-milestone notes — it does). Its contract: |
23 | 23 |
|
24 | | -1. **Non-authoritative after merge.** A plan guides the work while it is written and merged alongside it, but once the milestone lands the *code, ADRs, and RFCs* are authoritative — not the plan. A plan is retained for its design rationale, not as a source of truth for what the system does. |
| 24 | +1. **Non-authoritative after merge.** A note guides the work while it is written and merged alongside it, but once the work lands the *code, ADRs, and RFCs* are authoritative — not the note. A scoping note for not-yet-scheduled work is non-authoritative from the start: it records a constraint set and options, never a decision. A note is retained for its design rationale, not as a source of truth for what the system does. |
25 | 25 |
|
26 | | -2. **A mandatory, dated `Governance status` banner** heads every file in `docs/plans/`, in the same spirit as ADR-0015's errata banners. It states: the date, that the file is non-authoritative post-merge, which milestone it guided, and **which ADRs/RFCs hold the locked-in decisions**. Template: |
| 26 | +2. **A mandatory, dated `Governance status` banner** heads every file in `docs/plans/`, in the same spirit as ADR-0015's errata banners. It states: the date, that the file is non-authoritative, what it guides or scopes, and **which ADRs/RFCs (and/or tracking issue) hold the authoritative decisions**. Template: |
27 | 27 |
|
28 | 28 | ``` |
29 | 29 | <!-- |
30 | 30 | Governance status (YYYY-MM-DD): |
31 | | - Non-authoritative design note (ADR-0027). Guided <milestone> (PR #NN). |
32 | | - Locked-in decisions live in ADRs/RFCs: <list>. This file is retained |
33 | | - for rationale and is not a source of truth post-merge. |
| 31 | + Non-authoritative design note (ADR-0027). <Guided <milestone> (PR #NN) |
| 32 | + | Scopes <future work>; tracked in #NN>. |
| 33 | + Authoritative decisions live in ADRs/RFCs: <list, or "none yet">. |
| 34 | + This file is retained for rationale and is not a source of truth. |
34 | 35 | --> |
35 | 36 | ``` |
36 | 37 |
|
|
0 commit comments