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

[lihan3238]

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.0.3

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/latest/download/speckit-superpowers-bridge.zip

Version-pinned artifact:

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

The catalog download_url intentionally remains the stable latest-release alias. Since v0.6.0 every release uploads both the versioned ZIP and speckit-superpowers-bridge.zip; future catalog updates should bump only version unless the distribution policy changes.

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.0.3:

• Spec Kit 0.10.2 on Linux bash.
• Spec Kit CLI 0.8.10 on native Windows PowerShell for bridge runtime floor coverage (retained from v1.0.0; ps script flavor byte-identical).
• Superpowers 5.1.0.
• Codex CLI 0.137.0.
• Claude Code 2.1.162.

Required Tools

• PowerShell >=5.1 for the Windows runtime flavor.
• Bash >=4.0 and jq >=1.6 for the Linux/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).

Support Matrix

Target	Result	Evidence
Linux bash	PASS	bash tests/run-all.sh on Spec Kit 0.10.2 plus final-package sandbox install cycle.
Windows PowerShell 5.1+	PASS	tests/test-release-powershell.ps1 plus final-package native PowerShell sandbox install cycle (v1.0.0 evidence retained; ps flavor byte-identical in v1.0.3).
Codex	PASS	Bounded codex exec sandbox verification with codex-cli 0.137.0 (v1.0.0 evidence retained; protocol unchanged).
Claude Code	PASS	Bounded claude -p sandbox verification with Claude Code 2.1.162; v1.0.3 Linux sandbox cycle additionally driven interactively on Spec Kit 0.10.2.

Release Validation Summary

• scripts/release/validate-release-readiness.ps1 -Version 1.0.3 -PackageZip dist/speckit-superpowers-bridge-v1.0.3.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.
• Final v1.0.3 ZIP SHA256 is recorded in the GitHub release notes for both the versioned ZIP and the stable latest alias.

Lightweight Positioning

v1.0.3 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.

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.0.3
• 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 0.10.2.
• Native Windows PowerShell 5.1 with Spec Kit runtime floor coverage through CLI 0.8.10 (v1.0.0 evidence; ps flavor byte-identical in v1.0.3).
• Codex CLI 0.137.0.
• Claude Code 2.1.162.

Test scenarios:

1. Re-bootstrapped the source repo on Spec Kit CLI 0.10.2 and ran the full bash smoke suite (6/6).
2. Round-tripped the updated manifest (category/effect) through the Spec Kit 0.10.2 validator in a scratch project.
3. Installed the v1.0.3 release ZIP into a clean Linux sandbox from the published release URL.
4. Ran bridge-status --readiness.
5. Exercised guard, ready, executing, complete, and auto-archive handoff transitions.
6. Ran package, release-readiness, Linux bash, and Windows PowerShell smoke gates.

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.0.3",
    "download_url": "https://github.com/lihan3238/speckit-superpowers-bridge/releases/latest/download/speckit-superpowers-bridge.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-06-12T00:00:00Z"
  }
}