Superpowers + OpenSpec Skill Library: Enforcing Disciplined AI Development

Problem

When an AI assistant receives a request such as “add a feature”, it often starts coding immediately without clarifying requirements, confirming design, recording specifications, or running tests. This can cause misunderstood requirements, missing boundaries, undocumented changes, and unverified results.

Solution

The Superpowers + OpenSpec Team Skills library provides a set of workflow skills for AI programming assistants. It enforces a disciplined sequence of stages to make the AI slower and steadier.

Workflow stages

Explore requirements

Confirm design

Solidify change with OpenSpec

Write an implementation plan

Develop using Test‑Driven Development (TDD)

Validate the outcome

Available workflows

openspec-superpowers-workflow

Full‑process entry point for complex, important features. Connects Superpowers steps (clarify, design, plan, TDD, verification) with OpenSpec artifacts (proposal, design, spec, tasks), acting as an end‑to‑end “idea‑to‑delivery” controller.

superpowers-openspec-execution-workflow

Three‑stage flow: first explore with Superpowers, then lock the confirmed behavior into an OpenSpec change, finally return to Superpowers for implementation, testing, verification, and archiving. Suitable when initial requirements are vague.

superpowers-feature-workflow

Skips OpenSpec and focuses on engineering discipline: understand context, clarify requirements, draft a solution, create design and plan, implement with TDD, and verify. Useful when formal change records are unnecessary but uncontrolled AI coding is undesirable.

openspec-feature-workflow

Guides the AI to create an OpenSpec change, filling proposal, design, specs, and tasks. Intended for teams that already use OpenSpec but need to generate the documentation first.

Documentation

Each workflow includes an English README (README.md) and a Chinese version (readme_cn.md) that describe purpose, usage scenarios, invocation methods, control points, and expected outputs. Installation documentation lists required components:

Codex‑like runtime that supports skills

OpenSpec CLI

Base Superpowers skills

Team skills from this repository

Copy the desired workflow into the runtime’s skill directory to use it.

Invocation examples

Use $openspec-superpowers-workflow to run this feature from clarification through verification.

Use $superpowers-openspec-execution-workflow for this feature: first explore with Superpowers, then lock the change with OpenSpec, then return to Superpowers for implementation, testing, verification, and archive.

Use $superpowers-feature-workflow to drive the Superpowers stages for this feature request.

Use $openspec-feature-workflow to create and complete the OpenSpec change for this feature.

Repository

https://github.com/SYZ-Coder/superpowers-openspec-team-skills