[Extension]: Update speckit-superpowers-bridge to v1.3.0

Tìm mục speckit-superpowers-bridge hiện có trong catalog tiện ích mở rộng và so sánh mục đó với catalog JSON được đề xuất. Xác minh phiên bản, URL tải xuống bất biến, siêu dữ liệu, số lượng command và hook, cũng như các yêu cầu, sau đó chạy quá trình kiểm tra tính hợp lệ của catalog hoặc các bài kiểm thử liên quan; công việc được xem là hoàn tất khi mục v1.3.0 được chấp nhận mà không có lỗi kiểm tra tính hợp lệ.

Extension Submission: Superpowers Implementation Bridge

Update to existing community catalog entry speckit-superpowers-bridge.

Extension ID

speckit-superpowers-bridge

Extension Name

Superpowers Implementation Bridge

Version

1.3.0

Description

Thin orchestrator between Spec Kit design artifacts and Superpowers implementation discipline. Cross-agent; verified for Codex and Claude Code.

Author

lihan3238

Repository URL

https://github.com/lihan3238/speckit-superpowers-bridge

Download URL

https://github.com/lihan3238/speckit-superpowers-bridge/releases/download/v1.3.0/speckit-superpowers-bridge-v1.3.0.zip

The source repository's marketplace metadata keeps the stable latest-release alias for convenience. The official Spec Kit catalog submission uses this immutable versioned ZIP URL, as required for reproducible catalog installs.

License

MIT

Homepage

https://github.com/lihan3238/speckit-superpowers-bridge

Documentation URL

https://github.com/lihan3238/speckit-superpowers-bridge#readme

Changelog URL

https://github.com/lihan3238/speckit-superpowers-bridge/blob/main/CHANGELOG.md

Required Spec Kit Version

=0.8.10

Verified release baseline for v1.3.0:

• Spec Kit 1.0.12 for repository bootstrap, Linux bash verification, and the v1.3.0 release sandbox; bridge runtime floor remains >=0.8.10.
• Superpowers 6.4.2.
• Codex CLI 0.157.1.
• Claude Code 2.1.283.

Required Tools

• PowerShell >=5.1 for the Windows runtime flavor.
• Bash >=4.0 and jq >=1.6 for the Linux/macOS bash runtime flavor.
• Superpowers skills in the active agent runtime when users want Superpowers implementation discipline.
• Codex or Claude Code integration generated by Spec Kit.

Number of Commands

3

Number of Hooks

5

Tags

bridge, superpowers, cross-agent, tdd, workflow

Key Features

• Keeps Spec Kit as the design source of truth: constitution, spec, clarify, plan, tasks, checklists, and analysis stay Spec Kit-owned.

• Uses Superpowers as the implementation discipline: executing-plans, TDD, systematic debugging, review, verification, and branch finishing stay native Superpowers capabilities.

• Adds a thin handoff/guard layer so the two systems do not duplicate planning or execution ownership.

• Ships both bash and Windows PowerShell script flavors in one ZIP.

• Supports Codex and Claude Code through the same handoff contract.

• New in v1.0.0: release readiness checks for version, catalog id, command namespace, hook namespace, package contents, workflow inventory, platform rows, agent rows, and evidence completeness.

• New in v1.0.0: bridge-status --readiness / bridge-status.ps1 -Readiness read-only install health report covering script flavor, required tools, namespace, package files, bridge state, verified agent metadata, and next action.

• New in v1.0.3: re-verified end-to-end on Spec Kit CLI 0.10.2 (Linux bash); declares the new first-class category: process / effect: read-write manifest fields introduced by Spec Kit 0.10.2, backward compatible with the >=0.8.10 runtime floor.

• New in v1.0.3: bootstrap documentation aligned with Spec Kit 0.10.0 init changes (git extension now opt-in, legacy --ai* flags removed, branch_numbering → feature_numbering).

• New in v1.1.0: verified-against-Superpowers baseline moved 5.1.0 → 6.0.0 (a major upstream bump) with zero bridge runtime change. Superpowers 6.0.0's breaking changes are all internal to upstream skills (subagent-driven-development reviewer-prompt consolidation, worktrees relocating to project .worktrees/, vendor-neutral prose, three new harnesses) and transparent to the thin bridge, which invokes Superpowers by skill name only.

• New in v1.2.0: audited and refreshed repository bootstrap against Spec Kit 0.16.4, including current templates, managed local-state ignore policy, and bundled git/agent-context sources; runtime floor remains >=0.8.10.

• New in v1.2.0: verified-against-Superpowers baseline moved 6.0.0 → 6.3.0 after all six invoked skill names and the Spec Kit tasks.md consumption boundary were re-audited.

• New in v1.2.0: plug-and-play before_implement / after_implement extension-hook dispatch from PR #14, hardened to Spec Kit 0.16.4 semantics. Mandatory hooks emit EXECUTE_COMMAND:, are actually invoked and awaited, and mandatory post-hooks finish before handoff completion; bridge-owned hooks remain skipped.

• New in v1.2.0: fixed Issue #13 by removing GNU-only realpath -m from the bash handoff writer. Portable, symlink-aware missing-path normalization now works on standard macOS without GNU coreutils.

• New in v1.3.0: aligned tracked bootstrap sources and templates with Spec Kit 1.0.12, including current git/agent-context sources, command placeholders, and project gate preservation.

• New in v1.3.0: advanced the verified-against-Superpowers baseline to 6.4.2 and documented inline executing-plans semantics.

• New in v1.3.0: added a stable disposable adapter mapping Spec Kit checkbox tasks to the Task N headings required by Superpowers 6.4.2, while keeping tasks.md as the sole requirements source.

• New in v1.3.0: updated malformed .specify/extensions.yml handling to report parser errors and state that no hooks, including mandatory hooks, were checked.

Support Matrix

Target	Result	Evidence
Linux bash	PASS	bash tests/run-all.sh (9/9) on Spec Kit 1.0.12, source/package validators, and the public-v1.3.0 WSL2 sandbox cycle.
Windows PowerShell 5.1+	PASS	Native tests/test-release-powershell.ps1, readiness validation, and the public-v1.3.0 Windows sibling sandbox cycle (v1-3-0-windows-20260926T111613Z).
macOS bash	PASS	GitHub-hosted native macOS release gate runs the full bash suite and the Issue #13 portability regression; no local public-artifact sandbox claim.
Codex	PASS	v1.3.0 implementation, source verification, and public-artifact cycle with Codex CLI 0.157.1.
Claude Code	PASS	Claude Code 2.1.283 integration/skill contract verification recorded in the v1.3.0 feature evidence; the official Claude marketplace currently serves Superpowers 6.4.1, while the upstream 6.4.2 source audit passes.

Release Validation Summary

• scripts/release/validate-release-readiness.ps1 -Version 1.3.0 -PackageZip dist/speckit-superpowers-bridge-v1.3.0.zip passes.
• scripts/release/test-validate-release-readiness.ps1 passes, including negative fixtures for namespace drift, stale marketplace metadata, missing package flavor, missing agent rows, missing platform rows, and missing workflow evidence.
• bash tests/run-all.sh passes.
• tests/test-release-powershell.ps1 passes under Windows PowerShell.
• The macOS-hosted release gate passes the full bash suite and focused handoff portability regression.
• GitHub release asset API reports both ZIPs at 83,891 bytes with SHA256 2caba4377f003a6229585f1d559de6dedc1d5654e7f2566dcf9b98462c154525; hosted workflow 36237907349 passed all platform gates.

Lightweight Positioning

v1.3.0 remains the same stable protocol release surface as v1.0.0, not a workflow rewrite. The bridge does not introduce a daemon, service, database, custom DSL, independent state machine, or parallel task runner. It borrows useful ideas from Superspec, SuperB, and Comet at the diagnostic/documentation level (readiness checks, evidence rows, namespace validation, truthful demos), but keeps runtime ownership with upstream Spec Kit and Superpowers — and trusts upstream growth: Superpowers 6.4.2 is adapted through disposable task scaffolding, Spec Kit's native runtime events do not replace core-command lifecycle hooks, and v1.3.0 composes Spec Kit's markdown-driven hook mechanism and adds no parallel runner or planner.

AI-Assistance Disclosure

This extension is developed with AI coding assistants. Claude Code and Codex were used for design, planning, implementation, verification, and release-hardening passes. Every release artifact is reviewed by the maintainer before publication.

Testing Checklist

• Extension installs successfully via download URL.
• All commands execute without errors.
• Documentation is complete and accurate.
• No security vulnerabilities identified in the thin bridge package.
• Tested on real projects / end-user sandbox.

Submission Requirements

• Valid extension.yml manifest included.
• README.md with installation and usage instructions included.
• LICENSE file included.
• GitHub release created with version tag: https://github.com/lihan3238/speckit-superpowers-bridge/releases/tag/v1.3.0
• All command files exist and are properly formatted.
• Extension ID follows naming conventions: lowercase with hyphens.

Testing Details

Tested on:

• Linux bash / WSL2 with Spec Kit 1.0.12 and audited Superpowers 6.4.2.
• Native Windows PowerShell 5.1 with the v1.3.0 public release artifact.
• GitHub-hosted native macOS bash for source/runtime portability coverage.
• Codex CLI 0.157.1.
• Claude Code 2.1.283.

Test scenarios:

1. Audited Spec Kit v1.0.12; refreshed tracked templates and bundled extension sources while preserving project-owned gates and bridge skills.
2. Audited Superpowers 6.4.2; confirmed all invoked skill paths and the Task N adapter contract remain present.
3. Ran the full bash smoke suite (9/9), focused hook contract tests, the macOS/BSD path regression, shell syntax checks, and ShellCheck.
4. Installed the public v1.3.0 ZIP in fresh WSL2/Linux and native Windows sibling sandboxes; the installed metadata reported 3 commands and 5 hooks.
5. Ran package and release-readiness validators plus native Windows PowerShell coverage.
6. Required Linux, Windows, and macOS release jobs to pass before publication.
7. Drove complete handoff cycles in both sibling sandboxes; focused hook and adapter contract tests covered the markdown-driven hook behavior.

Example Usage

specify extension add speckit-superpowers-bridge --from https://github.com/lihan3238/speckit-superpowers-bridge/releases/latest/download/speckit-superpowers-bridge.zip

Then use the bridge from the active agent after Spec Kit has generated spec.md, plan.md, and tasks.md:

$speckit-superpowers-bridge

Claude Code users invoke the same bridge contract as:

/speckit-superpowers-bridge

Proposed Catalog Entry

{
  "speckit-superpowers-bridge": {
    "name": "Superpowers Implementation Bridge",
    "id": "speckit-superpowers-bridge",
    "description": "Thin orchestrator between Spec Kit (design) and Superpowers (implementation). Cross-agent.",
    "author": "lihan3238",
    "version": "1.3.0",
    "download_url": "https://github.com/lihan3238/speckit-superpowers-bridge/releases/download/v1.3.0/speckit-superpowers-bridge-v1.3.0.zip",
    "repository": "https://github.com/lihan3238/speckit-superpowers-bridge",
    "homepage": "https://github.com/lihan3238/speckit-superpowers-bridge",
    "documentation": "https://github.com/lihan3238/speckit-superpowers-bridge#readme",
    "changelog": "https://github.com/lihan3238/speckit-superpowers-bridge/blob/main/CHANGELOG.md",
    "license": "MIT",
    "category": "process",
    "effect": "read-write",
    "requires": {
      "speckit_version": ">=0.8.10",
      "tools": [
        {
          "name": "powershell",
          "version": ">=5.1",
          "required": false
        },
        {
          "name": "bash",
          "version": ">=4.0",
          "required": false
        },
        {
          "name": "jq",
          "version": ">=1.6",
          "required": false
        }
      ]
    },
    "provides": {
      "commands": 3,
      "hooks": 5
    },
    "tags": [
      "bridge",
      "superpowers",
      "cross-agent",
      "tdd",
      "workflow"
    ],
    "verified": false,
    "downloads": 0,
    "stars": 0,
    "created_at": "2026-05-15T00:00:00Z",
    "updated_at": "2026-09-26T00:00:00Z"
  }
}