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
changeset-release/main View source

Criteria completion

No incremental history — criteria tracking started on Apr 19.

Branches 2
changeset-release/main current done
main doneclaude/file-naming-convention-LJdwR done
History 3
  1. f2b3512
    Content editedby Claude
    Add {ID}-{slug}.md filename convention + migrate filenames subcommand
  2. a295513
    Content editedby Claude
    Mark all SPEC-037 work items done with acceptance criteria and resolutio
  3. 1676387
    Created (done)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)