Skip to content

Add Spec Diagram community extension to catalog and README#2129

Merged
mnriem merged 1 commit intogithub:mainfrom
Quratulain-bilal:feat/diagram-extension
Apr 8, 2026
Merged

Add Spec Diagram community extension to catalog and README#2129
mnriem merged 1 commit intogithub:mainfrom
Quratulain-bilal:feat/diagram-extension

Conversation

@Quratulain-bilal
Copy link
Copy Markdown
Contributor

Summary

  • Adds diagram entry to extensions/catalog.community.json (alphabetically between confluence and
    docguard)
  • Adds Spec Diagram row to README.md Community Extensions table (alphabetically between Spec Critique Extension and Spec Refine)

Extension Details

Field Value
ID diagram
Name Spec Diagram
Commands 3 (workflow, status, dependencies)
Hooks 1 (after_tasks)
Category visibility
Effect Read-only
Requires spec-kit >= 0.4.0
Repository https://github.com/Quratulain-bilal/spec-kit-diagram-

What It Does

Auto-generates Mermaid diagrams for SDD visualization — addresses issue #467 (50+ upvotes), the
highest-upvoted open issue with no existing extension:

  • /speckit.diagram.workflow — Mermaid flowchart of the full SDD lifecycle with phase status coloring
  • /speckit.diagram.status — Gantt chart showing all features' progress across SDD phases
  • /speckit.diagram.dependencies — DAG of task dependencies with execution waves and critical path

All output renders natively on GitHub, GitLab, and VS Code — no external tools needed.

Checklist

  • Entry added to extensions/catalog.community.json in alphabetical order by ID
  • Row added to README.md Community Extensions table in alphabetical order by name
  • JSON validates successfully
  • Extension repo has valid extension.yml, all command files, README, CHANGELOG, and LICENSE
  • verified: false, downloads: 0, stars: 0 set for new submission
  • Only 2 files modified (catalog + README)

Closes #467

Adds the spec-kit-diagram extension (3 commands, 1 hook) that auto-generates
Mermaid diagrams for SDD workflow visualization, feature progress tracking,
and task dependency graphs.

Addresses community request in issue github#467 (50+ upvotes).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Copy link
Copy Markdown
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 new community extension Spec Diagram to Spec Kit’s discovery surfaces (community catalog + README list), so users can find the extension via the standard extension browsing workflow.

Changes:

  • Added a new diagram entry to extensions/catalog.community.json with metadata, URLs, and capability counts.
  • Added a corresponding “Spec Diagram” row to the README Community Extensions table.
Show a summary per file
File Description
README.md Adds “Spec Diagram” to the Community Extensions table with a short description, category, effect, and repo link.
extensions/catalog.community.json Registers the diagram extension in the community catalog with download/repo/docs URLs, requirements, and tags.

Copilot's findings

Tip

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

  • Files reviewed: 2/2 changed files
  • Comments generated: 0

@Quratulain-bilal
Copy link
Copy Markdown
Contributor Author

Hi @mnriem 👋 This completes a trio of high-demand community extensions I've been working on — Spec Refine (#1191, 101+ upvotes), Branch Convention (#407, 39+ upvotes), and now Spec Diagram (#467, 50+ upvotes).
All three address the top most-requested features with zero catalog overlap. Would love your review when
you get a chance!

@mnriem
Copy link
Copy Markdown
Collaborator

mnriem commented Apr 8, 2026

Thank you! For now lets see how many stars you get. Note I am trying not to add too many things to the core flow as some perceive it already as heavy weight. We are probably going to introduce some other flows alongside the original Spec Kit flow to address some of the most requested issues. We opted for this extension mechanism so folks would have the ability to opt into the extensions they love the most. Thanks again for the great work!

@mnriem mnriem merged commit 8472e44 into github:main Apr 8, 2026
12 checks passed
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.

SpecKit - Workflow Diagram *Feedback Please*

3 participants