[Extension]: Add Superpowers Implementation Bridge

[lihan3238]

Extension ID

speckit-superpowers-bridge

Extension Name

Superpowers Implementation Bridge

Version

0.1.1

Description

Lightweight protocol that keeps Spec Kit as the source of truth while Superpowers executes implementation tasks.

Author

lihan3238

Repository URL

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

Download URL

https://github.com/lihan3238/speckit-superpowers-bridge/releases/download/v0.1.1/speckit-superpowers-bridge-v0.1.1.zip

SHA256: d0724b044d3eb5bd005f043d1283a94d41bed1d8ae03cd3c12fcfd11bfb1f1be

License

MIT

Homepage (optional)

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

Documentation URL (optional)

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

Changelog URL (optional)

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

Required Spec Kit Version

=0.8.10

Required Tools (optional)

• PowerShell, for bridge guard, handoff, audit, validation, and rollback scripts.
• Superpowers v5.1.0 skills in the agent runtime when users want Superpowers implementation discipline.
• Codex and/or Claude Code integrations are supported; command rendering is handled by Spec Kit integrations.

Number of Commands

7

Number of Hooks (optional)

6

Tags

superpowers, implementation, handoff, bridge

Key Features

• Keeps Spec Kit as the only design source of truth: constitution, spec, plan, tasks, checklists, and analyze remain Spec Kit-owned.
• Uses Superpowers only as the implementation executor: TDD, debugging, execution, review, verification, and development branch finishing.
• Adds a marketplace-compliant execute command: speckit.speckit-superpowers-bridge.execute.
• Prevents overlap with guard rules that block speckit.implement and Superpowers planning skills for active Spec Kit features.
• Tracks handoff state in one JSON file and writes audit events to JSONL.
• Supports rollback snapshots of Spec Kit control artifacts without touching implementation source rollback, which remains a git/worktree responsibility.
• Documents Codex and Claude Code invocation differences while keeping AGENTS.md as the cross-agent protocol.

Testing Checklist

• Extension installs successfully via download URL
• All commands execute without errors
• Documentation is complete and accurate
• No security vulnerabilities identified
• Tested on at least one real project

Submission Requirements

• Valid extension.yml manifest included
• README.md with installation and usage instructions
• LICENSE file included
• GitHub release created with version tag
• All command files exist and are properly formatted
• Extension ID follows naming conventions (lowercase-with-hyphens)

Testing Details

Tested on:

• Windows with Spec Kit 0.8.10
• Superpowers 5.1.0 skill baseline
• Codex integration installed
• Claude Code integration installed for cross-agent parity checks

Release install validation:

specify init . --integration codex --script ps --ignore-agent-tools --no-git --force
specify extension add speckit-superpowers-bridge --from https://github.com/lihan3238/speckit-superpowers-bridge/releases/download/v0.1.1/speckit-superpowers-bridge-v0.1.1.zip --priority 20
specify extension list

Result: Superpowers Implementation Bridge (v0.1.1) installed with 7 commands and 6 hooks.

Local verification run:

• specify --version -> specify 0.8.10
• specify extension list -> bridge v0.1.1, 7 commands, 6 hooks
• specify workflow list -> speckit-superpowers workflow v0.1.1 present
• tests/*.ps1 -> all tests passed
• check-readme-bilingual-parity.ps1 -Json -> passed
• check-distribution-manifest.ps1 -Json -> passed
• parity-check.ps1 -Json -Actor codex -> no findings
• validation-pass.ps1 -Json -Actor codex -> no findings, using a temporary release-validation handoff
• ExtensionManager.install_from_zip(..., "0.8.10") -> passed
• specify extension add ... --from <release URL> in a temp project -> passed

Example Usage

# Install extension
specify extension add speckit-superpowers-bridge --from https://github.com/lihan3238/speckit-superpowers-bridge/releases/download/v0.1.1/speckit-superpowers-bridge-v0.1.1.zip

# Run normal Spec Kit design flow with the chosen agent
# Codex examples:
$speckit-specify
$speckit-plan
$speckit-tasks

# Handoff is created by after_tasks; refresh manually if needed
.\.specify\extensions\speckit-superpowers-bridge\scripts\powershell\update-handoff.ps1 -Status ready -Actor codex

# Execute Spec Kit tasks.md through Superpowers discipline instead of speckit.implement
$speckit-speckit-superpowers-bridge-execute

# Claude Code renders the same command as:
/speckit-speckit-superpowers-bridge-execute

Proposed Catalog Entry

{
  "speckit-superpowers-bridge": {
    "name": "Superpowers Implementation Bridge",
    "id": "speckit-superpowers-bridge",
    "description": "Lightweight protocol that keeps Spec Kit as the source of truth while Superpowers executes implementation tasks.",
    "author": "lihan3238",
    "version": "0.1.1",
    "download_url": "https://github.com/lihan3238/speckit-superpowers-bridge/releases/download/v0.1.1/speckit-superpowers-bridge-v0.1.1.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",
    "requires": {
      "speckit_version": ">=0.8.10"
    },
    "provides": {
      "commands": 7,
      "hooks": 6
    },
    "tags": ["superpowers", "implementation", "handoff", "bridge"],
    "verified": false,
    "downloads": 0,
    "stars": 0,
    "created_at": "2026-05-15T00:00:00Z",
    "updated_at": "2026-05-15T00:00:00Z"
  }
}

Additional Context

There are broader Superpowers bridge ideas in the ecosystem. This extension is intentionally narrower and lighter: it does not replace Spec Kit planning and does not patch the global Superpowers plugin cache. The differentiator is strict responsibility separation plus handoff, guard, audit, and rollback mechanics, so teams can combine Spec Kit and Superpowers without duplicated planning layers or missing execution discipline.

[lihan3238]

Update: v0.3.1 supersedes the original v0.1.1 submission body

Hi @specifications-team / maintainers — this comment replaces the v0.1.1 metadata in the original issue body and supersedes my earlier v0.3.0 update. Please consider the v0.3.1 data below authoritative.

What's in v0.3.1 (vs v0.3.0)

v0.3.0 was the drastic trim (~87% PowerShell line reduction). v0.3.1 is a tooling + alignment patch with no bridge behavior change:

• Added .github/workflows/release.yml — the bridge is now built and published by GitHub Actions on tag push (validate → tests → build → release → upload). v0.3.1 itself was the first release published by this automation.
• Added scripts/release/validate-release-readiness.ps1 + 5-case TDD test suite — pre-flight checks that extension.yml, catalog-entry.json, and CHANGELOG.md are aligned before tagging.
• Fixed 5 cross-reference drifts in command markdowns and the v1 handoff schema (caught by code review on v0.3.0).
• Aligned stale post-v0.3.0 references (workflow.yml, registry files).

No functional change in the bridge itself; v0.3.0 users can upgrade or skip.

Updated catalog entry (replaces the JSON in the original issue body)

"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": "0.3.1",
  "download_url": "https://github.com/lihan3238/speckit-superpowers-bridge/releases/download/v0.3.1/speckit-superpowers-bridge-v0.3.1.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",
  "requires": {
    "speckit_version": ">=0.8.10"
  },
  "provides": {
    "commands": 3,
    "hooks": 5
  },
  "tags": ["bridge", "superpowers", "cross-agent", "governance", "tdd", "workflow"],
  "verified": false,
  "downloads": 0,
  "stars": 0,
  "created_at": "2026-05-15T00:00:00Z",
  "updated_at": "2026-05-15T00:00:00Z"
}

Release asset details

• URL: https://github.com/lihan3238/speckit-superpowers-bridge/releases/download/v0.3.1/speckit-superpowers-bridge-v0.3.1.zip
• Size: 27,331 bytes (~26.7 KB)
• SHA256: c857dcaed552d12e2f2cb7ec6bf9cd6220ad0cbd64040bb1985809389eadf2a3
• Content-Type: application/zip
• State: uploaded (verified via gh api repos/.../releases/tags/v0.3.1)
• ZIP structure: unpacks to speckit-superpowers-bridge-0.3.1/{extension.yml, commands/, scripts/powershell/, README*.md, LICENSE, CHANGELOG.md, .gitignore} — same shape as agent-governance in the catalog. Description is 91 characters (under the publishing-guide soft cap).

Validation (re-run for v0.3.1)

All checks performed by the published .github/workflows/release.yml on tag push:

• ✅ Cross-reference readiness validator (4 checks: extension.yml version, catalog-entry.json version, catalog-entry.json download_url, CHANGELOG section presence)
• ✅ 3/3 bridge smoke tests (test-claude-codex-skill-parity.ps1, test-handoff-shape.ps1, test-guard-hardcoded-rules.ps1)
• ✅ 5/5 release-tooling self-tests (test-validate-release-readiness.ps1)
• ✅ ZIP built and uploaded to GitHub release
• ✅ Workflow run: https://github.com/lihan3238/speckit-superpowers-bridge/actions/runs/25919396619

Compatibility note for existing installs

Users on v0.1.x can upgrade directly to v0.3.1. The new bridge reads existing superpowers-handoff.json tolerantly (v2/v3 fields like autonomous_mode, resume_context, archive_history are ignored, never error). The next handoff write emits the simplified v1 shape. CI / Make files referencing any removed script (parity-check.ps1, validation-pass.ps1, submission-checklist.ps1, recommend-route.ps1, etc.) will need updates; the CHANGELOG.md [0.3.0] and [0.3.1] Compatibility notes enumerate the removed surface.

AI-assistance disclosure

Per the AI-disclosure requirement in Spec Kit CONTRIBUTING.md: this extension was developed with AI coding assistants. Claude Code handled design and planning across six feature increments. Codex handled most of the v0.1.0–v0.2.0 implementation passes. Claude Code implemented the v0.3.0 trim and v0.3.1 release-automation patch end-to-end with Superpowers executing-plans + test-driven-development discipline. Every artifact passed human review before commit.

Thanks for considering — happy to answer any questions or revise.

[lihan3238]

Superseded by clean v0.4.1 submission: #2581.

[lihan3238]

Closing this older exploratory submission to keep maintainer review focused on the clean v0.4.1 issue: #2581.