gsd-health

To validate a planning directory, run a health workflow that scans the .planning configurations, checks for missing files, and detects orphaned plans to ensure project workflow consistency.

Planning directory health repair is the process of diagnosing structural and consistency issues within .planning configurations. You need it when project workflows fail due to missing files, misconfigurations, or orphaned plans.

You can run an automated repair on misconfigured planning files by executing the health workflow and applying the --repair flag, which triggers automated fixes for detected directory inconsistencies.

To detect and resolve orphaned plans, execute a plan consistency check across the planning directory. The health workflow identifies orphaned plans and provides remediation guidance or applies fixes with the --repair flag.

No, this planning directory validation requires no external dependencies. It operates directly on the .planning directory structure to read and execute health workflow definitions without additional tooling.

The best way to ensure cross-plan consistency is to run a health workflow that validates the .planning directory, checks configuration alignment, and detects orphaned plans across the entire project workflow.