superpowers-skills

Skills wiki intro - mandatory workflows, search tool, brainstorming triggers

Force unrelated concepts together to discover emergent properties - "What if we treated X like Y?"

Interactive idea refinement using Socratic method to develop fully-formed designs

Write the test first, watch it fail, write minimal code to pass

Four-phase debugging framework that ensures root cause investigation before attempting fixes. Never jump to solutions.

Systematically trace bugs backward through call stack to find original trigger

Run verification commands and confirm output before claiming success

Create detailed implementation plans with bite-sized tasks for engineers with zero codebase context

Never test mock behavior. Never add test-only methods to production classes. Understand dependencies before mocking.

Execute implementation plan by dispatching fresh subagent for each task, with code review between tasks

Execute detailed plans in batches with review checkpoints

Dispatch to the right problem-solving technique based on how you're stuck

Receive and act on code review feedback with technical rigor, not performative agreement or blind implementation

RED-GREEN-REFACTOR for process documentation - baseline without skill, write addressing failures, iterate closing loopholes

Dispatch code-reviewer subagent to review implementation against plan or requirements before proceeding

Find one insight that eliminates multiple components - "if this is true, we don't need X, Y, or Z"

Create isolated git worktrees with smart directory selection and safety verification

Flip core assumptions to reveal hidden constraints and alternative approaches - "what if the opposite were true?"

Understand how ideas evolved over time to find old solutions for new problems and avoid repeating past failures

Spot patterns appearing in 3+ domains to find universal principles

Validate at every layer data passes through to make bugs impossible

Use multiple Claude agents to investigate and fix independent problems concurrently

Complete feature development with structured options for merge, PR, or cleanup

Search previous Claude Code conversations for facts, patterns, decisions, and context using semantic or text search

TDD for process documentation - test with subagents before writing, iterate until bulletproof

Test at extremes (1000x bigger/smaller, instant/year-long) to expose fundamental truths hidden at normal scales

Replace arbitrary timeouts with condition polling for reliable async tests

Recognize when disagreements reveal valuable context, preserve multiple valid approaches instead of forcing premature resolution

Contribute skills back to upstream via branch and PR

Maintain skills wiki health - check links, naming, cross-references, and coverage

Sync local skills repository with upstream changes from obra/superpowers-skills