From ff7b844033e9e0b75713e2e10d4cdb5910bc8a7f Mon Sep 17 00:00:00 2001 From: rbbtsn0w Date: Mon, 30 Mar 2026 20:12:22 +0800 Subject: [PATCH 1/3] docs: correct specify extension add syntax to require extension name The specify extension add command requires the extension name as a positional argument. Many documentation files incorrectly demonstrated using the --from flag without specifying the extension name first. --- .github/ISSUE_TEMPLATE/extension_submission.yml | 4 ++-- extensions/EXTENSION-DEVELOPMENT-GUIDE.md | 2 +- extensions/EXTENSION-PUBLISHING-GUIDE.md | 2 +- extensions/EXTENSION-USER-GUIDE.md | 6 +++--- extensions/README.md | 4 ++-- 5 files changed, 9 insertions(+), 9 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/extension_submission.yml b/.github/ISSUE_TEMPLATE/extension_submission.yml index d298925e74..9d3f15872b 100644 --- a/.github/ISSUE_TEMPLATE/extension_submission.yml +++ b/.github/ISSUE_TEMPLATE/extension_submission.yml @@ -12,7 +12,7 @@ body: - Review the [Extension Publishing Guide](https://github.com/github/spec-kit/blob/main/extensions/EXTENSION-PUBLISHING-GUIDE.md) - Ensure your extension has a valid `extension.yml` manifest - Create a GitHub release with a version tag (e.g., v1.0.0) - - Test installation: `specify extension add --from ` + - Test installation: `specify extension add --from ` - type: input id: extension-id @@ -229,7 +229,7 @@ body: placeholder: | ```bash # Install extension - specify extension add --from https://github.com/your-org/spec-kit-your-extension/archive/refs/tags/v1.0.0.zip + specify extension add --from https://github.com/your-org/spec-kit-your-extension/archive/refs/tags/v1.0.0.zip # Use a command /speckit.your-extension.command-name arg1 arg2 diff --git a/extensions/EXTENSION-DEVELOPMENT-GUIDE.md b/extensions/EXTENSION-DEVELOPMENT-GUIDE.md index 81179a073b..4eb7626d8f 100644 --- a/extensions/EXTENSION-DEVELOPMENT-GUIDE.md +++ b/extensions/EXTENSION-DEVELOPMENT-GUIDE.md @@ -514,7 +514,7 @@ zip -r spec-kit-my-ext-1.0.0.zip extension.yml commands/ scripts/ docs/ Users install with: ```bash -specify extension add --from https://github.com/.../spec-kit-my-ext-1.0.0.zip +specify extension add --from https://github.com/.../spec-kit-my-ext-1.0.0.zip ``` ### Option 3: Community Reference Catalog diff --git a/extensions/EXTENSION-PUBLISHING-GUIDE.md b/extensions/EXTENSION-PUBLISHING-GUIDE.md index 25801ca176..1433738743 100644 --- a/extensions/EXTENSION-PUBLISHING-GUIDE.md +++ b/extensions/EXTENSION-PUBLISHING-GUIDE.md @@ -122,7 +122,7 @@ Test that users can install from your release: specify extension add --dev /path/to/your-extension # Test from GitHub archive -specify extension add --from https://github.com/your-org/spec-kit-your-extension/archive/refs/tags/v1.0.0.zip +specify extension add --from https://github.com/your-org/spec-kit-your-extension/archive/refs/tags/v1.0.0.zip ``` --- diff --git a/extensions/EXTENSION-USER-GUIDE.md b/extensions/EXTENSION-USER-GUIDE.md index e136de6048..190e263af2 100644 --- a/extensions/EXTENSION-USER-GUIDE.md +++ b/extensions/EXTENSION-USER-GUIDE.md @@ -160,7 +160,7 @@ This will: ```bash # From GitHub release -specify extension add --from https://github.com/org/spec-kit-ext/archive/refs/tags/v1.0.0.zip +specify extension add --from https://github.com/org/spec-kit-ext/archive/refs/tags/v1.0.0.zip ``` ### Install from Local Directory (Development) @@ -737,7 +737,7 @@ You can still install extensions not in your catalog using `--from`: specify extension add jira # Direct URL (bypasses catalog) -specify extension add --from https://github.com/someone/spec-kit-ext/archive/v1.0.0.zip +specify extension add --from https://github.com/someone/spec-kit-ext/archive/v1.0.0.zip # Local development specify extension add --dev /path/to/extension @@ -807,7 +807,7 @@ specify extension add --dev /path/to/extension 2. Install older version of extension: ```bash - specify extension add --from https://github.com/org/ext/archive/v1.0.0.zip + specify extension add --from https://github.com/org/ext/archive/v1.0.0.zip ``` ### MCP Tool Not Available diff --git a/extensions/README.md b/extensions/README.md index eb8c3c782f..a8eedf7ce8 100644 --- a/extensions/README.md +++ b/extensions/README.md @@ -59,7 +59,7 @@ Populate your `catalog.json` with approved extensions: Skip catalog curation - team members install directly using URLs: ```bash -specify extension add --from https://github.com/org/spec-kit-ext/archive/refs/tags/v1.0.0.zip +specify extension add --from https://github.com/org/spec-kit-ext/archive/refs/tags/v1.0.0.zip ``` **Benefits**: Quick for one-off testing or private extensions @@ -108,7 +108,7 @@ specify extension search # See what's in your catalog specify extension add # Install by name # Direct from URL (bypasses catalog) -specify extension add --from https://github.com///archive/refs/tags/.zip +specify extension add --from https://github.com///archive/refs/tags/.zip # List installed extensions specify extension list From 97c6dd25234e83360947d9605b464998b8581dd4 Mon Sep 17 00:00:00 2001 From: rbbtsn0w Date: Mon, 30 Mar 2026 20:12:32 +0800 Subject: [PATCH 2/3] feat: add superb extension to community catalog Orchestrates obra/superpowers skills within the spec-kit SDD workflow. --- README.md | 1 + extensions/catalog.community.json | 61 ++++++++++++++++++++++++++----- 2 files changed, 53 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 66eb57af8c..b6c915a19f 100644 --- a/README.md +++ b/README.md @@ -207,6 +207,7 @@ The following community-contributed extensions are available in [`catalog.commun | Retrospective Extension | Post-implementation retrospective with spec adherence scoring, drift analysis, and human-gated spec updates | `docs` | Read+Write | [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 | `code` | Read-only | [spec-kit-review](https://github.com/ismaelJimenez/spec-kit-review) | | SDD Utilities | Resume interrupted workflows, validate project health, and verify spec-to-task traceability | `process` | Read+Write | [speckit-utils](https://github.com/mvanhorn/speckit-utils) | +| Superpowers Bridge | Orchestrates obra/superpowers skills within the spec-kit SDD workflow across the full lifecycle (clarification, TDD, review, verification, critique, debugging, branch completion) | `process` | Read+Write | [superpowers-bridge](https://github.com/RbBtSn0w/spec-kit-extensions) | | Spec Sync | Detect and resolve drift between specs and implementation. AI-assisted resolution with human approval | `docs` | Read+Write | [spec-kit-sync](https://github.com/bgervin/spec-kit-sync) | | Understanding | Automated requirements quality analysis — 31 deterministic metrics against IEEE/ISO standards with experimental energy-based ambiguity detection | `docs` | Read-only | [understanding](https://github.com/Testimonial/understanding) | | V-Model Extension Pack | Enforces V-Model paired generation of development specs and test specs with full traceability | `docs` | Read+Write | [spec-kit-v-model](https://github.com/leocamello/spec-kit-v-model) | diff --git a/extensions/catalog.community.json b/extensions/catalog.community.json index 8d105eb849..087fa91ad1 100644 --- a/extensions/catalog.community.json +++ b/extensions/catalog.community.json @@ -1,12 +1,12 @@ { "schema_version": "1.0", - "updated_at": "2026-03-27T08:22:30Z", + "updated_at": "2026-03-30T00:00:00Z", "catalog_url": "https://raw.githubusercontent.com/github/spec-kit/main/extensions/catalog.community.json", "extensions": { "aide": { "name": "AI-Driven Engineering (AIDE)", "id": "aide", - "description": "A structured 7-step workflow for building new projects from scratch with AI assistants \u2014 from vision through implementation.", + "description": "A structured 7-step workflow for building new projects from scratch with AI assistants — from vision through implementation.", "author": "mnriem", "version": "1.0.0", "download_url": "https://github.com/mnriem/spec-kit-extensions/releases/download/aide-v1.0.0/aide.zip", @@ -170,7 +170,7 @@ "cognitive-squad": { "name": "Cognitive Squad", "id": "cognitive-squad", - "description": "Multi-agent cognitive system with Triadic Model: understanding, internalization, application \u2014 with quality gates, backpropagation verification, and self-healing", + "description": "Multi-agent cognitive system with Triadic Model: understanding, internalization, application — with quality gates, backpropagation verification, and self-healing", "author": "Testimonial", "version": "0.1.0", "download_url": "https://github.com/Testimonial/cognitive-squad/archive/refs/tags/v0.1.0.zip", @@ -242,7 +242,7 @@ "updated_at": "2026-03-19T12:08:20Z" }, "docguard": { - "name": "DocGuard \u2014 CDD Enforcement", + "name": "DocGuard — CDD Enforcement", "id": "docguard", "description": "Canonical-Driven Development enforcement. Validates, scores, and traces project documentation with automated checks, AI-driven workflows, and spec-kit hooks. Zero NPM runtime dependencies.", "author": "raccioly", @@ -379,7 +379,7 @@ "iterate": { "name": "Iterate", "id": "iterate", - "description": "Iterate on spec documents with a two-phase define-and-apply workflow \u2014 refine specs mid-implementation and go straight back to building", + "description": "Iterate on spec documents with a two-phase define-and-apply workflow — refine specs mid-implementation and go straight back to building", "author": "Vianca Martinez", "version": "2.0.0", "download_url": "https://github.com/imviancagrace/spec-kit-iterate/archive/refs/tags/v2.0.0.zip", @@ -469,9 +469,9 @@ "updated_at": "2026-03-17T00:00:00Z" }, "maqa": { - "name": "MAQA \u2014 Multi-Agent & Quality Assurance", + "name": "MAQA — Multi-Agent & Quality Assurance", "id": "maqa", - "description": "Coordinator \u2192 feature \u2192 QA agent workflow with parallel worktree-based implementation. Language-agnostic. Auto-detects installed board plugins (Trello, Linear, GitHub Projects, Jira, Azure DevOps). Optional CI gate.", + "description": "Coordinator → feature → QA agent workflow with parallel worktree-based implementation. Language-agnostic. Auto-detects installed board plugins (Trello, Linear, GitHub Projects, Jira, Azure DevOps). Optional CI gate.", "author": "GenieRobot", "version": "0.1.3", "download_url": "https://github.com/GenieRobot/spec-kit-maqa-ext/releases/download/maqa-v0.1.3/maqa.zip", @@ -962,7 +962,7 @@ "status": { "name": "Project Status", "id": "status", - "description": "Show current SDD workflow progress \u2014 active feature, artifact status, task completion, workflow phase, and extensions summary.", + "description": "Show current SDD workflow progress — active feature, artifact status, task completion, workflow phase, and extensions summary.", "author": "KhawarHabibKhan", "version": "1.0.0", "download_url": "https://github.com/KhawarHabibKhan/spec-kit-status/archive/refs/tags/v1.0.0.zip", @@ -991,6 +991,49 @@ "created_at": "2026-03-16T00:00:00Z", "updated_at": "2026-03-16T00:00:00Z" }, + "superb": { + "name": "Superpowers Bridge", + "id": "superb", + "description": "Orchestrates obra/superpowers skills within the spec-kit SDD workflow. Thin bridge commands delegate to superpowers' authoritative SKILL.md files at runtime (with graceful fallback), while bridge-original commands provide spec-kit-native value. Eight commands cover the full lifecycle: intent clarification, TDD enforcement, task review, verification, critique, systematic debugging, branch completion, and review response. Hook-bound commands fire automatically; standalone commands are invoked when needed.", + "author": "rbbtsn0w", + "version": "1.0.0", + "download_url": "https://github.com/RbBtSn0w/spec-kit-extensions/releases/download/superpowers-bridge-v1.0.0/superpowers-bridge.zip", + "repository": "https://github.com/RbBtSn0w/spec-kit-extensions", + "homepage": "https://github.com/RbBtSn0w/spec-kit-extensions", + "documentation": "https://github.com/RbBtSn0w/spec-kit-extensions/blob/main/superpowers-bridge/README.md", + "changelog": "https://github.com/RbBtSn0w/spec-kit-extensions/blob/main/superpowers-bridge/CHANGELOG.md", + "license": "MIT", + "requires": { + "speckit_version": ">=0.4.3", + "tools": [ + { + "name": "superpowers", + "version": ">=5.0.0", + "required": false + } + ] + }, + "provides": { + "commands": 8, + "hooks": 4 + }, + "tags": [ + "methodology", + "tdd", + "code-review", + "workflow", + "superpowers", + "brainstorming", + "verification", + "debugging", + "branch-management" + ], + "verified": false, + "downloads": 0, + "stars": 0, + "created_at": "2026-03-30T00:00:00Z", + "updated_at": "2026-03-30T00:00:00Z" + }, "sync": { "name": "Spec Sync", "id": "sync", @@ -1026,7 +1069,7 @@ "understanding": { "name": "Understanding", "id": "understanding", - "description": "Automated requirements quality analysis \u2014 validates specs against IEEE/ISO standards using 31 deterministic metrics. Catches ambiguity, missing testability, and structural issues before they reach implementation. Includes experimental energy-based ambiguity detection using local LM token perplexity.", + "description": "Automated requirements quality analysis — validates specs against IEEE/ISO standards using 31 deterministic metrics. Catches ambiguity, missing testability, and structural issues before they reach implementation. Includes experimental energy-based ambiguity detection using local LM token perplexity.", "author": "Ladislav Bihari", "version": "3.4.0", "download_url": "https://github.com/Testimonial/understanding/archive/refs/tags/v3.4.0.zip", From e9d3eebbe82ae55826a8b65681ef94af93727b07 Mon Sep 17 00:00:00 2001 From: rbbtsn0w Date: Mon, 30 Mar 2026 21:58:58 +0800 Subject: [PATCH 3/3] fix: link superb extension docs --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index b6c915a19f..8e1214e362 100644 --- a/README.md +++ b/README.md @@ -207,7 +207,7 @@ The following community-contributed extensions are available in [`catalog.commun | Retrospective Extension | Post-implementation retrospective with spec adherence scoring, drift analysis, and human-gated spec updates | `docs` | Read+Write | [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 | `code` | Read-only | [spec-kit-review](https://github.com/ismaelJimenez/spec-kit-review) | | SDD Utilities | Resume interrupted workflows, validate project health, and verify spec-to-task traceability | `process` | Read+Write | [speckit-utils](https://github.com/mvanhorn/speckit-utils) | -| Superpowers Bridge | Orchestrates obra/superpowers skills within the spec-kit SDD workflow across the full lifecycle (clarification, TDD, review, verification, critique, debugging, branch completion) | `process` | Read+Write | [superpowers-bridge](https://github.com/RbBtSn0w/spec-kit-extensions) | +| Superpowers Bridge | Orchestrates obra/superpowers skills within the spec-kit SDD workflow across the full lifecycle (clarification, TDD, review, verification, critique, debugging, branch completion) | `process` | Read+Write | [superpowers-bridge](https://github.com/RbBtSn0w/spec-kit-extensions/tree/main/superpowers-bridge) | | Spec Sync | Detect and resolve drift between specs and implementation. AI-assisted resolution with human approval | `docs` | Read+Write | [spec-kit-sync](https://github.com/bgervin/spec-kit-sync) | | Understanding | Automated requirements quality analysis — 31 deterministic metrics against IEEE/ISO standards with experimental energy-based ambiguity detection | `docs` | Read-only | [understanding](https://github.com/Testimonial/understanding) | | V-Model Extension Pack | Enforces V-Model paired generation of development specs and test specs with full traceability | `docs` | Read+Write | [spec-kit-v-model](https://github.com/leocamello/spec-kit-v-model) |