Menu
Run a full project health diagnostic — checks structure, agents, features, scripts, extensions, and git status.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Wrap core analysis with behavior-first vertical consistency checks.
Apply approved architecture refactors by updating plan and task artifacts directly.
Perform a framework-agnostic architecture review validating implementation against spec.md, plan.md, tasks.md, and the governance and architecture constitutions.
Perform an architecture-aware verification gate validating implementation against spec.md, plan.md, tasks.md, and the Architecture Constitution.
Run a single architecture workflow that prefers memory-first context and can incorporate security review when available.
Run implementation with memory context, then review the produced implementation against security and architecture constraints.
| name | speckit-doctor |
| description | Run a full project health diagnostic — checks structure, agents, features, scripts, extensions, and git status. |
| compatibility | Requires spec-kit project structure with .specify/ directory |
| metadata | {"author":"github-spec-kit","source":"doctor:commands/check.md"} |
Run a diagnostic scan of the current Spec Kit project to identify setup issues, missing artifacts, and configuration problems.
$ARGUMENTS
You MUST consider the user input before proceeding (if not empty).
Run diagnostic script: Execute .specify/scripts/bash/doctor.sh from the project root and review the output.
Analyze results: The script checks 6 areas:
.specify/, specs/, .specify/scripts/, .specify/templates/, .specify/memory/, constitution.mdspecs/, checks for spec.md/plan.md/tasks.mdReport findings: Present the diagnostic results to the user:
Suggest fixes: For each error or warning found, suggest the specific command or action needed to resolve it. Common fixes include:
specify init --here.specify/templates/constitution-template.md/speckit.plan or /speckit.taskschmod +x .specify/scripts/bash/*.shspecify init --here --ai <agent>