ID:SPEC-117Status:draft
Plan status vocabulary consolidation and terminal work states
Name:v0.28.0Status:planning
v0.28.0 — Plan model hardening
Tighten the plan runes' data model along three axes: status vocabulary, spec/PR traceability, and the dependency graph — then sweep the existing content to match.
Progress 11/12 work items
Relationships
- Give
workitems honest terminal states (cancelled,superseded) and make the status vocabulary a true single source of truth (SPEC-117) - Close the spec lifecycle loop —
implemented/shippedstatuses, ADRrejected, first-classprreferences, and traceability rollups (SPEC-049) - Make dependency cycle-detection meaningful via a directed model, clearing the 88 false-positive
circular-dependencyerrors (SPEC-114) - Sweep the plan corpus: retire the pending unbuilt-rune backlog and correct stranded statuses, using the new vocabulary
Work Items
Draft 1
WORK-500 main
Retirement-candidate pass over pending unbuilt runes Once cancelled / superseded exist, review the plan corpus for items that should be retired rather than left dangling. The main pool is the 13 pending work items, all sourced from SPEC-008 (unbuilt runes): stat, math, concept, exercise, glossary, objective, prerequisite, quiz, partner, job, album, artist, video. A reviewed, per-item judgment pass — not an automated flip.
0/5 criteria
Done 11
WORK-443 claude/milestone-v0-28-0-llvtfa
Directional dependency model + cycle-check fix + migration Implement SPEC-114: give plan work/bug dependencies a direction so the validator's cycle detection stops firing on prose cross-references. Today checkCircularDeps builds its graph from every {% ref %} in an entity (e.refs) with no direction, producing 88 false-positive circular-dependency errors across ~35 mostly-done items.
8/8 criteria
WORK-491 claude/milestone-v0-28-0-llvtfa
Fix plan status/severity vocabulary drift in MCP and renderer config The MCP server and renderer config hard-coded their own copies of the status/severity vocabulary and have drifted from the canonical enums.ts — a regression of the drift SPEC-037 / WORK-127 fixed once. This is the quick, standalone fix that ships value before the larger consolidation work.
5/5 criteria
WORK-492 claude/milestone-v0-28-0-llvtfa
Consolidate plan status vocabulary into a single source of truth Make enums.ts the one place that defines status/severity/complexity/priority vocabularies, with derived lifecycle helpers, so consumers stop re-declaring the lists and drift becomes a build failure instead of a latent bug. This lands before the downstream status additions so they inherit the consolidated shape.
7/7 criteria
WORK-493 claude/milestone-v0-28-0-llvtfa
Add cancelled and superseded terminal work statuses Give work items an honest way to be retired: cancelled (deliberately not doing it) and superseded (replaced by another item), plus a supersedes attribute. Both are terminal and non-achieving. Builds on the consolidated vocabulary from WORK-492.
8/8 criteria
WORK-494 claude/milestone-v0-28-0-llvtfa
Document terminal work statuses and consolidated vocabulary Update the canonical spec and agent-facing docs so the new work terminals and the pending status are described everywhere authors and agents look.
5/5 criteria
WORK-495 claude/milestone-v0-28-0-llvtfa
Add spec implemented/shipped and ADR rejected statuses Close the "is it built / is it available?" gap on specs, and give ADRs an honest "considered and declined" state. Rides on the consolidated vocabulary from WORK-492.
7/7 criteria
WORK-496 claude/milestone-v0-28-0-llvtfa
Add pr attribute to work and bug runes Promote PR references from unstructured resolution prose to a first-class, validated, queryable attribute so traceability rollups become possible.
6/6 criteria
WORK-497 claude/milestone-v0-28-0-llvtfa
plan status PR rollups and implemented-flip suggestion Surface the traceability data structurally so missing PRs and ready-to-flip specs are visible without grepping prose.
5/5 criteria
WORK-498 claude/milestone-v0-28-0-llvtfa
refrakt plan migrate pr-attrs — git backfill of PR references Backfill the pr attribute on legacy done work / fixed bug items from git merge-commit history, so plan status rollups are rich from day one rather than skeletal (only ~2 of 177 items carry a PR today).
6/6 criteria
WORK-499 claude/milestone-v0-28-0-llvtfa
CLAUDE.md pr checklist bullet and spec-lifecycle docs Make the PR-linkage instruction loud (a line inside an example block has a ~1% hit rate) and document the full lifecycle for humans.
4/4 criteria
WORK-501 claude/milestone-v0-28-0-llvtfa
General status-correctness audit of the plan corpus Sweep the small set of non-terminal, non-ready work items for entries carrying the wrong status, independent of the new terminals. Human-judgment pass over a bounded list.
5/5 criteria