superpowers — A behavioral framework for coding agents
Project Overview
When I first encountered Superpowers, I was skeptical — another prompt collection masquerading as a methodology? But digging into obra/superpowers reveals something more deliberate. This isn’t a script or a library; it’s a behavioral framework for coding agents, implemented as composable skills that trigger automatically based on context. The project has accumulated over 181,000 stars[1] primarily because it addresses a fundamental pain point: LLM-based coding agents are brilliant at generating code but terrible at planning, testing, and maintaining discipline. Superpowers doesn’t add new capabilities to agents — it constrains them. The core insight is that the most powerful thing you can give an agent isn’t more tools, but better judgment about when to use them. The architecture is notable for being harness-agnostic: it works across Claude Code, Codex CLI, Gemini CLI, Cursor, and others, which is a pragmatic bet that the agent ecosystem will remain fragmented rather than consolidating around a single platform.
What It’s For
Superpowers is for anyone who’s watched an AI coding agent burn through API credits building the wrong thing. It’s a methodology that forces agents to step through a disciplined workflow: brainstorm first, design second, plan third, execute fourth. The target user is a developer who wants to delegate meaningful work to an agent but has been burned by agents that jump straight to implementation without understanding context. Where tools like GitHub Copilot focus on inline completions and Cursor offers context-aware chat, Superpowers operates at a higher level of abstraction — it’s about orchestrating the entire development lifecycle. The tradeoff is that this approach works best for well-defined features or bug fixes. For exploratory programming or rapid prototyping, the structured workflow can feel bureaucratic. The project explicitly acknowledges this tension by making the skills composable; you can opt out of parts of the workflow if they don’t fit your use case.
How to Use It
The installation varies by harness, but the workflow is consistent regardless of which agent you use. After installation, the agent automatically detects when it needs to follow the Superpowers methodology. The critical design decision is that skills trigger based on context, not explicit commands — the agent recognizes it’s in a brainstorming phase versus an execution phase and adapts its behavior accordingly. The workflow progresses through brainstorming, design validation, implementation planning, and subagent-driven development. Each phase has guardrails: the brainstorming phase forces the agent to present designs in digestible chunks rather than dumping everything at once, and the planning phase breaks work into tasks so small (2-5 minutes each) that even an inexperienced developer could follow them. The subagent-driven development phase is where the methodology really earns its name — it spawns child agents to work through tasks independently while the parent agent reviews and coordinates.
Installs Superpowers for Claude Code via the official Anthropic plugin marketplace
/plugin install superpowers@claude-plugins-officialInstalls Superpowers for Factory Droid after registering the plugin marketplace
droid plugin install superpowers@superpowersInstalls Superpowers as a Gemini CLI extension
gemini extensions install https://github.com/obra/superpowersRecent Updates
Latest Release: v5.1.0 (2024-11-01)
Latest stable release with improved subagent orchestration and expanded harness support
The project has seen rapid iteration with five releases in the v5.x series, suggesting active development and community feedback driving changes. The star count has grown substantially as more developers experiment with agent-based development workflows. The trajectory suggests Superpowers is evolving from a personal methodology into a community standard for agent-based development.
Sources & Attributions
[1] 181,196 stars as of the latest data — obra/superpowers [2] v5.1.0 is the latest release in the v5.x series — obra/superpowers