parade-doctor

To run a Parade project health check, execute parade-doctor to validate core directories like .parade, .claude, and .beads, verify database schema, and test project.yaml configuration, outputting actionable recommendations for any issues found.

Parade discovery.db database issues occur when the file is inaccessible or missing required tables. The parade-doctor tool verifies database readability, checks for required schema tables, and surfaces clear remediation guidance to fix the problem.

A Parade project health check validates critical folder existence across .parade, .claude, and .beads, checks discovery.db database accessibility and required tables, and confirms project.yaml is valid YAML configuration.

You can use parade-doctor for both initial Parade project setup and ongoing debugging. It continuously diagnoses configuration validity, database schema health, and core directory presence to surface clear remediation guidance.

To fix missing Parade directories, run parade-doctor to detect absent .parade, .claude, and .beads folders and generate a health report with actionable recommendations and specific remediation steps.

The best way to validate project.yaml configuration is running parade-doctor, which checks that the YAML file is syntactically valid and surfaces clear remediation guidance if configuration issues are detected.