# Superpowers: The First 30 Minutes

> A complete software development methodology for AI agents, built on composable skills and automatic workflows that enforce TDD, systematic debugging, and subagent orchestration.

This is a Grok-Wiki source-grounded repository wiki. Use the complete Markdown link when an agent needs the full repo context.

## Context Links

- [Complete Markdown wiki](https://grok-wiki.com/public/wiki/obra-superpowers-8ae12eb67e85/llms-full.txt)
- [Complete Markdown alias](https://grok-wiki.com/public/wiki/obra-superpowers-8ae12eb67e85.md)
- [Human interactive wiki](https://grok-wiki.com/public/wiki/obra-superpowers-8ae12eb67e85)
- [GitHub repository](https://github.com/obra/superpowers)

## Repository

- Repository: obra/superpowers

- Generated: 2026-05-20T00:29:51.615Z
- Updated: 2026-05-21T21:35:33.337Z
- Runtime: Antigravity CLI
- Format: First 30 Minutes
- Pages: 12

## Pages

- [Start Here — The Superpowers Methodology](https://grok-wiki.com/public/wiki/obra-superpowers-8ae12eb67e85/pages/01-start-here-the-superpowers-methodology.md): Introduction to the Superpowers mental model: a transition from ad-hoc coding to a structured, evidence-based development cycle that prioritizes design before implementation.
- [Cross-Harness Installation & Adapters](https://grok-wiki.com/public/wiki/obra-superpowers-8ae12eb67e85/pages/02-cross-harness-installation-adapters.md): How to integrate Superpowers into your preferred environment, including Claude Code, Codex, Gemini, Cursor, and OpenCode, using native plugin mechanisms.
- [Session Bootstrap & Hook System](https://grok-wiki.com/public/wiki/obra-superpowers-8ae12eb67e85/pages/03-session-bootstrap-hook-system.md): Understanding the automatic activation layer that triggers skills at the start of every session, ensuring the agent is immediately oriented to the project's methodology.
- [Product Discovery & Socratic Design](https://grok-wiki.com/public/wiki/obra-superpowers-8ae12eb67e85/pages/04-product-discovery-socratic-design.md): The "Ideas" and "Blueprint" phase: using Socratic questioning to refine rough concepts into clear, digestible specifications before a single line of code is written.
- [Bite-Sized Implementation Planning](https://grok-wiki.com/public/wiki/obra-superpowers-8ae12eb67e85/pages/05-bite-sized-implementation-planning.md): The "Plan" phase: breaking approved designs into 2-5 minute tasks, each with explicit file paths, code changes, and verification steps to ensure predictable progress.
- [Subagent-Driven Execution & Review](https://grok-wiki.com/public/wiki/obra-superpowers-8ae12eb67e85/pages/06-subagent-driven-execution-review.md): The "Page Shape" and "QA Review" phase: dispatching specialized subagents to implement tasks with two-stage automated review for spec compliance and code quality.
- [Parallel Development with Git Worktrees](https://grok-wiki.com/public/wiki/obra-superpowers-8ae12eb67e85/pages/07-parallel-development-with-git-worktrees.md): Maintaining environment isolation by creating dedicated workspaces for each branch, allowing for seamless context switching and a clean main branch.
- [Evidence-Based Success with TDD](https://grok-wiki.com/public/wiki/obra-superpowers-8ae12eb67e85/pages/08-evidence-based-success-with-tdd.md): Enforcing the RED-GREEN-REFACTOR cycle to ensure every code change is backed by a failing test first, eliminating speculative code and "slop" PRs.
- [Systematic Root Cause Analysis](https://grok-wiki.com/public/wiki/obra-superpowers-8ae12eb67e85/pages/09-systematic-root-cause-analysis.md): The "Root Cause" process: a 4-phase debugging strategy that prioritizes tracing and defensive implementation over ad-hoc guessing and patch-work.
- [Plan-Anchored Code Review & Feedback](https://grok-wiki.com/public/wiki/obra-superpowers-8ae12eb67e85/pages/10-plan-anchored-code-review-feedback.md): The final "QA Review" step: checking implementation against the original plan and spec, reporting issues by severity, and ensuring a high bar for PR acceptance.
- [The Meta-Layer — Creating Project-Specific Skills](https://grok-wiki.com/public/wiki/obra-superpowers-8ae12eb67e85/pages/11-the-meta-layer-creating-project-specific-skills.md): Extending the Superpowers methodology by writing and testing new skills that capture your own project's patterns, constraints, and tribal knowledge.
- [Mastery & Real-World Application](https://grok-wiki.com/public/wiki/obra-superpowers-8ae12eb67e85/pages/12-mastery-real-world-application.md): Applying Superpowers beyond the first 30 minutes: handling legacy migrations, complex refactors, and maintaining a high-quality codebase at scale.

## Source Files

- `.claude-plugin/plugin.json`
- `.codex-plugin/plugin.json`
- `.cursor-plugin/plugin.json`
- `AGENTS.md`
- `CLAUDE.md`
- `CODE_OF_CONDUCT.md`
- `gemini-extension.json`
- `GEMINI.md`
- `hooks/hooks-cursor.json`
- `hooks/hooks.json`
- `hooks/run-hook.cmd`
- `hooks/session-start`
- `README.md`
- `RELEASE-NOTES.md`
- `skills/brainstorming/scripts/helper.js`
- `skills/brainstorming/SKILL.md`
- `skills/brainstorming/spec-document-reviewer-prompt.md`
- `skills/brainstorming/visual-companion.md`
- `skills/dispatching-parallel-agents/SKILL.md`
- `skills/executing-plans/SKILL.md`
- `skills/finishing-a-development-branch/SKILL.md`
- `skills/receiving-code-review/SKILL.md`
- `skills/requesting-code-review/code-reviewer.md`
- `skills/requesting-code-review/SKILL.md`
- `skills/subagent-driven-development/code-quality-reviewer-prompt.md`
- `skills/subagent-driven-development/implementer-prompt.md`
- `skills/subagent-driven-development/SKILL.md`
- `skills/subagent-driven-development/spec-reviewer-prompt.md`
- `skills/systematic-debugging/condition-based-waiting.md`
- `skills/systematic-debugging/defense-in-depth.md`
- `skills/systematic-debugging/root-cause-tracing.md`
- `skills/systematic-debugging/SKILL.md`
- `skills/test-driven-development/SKILL.md`
- `skills/test-driven-development/testing-anti-patterns.md`
- `skills/using-git-worktrees/SKILL.md`
- `skills/using-superpowers/SKILL.md`
- `skills/verification-before-completion/SKILL.md`
- `skills/writing-plans/plan-document-reviewer-prompt.md`
- `skills/writing-plans/SKILL.md`
- `skills/writing-skills/anthropic-best-practices.md`
- `skills/writing-skills/persuasion-principles.md`
- `skills/writing-skills/SKILL.md`
- `skills/writing-skills/testing-skills-with-subagents.md`