Skip to content

Add specify doctor command for project health diagnostics#1828

Merged
mnriem merged 9 commits intogithub:mainfrom
KhawarHabibKhan:add-doctor-command
Mar 13, 2026
Merged

Add specify doctor command for project health diagnostics#1828
mnriem merged 9 commits intogithub:mainfrom
KhawarHabibKhan:add-doctor-command

Conversation

@KhawarHabibKhan
Copy link
Contributor

@KhawarHabibKhan KhawarHabibKhan commented Mar 13, 2026

Extension Submission

Extension Name: Project Health Check
Extension ID: doctor
Version: 1.0.0
Author: KhawarHabibKhan
Repository: https://github.com/KhawarHabibKhan/spec-kit-doctor

Closes #1821

Description

A diagnostic extension that scans a Spec Kit project and reports health issues across 6 areas: project structure, AI agent configuration, feature specifications, scripts, extensions, and git status.

Initially submitted as a core CLI command. Based on feedback from contributors suggesting this fits better as an extension, reverted the core approach and rebuilt as a standalone extension following the extension publishing guide.

Checklist

  • Valid extension.yml manifest
  • README.md with installation and usage docs
  • LICENSE file included
  • GitHub release created (v1.0.0)
  • All commands working
  • Added to extensions/catalog.community.json
  • Added to extensions/README.md Available Extensions table
  • Bash and PowerShell script parity

@KhawarHabibKhan KhawarHabibKhan requested a review from mnriem as a code owner March 13, 2026 12:56
@mnriem
Copy link
Collaborator

mnriem commented Mar 13, 2026

@KhawarHabibKhan Can you deliver this as an extension? See https://github.com/github/spec-kit/blob/main/extensions/README.md

@KhawarHabibKhan
Copy link
Contributor Author

@mnriem Thanks for the suggestion! I've reverted the core CLI approach and rebuilt this as a standalone extension instead. The extension repo is at https://github.com/KhawarHabibKhan/spec-kit-doctor and I've updated this PR to add it to the community catalog. Appreciate the guidance!

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds the “Project Health Check” community extension (“doctor”) to Spec Kit’s community extension catalog and lists it in the extensions README for discoverability.

Changes:

  • Bumped extensions/catalog.community.json top-level updated_at and added a new doctor extension entry (v1.0.0).
  • Added “Project Health Check” to extensions/README.md available extensions table.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
extensions/catalog.community.json Adds the doctor extension metadata and updates catalog timestamp.
extensions/README.md Adds the new extension to the community extensions table.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link
Collaborator

@mnriem mnriem left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please address Copilot feedback

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copy link
Contributor Author

@KhawarHabibKhan KhawarHabibKhan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Made changes, please review and approve. thanks

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds the community-listed “doctor” extension (“Project Health Check”) to Spec Kit’s community extension catalog so users can discover and install a project health diagnostics tool via the extension system.

Changes:

  • Bumped extensions/catalog.community.json top-level updated_at and added a new doctor extension entry (v1.0.0) with metadata and download URL.
  • Added “Project Health Check” to the Available Community Extensions table in extensions/README.md.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
extensions/catalog.community.json Adds the doctor extension metadata to the community catalog and updates the catalog timestamp.
extensions/README.md Adds the new extension to the public “Available Community Extensions” table for discoverability.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@mnriem mnriem merged commit b9c1a1c into github:main Mar 13, 2026
8 checks passed
@mnriem
Copy link
Collaborator

mnriem commented Mar 13, 2026

@KhawarHabibKhan Thank you! Great to see another extension :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature]: Add specify doctor command for project health diagnostics

3 participants