gsd-health

Planning directory health checks identify missing required files, misconfigurations, inconsistent state, and orphaned plans. Validating these structural and state elements ensures your directory maintains the integrity needed for reliable planning execution.

The best way to validate required files and configurations is to execute a dedicated health workflow against the .planning directory. This process parses the directory structure to report integrity issues and optionally repair them when requested.

No external dependencies are required to run a planning directory health check. The validation workflow operates independently to identify and report integrity issues in the .planning directory without relying on external components or modules.

Planning workflows fail due to inconsistent state or orphaned plans when the .planning directory's internal integrity is compromised. Running a health check diagnoses these specific issues, providing actionable guidance to restore proper structure and state.

Yes, you can automatically fix missing files and misconfigurations by running the health workflow with the --repair argument. This parses the repair request and applies fixes to resolve the identified directory integrity issues.