health

To check planning directory integrity, run a diagnostic scan that validates required files, JSON structure, and phase consistency across ROADMAP.md and STATE.md, then reports exact failures with suggested fixes without modifying any files.

Planning directory state management validation is a read-only diagnostic process that checks STATE.md accuracy, verifies plan and summary pairings, and surfaces frontmatter and hook-log inconsistencies to ensure project tracking artifacts remain reliable.

To diagnose phase consistency issues, run a non-destructive check that compares ROADMAP.md phases against STATE.md entries and plan/summary pairings, highlighting exact files where configurations mismatch and suggesting concrete fixes for manual review.

Yes, you can run read-only planning checks that enforce strict non-destructive operation by never modifying files, instead generating a concise health report that identifies integrity failures and provides actionable fix suggestions for human review.

A planning directory health report shows frontmatter errors when sanity checks detect malformed metadata or missing required fields in your planning artifacts, surfacing the exact files affected and the specific configuration issues requiring manual correction.

The best way to validate plan and summary pairings is to run a comprehensive integrity scan that checks every planning artifact pairing against ROADMAP.md and STATE.md, ensuring phase and state accuracy while reporting mismatches with suggested fixes.