diff options
| author | Craig Jennings <c@cjennings.net> | 2026-06-12 19:33:12 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-06-12 19:33:12 -0500 |
| commit | 22edacfd03de68eabd96d9aaa98a4dd5693535a6 (patch) | |
| tree | 242b67435ea9965e23728ad5a9ba73180dac0257 /.ai/workflows/spec-review.org | |
| parent | f058b4c15a67ce3b54e306e8b4778aa3cb540c7c (diff) | |
| download | rulesets-22edacfd03de68eabd96d9aaa98a4dd5693535a6.tar.gz rulesets-22edacfd03de68eabd96d9aaa98a4dd5693535a6.zip | |
feat(workflows): SUPERSEDED/CANCELLED decision states + old-model gate
A superseded decision now flips to SUPERSEDED (linking its replacement) and a moot one to CANCELLED. Both are done-class via a #+TODO: header the spec template auto-adds, so the [/] cookie counts them resolved and neither blocks implementation-ready. The TODO/DONE pair alone had lost the old State: field's superseded value.
spec-review's gate and Ready rubric now read "no decision is still TODO", and a spec still on the retired State: field model fails the gate item until converted. The gate as first written would have vacuously passed old specs, which have no decision tasks at all.
Diffstat (limited to '.ai/workflows/spec-review.org')
| -rw-r--r-- | .ai/workflows/spec-review.org | 9 |
1 files changed, 7 insertions, 2 deletions
diff --git a/.ai/workflows/spec-review.org b/.ai/workflows/spec-review.org index 61c1239..d956f00 100644 --- a/.ai/workflows/spec-review.org +++ b/.ai/workflows/spec-review.org @@ -74,7 +74,7 @@ Mark the spec implementation-ready only if *all* of these hold: - Scope is explicit: v1, out-of-scope, and vNext are separated. - Project principles are explicit where the feature touches user data, remote systems, destructive actions, long-running operations, or public extension points. - All prior review questions/recommendations are answered or intentionally deferred. -- Every decision in the spec's =* Decisions= section is =DONE= (the =[/]= cookie reads complete), or each still-=TODO= decision carries a consciously-accepted, recorded risk. +- Every decision in the spec's =* Decisions= section is resolved — no =TODO= remains (the =[/]= cookie reads complete; =SUPERSEDED= and =CANCELLED= count as resolved), or each still-open decision carries a consciously-accepted, recorded risk. A spec still on the retired =State: proposed | accepted | superseded= field model fails this item until converted to decision tasks — convert on the next material touch. - The expected UX is concrete enough to implement without guessing. - Existing platform/framework affordances are reused, wrapped, or intentionally replaced; lost opportunities are called out. - The data model, state ownership, persistence, and sync behavior are defined. @@ -186,7 +186,7 @@ Deferred features to capture in task tracking. Assign one label consistently: -- =Ready= — no blocking open questions; implementation can start. Requires every decision in the spec's =* Decisions= section to be =DONE= (the =[/]= cookie reads complete) — a decision still =TODO= holds the rubric at =Not ready=, or =Ready with caveats= if the author consciously accepts and records the risk. +- =Ready= — no blocking open questions; implementation can start. Requires no decision in the spec's =* Decisions= section to still be =TODO= (the =[/]= cookie reads complete; =SUPERSEDED= and =CANCELLED= count as resolved) — a decision still =TODO= holds the rubric at =Not ready=, or =Ready with caveats= if the author consciously accepts and records the risk. - =Ready with caveats= — can start if the caveats are accepted and tracked. - =Not ready= — blocking ambiguity / missing decisions would force implementers to invent product behavior. - =Needs research= — external API/library/platform assumptions must be verified first. @@ -349,3 +349,8 @@ Sources: - *What:* Reconciled this workflow to spec-create's new Decisions convention (each decision is an org =TODO= task that flips to =DONE= on agreement, with a =[/]= cookie on the =* Decisions= heading). The Phase 1/3 readiness gate gains an all-decisions-=DONE= item, and the Phase 6 =Ready= rubric label now requires the =[/]= cookie to read complete (a still-=TODO= decision holds the rubric at =Not ready=, or =Ready with caveats= on a recorded, consciously-accepted risk). - *Why:* The convention change landed in spec-create.org via an .emacs.d handoff (originated in its keymap-consolidation spec); the rubric still gated on the retired =State:= field model. - *Artifacts:* Handoff =inbox/2026-06-12-1906-from-.emacs.d-spec-create-decisions-todo-note.org=. Paired spec-create.org and spec-response.org edits in the same commit. + +** 2026-06-12 Fri @ 19:30:03 -0500 — Claude Code (rulesets) — author +- *What:* Two refinements to the same-day decisions convention after Craig's review: the gate item and =Ready= rubric now read "no decision is still =TODO=" with =SUPERSEDED= and =CANCELLED= counting as resolved (spec-create's template defines them as done-class keywords via a =#+TODO:= header), and a spec still on the retired =State:= field model explicitly fails the gate item until converted — closing the vacuous-pass hole on old specs. +- *Why:* Review of the freshly-landed convention flagged that TODO/DONE alone lost the old model's superseded state and that the gate as written would silently pass a spec with no decision tasks at all. Craig chose the two done-class keywords and the auto-added =#+TODO:= header (the in-file header is what makes custom keywords portable). +- *Artifacts:* Paired spec-create.org edits (keyword scheme + template header) in the same commit. |
