How yanyan-se/superpowers works
Superpowers is a skills-based software-development methodology for coding agents, activated through agent-specific plugins, extensions, and hooks. Its principal workflow guides a user from clarifying an idea to an approved design, isolated workspace, implementation plan, task execution, review, and branch completion. The README documents these workflow transitions and the broader skill library; sampled source also shows the brainstorming companion’s browser/server interaction. Most skill implementations and harness adapters were not sampled, so links reflect documented workflow rather than inferred code calls.
Main entry points: executing-plans/SKILL.md Plan execution · subagent-driven-development/SKILL.md Subagent development · server.cjs Companion server · brainstorming/SKILL.md Brainstorming
Components 24
Agent integrations
- Claude integration
.claude-plugin/plugin.json - Codex integration
.codex-plugin/plugin.json - OpenCode plugin
.opencode/plugins/superpowers.js - Pi extension
.pi/extensions/superpowers.ts - Session hooks
hooks - Skill bootstrap
skills/using-superpowers/SKILL.md
Development workflow
- Brainstorming
skills/brainstorming/SKILL.md - Git worktrees
skills/using-git-worktrees/SKILL.md - Writing plans
skills/writing-plans/SKILL.md - Plan execution
skills/executing-plans/SKILL.md - Subagent development
skills/subagent-driven-development/SKILL.md - Parallel agents
skills/dispatching-parallel-agents/SKILL.md - Branch completion
skills/finishing-a-development-branch/SKILL.md
Quality practices
- Test-driven development
skills/test-driven-development/SKILL.md - Code review
skills/requesting-code-review/SKILL.md - Review response
skills/receiving-code-review/SKILL.md - Systematic debugging
skills/systematic-debugging/SKILL.md - Completion verification
skills/verification-before-completion/SKILL.md - Skill authoring
skills/writing-skills/SKILL.md
Brainstorm companion
- Companion server
skills/brainstorming/scripts/server.cjs - Browser helper
skills/brainstorming/scripts/helper.js - Brainstorm screens
skills/brainstorming/scripts
Other components
- Developer
- Coding agent
Connections 26
- Developer → Coding agent: starts task
- Claude integration → Coding agent: provides skills
- Codex integration → Coding agent: provides skills
- OpenCode plugin → Coding agent: provides skills
- Pi extension → Coding agent: provides skills
- Session hooks → Coding agent: bootstraps session
- Coding agent → Skill bootstrap: checks skills
- Skill bootstrap → Brainstorming: activates
- Brainstorming → Git worktrees: after approval
- Brainstorming → Companion server: can launch
- Companion server → Brainstorm screens: serves screens
- Companion server → Browser helper: injects helper
- Browser helper → Companion server: sends choices
- Git worktrees → Writing plans: prepares workspace
- Writing plans → Plan execution: activates
- Writing plans → Subagent development: dispatches
- Subagent development → Parallel agents: can delegate
- Plan execution → Test-driven development: uses
- Subagent development → Test-driven development: uses
- Subagent development → Code review: requests review
- Plan execution → Code review: reviews tasks
- Code review → Review response: returns feedback
- Plan execution → Systematic debugging: can invoke
- Plan execution → Completion verification: verifies result
- Completion verification → Branch completion: completes work
- Coding agent → Skill authoring: can author skills