SuperDuperPowers

OpenCode-first skills and workflow agents for deliberate coding workflows

SuperDuperPowers gives coding agents a practical workflow toolkit: brainstorm when the work is ambiguous, write plans when the scope is real, execute in grouped phases, review at meaningful checkpoints, and verify before claiming success.

This project is built from Jesse Vincent's obra/superpowers baseline platform and substantially modifies the workflow, packaging, and agent model. Jesse Vincent (@obra) and contributors retain their original MIT-licensed attribution.

Included Harness Config

SuperDuperPowers is beta software. The workflow core is intended to stay harness and model agnostic. The first included harness config is for OpenCode, installed by editing your OpenCode opencode.json config manually.

Stable npm package:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["superduperpowers"]
}

See GitHub Releases for release notes and active release history. Published releases are available on npm as superduperpowers.

The bare package name follows npm latest, which reflects the protected latest published-state branch. Use an explicit version such as superduperpowers@YYYY.[M]MDD.N only when you want to pin a specific release tag such as vYYYY.[M]MDD.N.

For fallback, nightly, or feature-source use, power users can install directly from the GitHub main branch. main is the nightly/integration branch; it tracks repository changes before the next restricted promotion to latest and may include bugs:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["superduperpowers@git+https://github.com/notchrisbutler/superduperpowers.git#main"]
}

For local checkout development, use a git+file source:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["superduperpowers@git+file:///absolute/path/to/superduperpowers"]
}

Restart OpenCode after changing plugin config so the package source is reloaded.

Optional workflow defaults can be copied from defaults/superduperpowers.jsonc into one of these project-local files, then edited manually: .opencode/sdp.jsonc, .opencode/superduperpowers.jsonc, sdp.jsonc, or superduperpowers.jsonc.

See OpenCode Install for the included setup and verification prompts.

Features

• Opt-in SuperDuperPowers routing with full flow, quick flow, and no-SuperDuperPowers modes
• Optional JSON/JSONC workflow defaults copied manually from defaults/superduperpowers.jsonc into project-local config files
• OpenCode TUI commands: /sdp, /superduperpowers, /superpowers, /brainstorm, /quick-flow, /write-plan, and /execute-plan
• Project-local generated specs and plans under docs/superduperpowers/, local-only by default unless your workflow explicitly includes them
• Brainstorming, planning, TDD, debugging, verification, and branch-finishing skills
• Frontend design guidance for responsive, accessible, codebase-native UI work that avoids generic AI-looking visual defaults
• Coordinator-owned execution with flat, dependency-ordered dispatch todos that stay readable in agent harnesses
• Named workflow agents as thin OpenCode adapter roles for review, planning, implementation, TDD, debugging, and safe parallelization
• Local-first finishing flow that prepares PR commands without pushing unless explicitly requested
• Included OpenCode plugin entrypoint through .opencode/plugins/superduperpowers.js
• Calendar release versioning in the form YYYY.[M]MDD.N, without leading zeroes in SemVer numeric fields, and GitHub release tags such as vYYYY.[M]MDD.N

Documentation

| Guide | Description | |-------|-------------| | OpenCode Install | Manual OpenCode plugin setup and routing verification prompts | | Workflow Map | Current SDP routes, skill categories, agent roles, and registration constraints | | Wiki | Documentation index | | Testing | Included OpenCode config tests and integration checks | | Publishing | GitHub Releases, latest published-state branch, and npm latest release flow | | GitHub Releases | Release notes and active release history | | Acknowledgements | Baseline platform attribution |

Core Workflow

SuperDuperPowers is opt-in by default for normal coding turns.

• Explicit requests such as using superduperpowers brainstorming, using superpowers brainstorming, /brainstorm, /superduperpowers, or use superpowers executing-plans load the requested workflow.
• Clearly deep and ambiguous, investigation-heavy, high-risk, or plan-heavy requests may still trigger SuperDuperPowers implicitly.
• Small reviews, quick code changes, wording edits, and config tweaks can use quick flow: check enough context, make the smallest correct change, run targeted validation when practical, and report what changed.
• Trivial requests or requests to avoid SuperDuperPowers use normal agent behavior unless SuperDuperPowers is invoked later.
• If intent is unclear, the agent should ask whether to use full flow, quick flow, or no SuperDuperPowers for the session.

Available full-flow workflows include brainstorming, planning, execution, TDD, debugging, verification, spec review, code review, and development-branch completion.

Skills remain the canonical harness-neutral workflow sources. Named workflow agents provide role isolation and OpenCode permissions where available; generic fallback prompts are compatibility paths for harnesses without named-agent support.

Generated SuperDuperPowers specs and plans are local-only by default unless explicit user/repo instructions enable committing approved generated docs. Implementation workflows can still use local commits for verified implementation task scopes and final verified implementation changes. Pushes and PR creation require explicit user instruction.

Execution workflows stop and re-evaluate after repeated failed attempts in the same scope. Small approach corrections can be recorded in the plan/spec and continued; major design, dependency, architecture, data-model, security, or product decisions require user direction or an explicit placeholder seam while independent work continues.

Optional Project Defaults

The packaged defaults live in defaults/superduperpowers.jsonc. To customize workflow defaults, copy that file into .opencode/sdp.jsonc, .opencode/superduperpowers.jsonc, sdp.jsonc, or superduperpowers.jsonc, then edit the copy manually. Agents use explicit prompt and subagent context first, and can read project config directly when a workflow decision depends on it.

skills/using-superpowers/SKILL.md is the source of truth for routing details.

Latest Release Verification

The release workflow updates this block during the version bump. The final npm tarball hashes are published by the registry after publish; verify them with npm instead of trusting a self-referential hash embedded in this packaged README.

• Version: 2026.507.0
• GitHub tag: v2026.507.0
• npm package: [email protected]
• Verify npm integrity: npm view [email protected] dist.integrity dist.shasum

Security

Please review SECURITY.md for supported version policy and responsible disclosure instructions. Do not file public GitHub issues for security bugs.

Contributing

Please read CONTRIBUTING.md before opening issues or pull requests.

License

SuperDuperPowers is available under the MIT License. See LICENSE for the full license text.

Acknowledgements

• Jesse Vincent and obra/superpowers - the MIT-licensed baseline platform this project builds on
• The Superpowers contributors whose work made the baseline platform possible
• The coding-agent harness ecosystems that make portable skills and workflow agents practical

Author

Chris Butler - @notchrisbutler