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
claude/milestone-v0-28-0-llvtfa View source

Criteria completion

Criteria completion: 5 of 5 (100%) checked; tracking started on Jul 9, no incremental history yet0%25%50%75%100%Jul 9Jul 11

Tracking started Jul 9 — check back for trends.

Relationships

Implements 1
Related 2
Branches 2
claude/milestone-v0-28-0-llvtfa current done
claude/plan-runes-status-vocab-jcq1tx draftmain draft
History 2
  1. 80473b1
    Created (done)by bjornolofandersson
  2. 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.