WORK-131
ID:WORK-131Status:done

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.

Priority:mediumComplexity:simpleSource:SPEC-037

Criteria completion

Criteria completion: 6 of 6 (100%) checked; history from Apr 12 to Apr 120%25%50%75%100%Apr 12Apr 12
Branches 2
History 3
  1. e900a90
    Created (done)by bjornolofandersson
  2. a295513
    • ☑ `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
    by Claude
  3. 1676387
    Created (draft)by Claude
    Accept SPEC-037 and break into work items; fix plan validation issues

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

  • WORK-127 — schema bug fixes
  • WORK-128 — validation gaps
  • WORK-024 — knownSections
  • WORK-130 — attribute clearing

References

  • SPEC-037 — Plan Package Hardening

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)