cyberneticlibrary

Check and repair planning directories

gsd:healthskillsetup L13,035
davepoon/buildwithclaude
What it does

Diagnose planning directory health and repair issues

Best for

Validating .planning/ integrity before running major workflow operations, catching configuration drift early.

Inputs
  • · Optional --repair flag to auto-fix problems
Outputs
  • · Health report with identified issues
  • · Optional repairs applied (if --repair)
Requires
  • · health.md workflow
Preconditions
  • · .planning/ directory exists
Failure modes
  • · Inconsistent state in STATE.md → flagged for manual review
  • · Missing required files → reported with guidance on creation
  • · Orphaned plans (no phase reference) → detected and listed
Trust signals
  • · Checks for missing files, invalid configs, inconsistent state, orphaned plans
  • · Actionable repair suggestions
  • · --repair flag for automated fixes