WORK-131
ID:WORK-131Status:donePriority:mediumComplexity:simpleSource:SPEC-037

Update site docs and plan CLAUDE.md for plan package hardening changes

After the SPEC-037 work items ship, the documentation needs to reflect the new capabilities: pending status, knownSections, attribute clearing, and the updated validation checks.

Acceptance Criteria

  • plan/CLAUDE.md documents pending status in the Valid Statuses section (if not already present)
  • plan/CLAUDE.md documents the --clear / empty-string attribute clearing syntax for update
  • plan/CLAUDE.md documents knownSections and their aliases for work/bug/decision runes
  • plan/CLAUDE.md documents the Dependencies section convention (refs in Dependencies block the next command)
  • Root CLAUDE.md plan workflow section updated if any command interfaces changed
  • Site docs (site/content/docs/packages/) updated if the packages index references plan package capabilities

Dependencies

References

Resolution

Completed: 2026-04-12

Branch: claude/spec-037-breakdown-docs-Whj40

What was done

  • Updated plan/CLAUDE.md work template to include Dependencies section with ref tags
  • Documented Dependencies vs References convention
  • Documented known sections with aliases for work/bug/decision
  • Documented attribute clearing syntax (--assignee "")
  • Root CLAUDE.md was already up to date; no site doc changes needed (plan package not referenced)

History

  1. a295513
    statusdraftdone
    • ☑ `plan/CLAUDE.md` documents `pending` status in the Valid Statuses section (if not already present)
    • ☑ `plan/CLAUDE.md` documents the `--clear` / empty-string attribute clearing syntax for `update`
    • ☑ `plan/CLAUDE.md` documents knownSections and their aliases for work/bug/decision runes
    • +3 more criteria
  2. 1676387
    Created (draft, medium, simple, SPEC-037, docs, plan)