spec:doctor
Compatibility: If
AskUserQuestionis unavailable, present options as a numbered list and wait for the user's reply. IfTaskis unavailable, run parallel steps sequentially. Thecontext: forkandagent:frontmatter fields are Claude Code-specific — on OpenCode and VS Code Copilot they are ignored and the skill runs inline using the current model.
Diagnose spec setup issues and migrate old path layouts to the current .codevoyant/ structure.
Overview
Checks the project for legacy spec directories and updates them to the consolidated .codevoyant/ layout introduced in the path consolidation migration. Reports every finding before making changes, then applies fixes.
Step 0: Run Diagnostics
Check for each known issue and record findings before touching anything.
Check 1 — Legacy .spec/plans/ directory
[ -d .spec/plans ] && echo "found" || echo "absent"
- Found → will migrate to
.codevoyant/plans/ - Absent → check whether
.codevoyant/plans/exists; if neither exists, note that no plan directory is present yet (fresh project — no action needed)