WORK-494
ID:WORK-494Status:done

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.

Priority:mediumComplexity:simpleMilestone:v0.28.0Source:SPEC-117
main View source

Criteria completion

Criteria completion: 5 of 5 (100%) checked; history from Jul 9 to Jul 140%25%50%75%100%Jul 9Jul 14

Relationships

Implements 1
Related 2
Branches 3
main current done
changeset-release/main doneclaude/milestone-v0-28-0-llvtfa doneclaude/plan-runes-status-vocab-jcq1tx draft
History 3
  1. cf13ce1
    • ☑ {% ref "SPEC-021" /%} `work` attribute table and status-badge table updated to include `pending`, `cancelled`, `superseded`, and the `supersedes` attribute
    • ☑ `plan/CLAUDE.md` documents when to use `cancelled` vs `superseded` vs deleting a file
    • ☑ The `plan init` CLAUDE.md template (`commands/init.ts` / `templates.ts`) carries the same guidance so new projects get it
    • ☑ Site docs under `site/content/docs/plan/` describe the terminal work states
    • ☑ `refrakt reference` / agent-facing enum output reflects the new values (regenerate if generated)
    by bjornolofandersson
  2. 283ce5a
    Created (draft)by bjornolofandersson
  3. 9a519fd
    Content editedby Claude
    plan: add v0.28.0 plan-model-hardening milestone and work breakdown

Acceptance Criteria

  • SPEC-021 work attribute table and status-badge table updated to include pending, cancelled, superseded, and the supersedes attribute
  • plan/CLAUDE.md documents when to use cancelled vs superseded vs deleting a file
  • The plan init CLAUDE.md template (commands/init.ts / templates.ts) carries the same guidance so new projects get it
  • Site docs under site/content/docs/plan/ describe the terminal work states
  • refrakt reference / agent-facing enum output reflects the new values (regenerate if generated)

Dependencies

  • WORK-493 — documents the statuses it introduces

References

  • SPEC-117 — spec (Documentation)

Resolution

Completed: 2026-07-09

Branch: claude/milestone-v0-28-0-llvtfa PR: refrakt-md/refrakt#565

What was done

  • SPEC-021 work-attribute + status-badge tables updated (pending, cancelled, superseded, supersedes).
  • Root CLAUDE.md + the plan init template document cancelled vs superseded vs delete.
  • Site docs (site/content/runes/plan/work.md, plan/docs/plan-entities.md, runes/plan/cli.md) describe the terminal states.

Notes

  • Agent-facing enum output derives from enums.ts, so refrakt reference reflects the new values automatically.