Add source, milestone, and complexity validation to plan validate

The validate command has blind spots: source attribute references to non-existent specs/decisions go undetected, milestone references to non-existent milestones pass silently, and complexity values aren't checked at all. These gaps let broken references and invalid data persist.

claude/file-naming-convention-LJdwR View source

Criteria completion

No incremental history — criteria tracking started on Apr 21.

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-131Status:done

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

Priority:mediumComplexity:simple

claude/file-naming-convention-LJdwR current done

main done changeset-release/main done

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

Acceptance Criteria

validate resolves each comma-separated ID in source against the entity index and reports broken references as errors
validate checks that milestone values match an existing milestone entity
validate checks complexity values against the valid set (trivial, simple, moderate, complex, unknown)
Broken source references report the referencing entity ID and the missing target ID
Tests for source validation, milestone validation, and complexity validation

Dependencies

WORK-127 — schema bug fixes should land first (especially the severity/complexity alignment)

References

SPEC-037 — Plan Package Hardening (Part 2: Validation Gaps)

Resolution

Completed: 2026-04-12

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

What was done

Added checkSourceRefs(): validates comma-separated source IDs against entity index
Added checkMilestoneRefs(): validates milestone values against existing milestones
Complexity validation already handled by WORK-127
5 new tests for source/milestone validation