---
name: superpowers
description: Core software engineering skills — TDD patterns, systematic debugging, collaborative workflows, and proven development techniques. Based on the most popular Gemini CLI extension (113K+ installs).
---

# Superpowers — Engineering Best Practices

## Test-Driven Development
- Write the test FIRST, always
- One assertion per test when possible
- Test behavior, not implementation
- Name tests descriptively: "should return error when user not found"

## Systematic Debugging
1. Reproduce the issue consistently
2. Isolate: binary search through the call stack
3. Form a hypothesis before changing code
4. Verify the fix doesn't break other tests
5. Add a regression test

## Code Review Patterns
- Review in small chunks (< 400 lines)
- Check: correctness, clarity, completeness, consistency
- Ask "what happens if..." for edge cases
- Look for what's missing, not just what's there

## Collaboration
- Commit early, commit often
- Write meaningful commit messages
- Keep PRs focused on one change
- Document decisions, not just code