Skip to content

💫 Toolkit to help you get started with SDD or any other process!

Add specify doctor command for project health diagnostics (#1828)

KhawarHabibKhanb9c1a1c7bb8f
diff --git a/extensions/README.md b/extensions/README.md
index e8f1617e9..4c3f9d801 100644
--- a/extensions/README.md
+++ b/extensions/README.md
@@ -76,6 +76,7 @@ The following community-contributed extensions are available in [`catalog.commun
| Cleanup Extension | Post-implementation quality gate that reviews changes, fixes small issues (scout rule), creates tasks for medium issues, and generates analysis for large issues | [spec-kit-cleanup](https://github.com/dsrednicki/spec-kit-cleanup) |
| Fleet Orchestrator | Orchestrate a full feature lifecycle with human-in-the-loop gates across all SpecKit phases | [spec-kit-fleet](https://github.com/sharathsatish/spec-kit-fleet) |
| Jira Integration | Create Jira Epics, Stories, and Issues from spec-kit specifications and task breakdowns with configurable hierarchy and custom field support | [spec-kit-jira](https://github.com/mbachorik/spec-kit-jira) |
+| Project Health Check | Diagnose a Spec Kit project and report health issues across structure, agents, features, scripts, extensions, and git | [spec-kit-doctor](https://github.com/KhawarHabibKhan/spec-kit-doctor) |
| Ralph Loop | Autonomous implementation loop using AI agent CLI | [spec-kit-ralph](https://github.com/Rubiss/spec-kit-ralph) |
| Retrospective Extension | Post-implementation retrospective with spec adherence scoring, drift analysis, and human-gated spec updates | [spec-kit-retrospective](https://github.com/emi-dm/spec-kit-retrospective) |
| Review Extension | Post-implementation comprehensive code review with specialized agents for code quality, comments, tests, error handling, type design, and simplification | [spec-kit-review](https://github.com/ismaelJimenez/spec-kit-review) |
diff --git a/extensions/catalog.community.json b/extensions/catalog.community.json
index 759bd10d8..f1e0a0927 100644
--- a/extensions/catalog.community.json
+++ b/extensions/catalog.community.json
@@ -1,6 +1,6 @@
{
"schema_version": "1.0",
- "updated_at": "2026-03-09T00:00:00Z",
+ "updated_at": "2026-03-13T12:00:00Z",
"catalog_url": "https://raw.githubusercontent.com/github/spec-kit/main/extensions/catalog.community.json",
"extensions": {
"azure-devops": {
@@ -74,6 +74,37 @@
"created_at": "2026-02-22T00:00:00Z",
"updated_at": "2026-02-22T00:00:00Z"
},
+ "doctor": {
+ "name": "Project Health Check",
+ "id": "doctor",
+ "description": "Diagnose a Spec Kit project and report health issues across structure, agents, features, scripts, extensions, and git.",
+ "author": "KhawarHabibKhan",
+ "version": "1.0.0",
+ "download_url": "https://github.com/KhawarHabibKhan/spec-kit-doctor/archive/refs/tags/v1.0.0.zip",
+ "repository": "https://github.com/KhawarHabibKhan/spec-kit-doctor",
+ "homepage": "https://github.com/KhawarHabibKhan/spec-kit-doctor",
+ "documentation": "https://github.com/KhawarHabibKhan/spec-kit-doctor/blob/main/README.md",
+ "changelog": "https://github.com/KhawarHabibKhan/spec-kit-doctor/blob/main/CHANGELOG.md",
+ "license": "MIT",
+ "requires": {
+ "speckit_version": ">=0.1.0"
+ },
+ "provides": {
+ "commands": 1,
+ "hooks": 0
+ },
+ "tags": [
+ "diagnostics",
+ "health-check",
+ "validation",
+ "project-structure"
+ ],
+ "verified": false,
+ "downloads": 0,
+ "stars": 0,
+ "created_at": "2026-03-13T00:00:00Z",
+ "updated_at": "2026-03-13T00:00:00Z"
+ },
"fleet": {
"name": "Fleet Orchestrator",
"id": "fleet",