Superpowers: The First 30 Minutes

Pages

1. Start Here — The Superpowers MethodologyIntroduction to the Superpowers mental model: a transition from ad-hoc coding to a structured, evidence-based development cycle that prioritizes design before implementation.
2. Cross-Harness Installation & AdaptersHow to integrate Superpowers into your preferred environment, including Claude Code, Codex, Gemini, Cursor, and OpenCode, using native plugin mechanisms.
3. Session Bootstrap & Hook SystemUnderstanding the automatic activation layer that triggers skills at the start of every session, ensuring the agent is immediately oriented to the project's methodology.
4. Product Discovery & Socratic DesignThe "Ideas" and "Blueprint" phase: using Socratic questioning to refine rough concepts into clear, digestible specifications before a single line of code is written.
5. Bite-Sized Implementation PlanningThe "Plan" phase: breaking approved designs into 2-5 minute tasks, each with explicit file paths, code changes, and verification steps to ensure predictable progress.
6. Subagent-Driven Execution & ReviewThe "Page Shape" and "QA Review" phase: dispatching specialized subagents to implement tasks with two-stage automated review for spec compliance and code quality.
7. Parallel Development with Git WorktreesMaintaining environment isolation by creating dedicated workspaces for each branch, allowing for seamless context switching and a clean main branch.
8. Evidence-Based Success with TDDEnforcing the RED-GREEN-REFACTOR cycle to ensure every code change is backed by a failing test first, eliminating speculative code and "slop" PRs.
9. Systematic Root Cause AnalysisThe "Root Cause" process: a 4-phase debugging strategy that prioritizes tracing and defensive implementation over ad-hoc guessing and patch-work.
10. Plan-Anchored Code Review & FeedbackThe final "QA Review" step: checking implementation against the original plan and spec, reporting issues by severity, and ensuring a high bar for PR acceptance.
11. The Meta-Layer — Creating Project-Specific SkillsExtending the Superpowers methodology by writing and testing new skills that capture your own project's patterns, constraints, and tribal knowledge.
12. Mastery & Real-World ApplicationApplying Superpowers beyond the first 30 minutes: handling legacy migrations, complex refactors, and maintaining a high-quality codebase at scale.