WORK-499
ID:WORK-499Status:done

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.

Priority:mediumComplexity:simpleMilestone:v0.28.0Source:SPEC-049
claude/milestone-v0-28-0-llvtfa View source

Criteria completion

Criteria completion: 4 of 4 (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. 74979c1
    Created (done)by bjornolofandersson
  2. 9a519fd
    Content editedby Claude
    plan: add v0.28.0 plan-model-hardening milestone and work breakdown

Acceptance Criteria

  • CLAUDE.md "MANDATORY: Work Item Completion Checklist" gains a standalone, imperative numbered step for setting the pr attribute, distinct from the --resolve HEREDOC example
  • The plan init CLAUDE.md template carries the same bullet so new projects get it
  • A docs page under site/content/docs/plan/ describes the new spec statuses (implemented, shipped), the ADR rejected status, the pr attribute, and the happy-path accepted → implemented → shipped lifecycle
  • The --resolve example keeps its Branch: / PR: lines for narrative continuity, but the docs note the attribute is the source of truth

Dependencies

  • WORK-495 — the lifecycle statuses documented
  • WORK-496 — the pr attribute documented

References

  • SPEC-049 — spec (Documentation, Design Principles: the instruction has to be loud)

Resolution

Completed: 2026-07-09

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

What was done

  • CLAUDE.md completion checklist gains a standalone pr step + spec-lifecycle section. plan init template updated. Site docs (spec/decision/work/bug/cli/plan-entities) + SPEC-021 describe the new statuses, pr, released-in, and the accepted→implemented→shipped lifecycle.