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.

claude/file-naming-convention-LJdwR View source

Criteria completion

Tracking started Apr 21 — check back for trends.

Relationships

ID:SPEC-037Status:accepted

Plan Package Hardening

Version:1.0

ID:WORK-127Status:done

Fix plan schema bugs: pending status, severity mismatch, tag filtering

Priority:highComplexity:simple

ID:WORK-128Status:done

Add source, milestone, and complexity validation to plan validate

Priority:highComplexity:simple

ID:WORK-024Status:done

Add knownSections to Plan Rune Content Models

Priority:mediumComplexity:moderate

ID:WORK-130Status:done

Support attribute clearing in plan CLI update command

Priority:lowComplexity:simple

claude/file-naming-convention-LJdwR current done

changeset-release/main done main done

Apr 21, 01:29 PMbbbb94c
Created (done)by bjornolofandersson
Apr 21, 01:17 PMf2b3512
Content editedby Claude
Add {ID}-{slug}.md filename convention + migrate filenames subcommand

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)