About superpowers-tdd
superpowers-tdd is a test-driven development skill for features, bug fixes, and refactors. It guides work from defining behavior and writing tests through implementation, refactoring, and reporting verification.
Key features
- 01Follows red-green-refactor
- 02Adds regression tests for bug fixes when practical
- 03Uses verification when tests are difficult
- 04Keeps tests focused on behavior
- 05Reports tests, commands, and outcomes
Use cases
- 01Developing a unit-testable feature
- 02Fixing a bug with a regression test
- 03Refactoring while protecting existing behavior
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/superpowers-tddin Claude Code to confirm it loaded.
Details
From the project READMETDD Skill
When to use this skill
- new features that can be unit tested
- bug fixes (always add a regression test if practical)
- refactors (protect behavior with tests first)
Rules
- Prefer red -> green -> refactor.
- If tests are hard, still add verification: minimal repro script, integration test, or clear manual steps.
- Keep tests focused: one behavior per test where possible.
- Name tests by behavior, not implementation details.
Process
- Define the behavior change (what should be true after).
- Write/adjust a test to capture it (make it fail first if possible).
- Implement the minimal change to pass.
- Refactor if needed (keep passing).
- Run the relevant test suite + any linters.
Output requirements
When you change code, include:
- what tests you added/changed
- how to run them
- what they prove
Comments
Markdown supported