How obra/superpowers works
Superpowers is a set of composable software-development skills and harness integrations for coding agents. Its primary workflow turns a user’s request into an agreed design, a stepwise plan, and agent-led implementation with inspection and review. The broader skill library also covers debugging, TDD, code review, verification, and related engineering practices. Platform adapters expose the skills in supported coding-agent harnesses; the sampled sources show OpenCode’s directory entry point and package metadata, but not the internals of most adapters or skills.
Main entry points: subagent-driven-development/SKILL.md Subagent development · brainstorming Brainstorming · server.cjs Companion server · writing-plans/SKILL.md Writing plans
Components 24
Development workflow
- Brainstorming
skills/brainstorming - Writing plans
skills/writing-plans/SKILL.md - Plan execution
skills/executing-plans/SKILL.md - Subagent development
skills/subagent-driven-development/SKILL.md
Engineering practices
- Test-driven development
skills/test-driven-development/SKILL.md - Systematic debugging
skills/systematic-debugging/SKILL.md - Code review
skills/requesting-code-review/SKILL.md - Review response
skills/receiving-code-review/SKILL.md - Completion verification
skills/verification-before-completion/SKILL.md - Branch finishing
skills/finishing-a-development-branch/SKILL.md - Git worktrees
skills/using-git-worktrees/SKILL.md - Parallel agents
skills/dispatching-parallel-agents/SKILL.md
Agent integration
- Skill bootstrap
skills/using-superpowers/SKILL.md - Claude integration
.claude-plugin/plugin.json - OpenCode plugin
.opencode/plugins/superpowers.js - OpenCode entry
index.js - Pi extension
.pi/extensions/superpowers.ts - Hermes integration
.hermes-plugin
Brainstorm companion
- Visual companion
skills/brainstorming/visual-companion.md - Companion server
skills/brainstorming/scripts/server.cjs - Browser helper
skills/brainstorming/scripts/helper.js - Design screens
skills/brainstorming/scripts/frame-template.html
Other components
- Developer
- Coding agent
Connections 26
- Developer → Coding agent: requests work
README.md - Coding agent → Brainstorming: clarifies request
README.md - Brainstorming → Developer: presents design
README.md - Developer → Writing plans: approves design
README.md - Writing plans → Coding agent: guides implementation
README.md - Coding agent → Plan execution: executes plan
README.md - Coding agent → Subagent development: delegates tasks
README.md - Subagent development → Code review: inspects work
README.md - Subagent development → Test-driven development: uses practice
- Coding agent → Systematic debugging: diagnoses faults
- Coding agent → Review response: handles feedback
- Coding agent → Completion verification: checks completion
- Coding agent → Branch finishing: finishes branch
- Coding agent → Git worktrees: isolates work
- Subagent development → Parallel agents: uses agents
- Coding agent → Skill bootstrap: loads skills
README.md - Skill bootstrap → Brainstorming: triggers skill
README.md - OpenCode entry → OpenCode plugin: re-exports
index.js - Coding agent → OpenCode plugin: loads plugin
- Coding agent → Claude integration: loads plugin
- Coding agent → Pi extension: loads extension
- Coding agent → Hermes integration: loads plugin
- Brainstorming → Visual companion: offers companion
- Visual companion → Companion server: starts server
- Companion server → Design screens: frames content
- Companion server → Browser helper: serves helper