fix: align Small-tier plan-review rule and changelog wording

Resolve two consistency nits from review: shape-spec said plan-review was
'optional' for Small while the README canonical table says skip it (align
to skip); and the changelog now describes both misuse directions the new
rationalizations guard against, not just gate-skipping.
This commit is contained in:
duthaho
2026-07-22 05:00:06 +00:00
parent 81c94aee91
commit bc6418761d
2 changed files with 5 additions and 5 deletions
+3 -2
View File
@@ -15,8 +15,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
the non-negotiable rule (`verification-gate` and `code-review-loop` always run, the non-negotiable rule (`verification-gate` and `code-review-loop` always run,
any tier); `shape-spec` gains a `Step 0: Size the change` routing gate; any tier); `shape-spec` gains a `Step 0: Size the change` routing gate;
`write-plan` and `plan-review` declare which tier they belong to; each of the `write-plan` and `plan-review` declare which tier they belong to; each of the
three carries a new rationalization against skipping the gate under the "it's three carries a new rationalization against misusing the tier model — skipping
trivial" excuse the evidence gate under an "it's trivial" excuse, or over-applying full ceremony
to a one-liner
### Added ### Added
+2 -3
View File
@@ -55,9 +55,8 @@ change is how the missing constraint ships.
- **Trivial** — one-line / single-file / describable in one sentence. **Stop - **Trivial** — one-line / single-file / describable in one sentence. **Stop
here — no spec.** Make the change, then go straight to `verification-gate` here — no spec.** Make the change, then go straight to `verification-gate`
and `code-review-loop`. and `code-review-loop`.
- **Small** — one focused change, ≤ ~3 files, design obvious. **Skip the spec** - **Small** — one focused change, ≤ ~3 files, design obvious. **Skip the spec
and hand off to `write-plan` for a lightweight inline plan; `plan-review` is and plan-review**; hand off to `write-plan` for a lightweight inline plan.
optional at this tier.
- **Standard** — multi-file, multi-session, or real design decisions. Continue - **Standard** — multi-file, multi-session, or real design decisions. Continue
to Step 1 and write the full spec. to Step 1 and write the full spec.
2. Whatever the tier, the evidence never scales to zero: `verification-gate` runs 2. Whatever the tier, the evidence never scales to zero: `verification-gate` runs