Superpowers Workflow
When to use this skill
-
Always-on: This is the master orchestrator for all development work.
-
Before writing any code (Planning & Design).
-
During implementation (TDD & Logic).
-
After completion (Verification & Review).
Workflow (The "Superpowers" Way)
- Brainstorming & Design
-
Socratic Refinement: Don't jump into code. Ask questions to tease out a full spec.
-
Chunked Validation: Present the design in digestible parts for feedback.
-
Plan First: Output a detailed implementation plan before touching source files.
- Implementation Loop (RED-GREEN-REFACTOR)
-
Red: Write a failing test for the next bite-sized task.
-
Green: Write the minimal code needed to pass the test.
-
Refactor: Clean up the code while keeping it functional.
-
Commit early: Small, meaningful commits for every task.
- Verification & Review
-
Evidence over Claims: Prove it works with logs, screenshots, or test results.
-
Systematic Debugging: Use root-cause analysis if something fails.
-
Final Walkthrough: Summarize what was accomplished and how it's verified.
Core Philosophies
-
TDD (Test-Driven Development): Tests are not an afterthought; they are the blueprint.
-
YAGNI (You Aren't Gonna Need It): Do not over-engineer. Focus on the spec.
-
DRY (Don't Repeat Yourself): Keep the codebase clean and maintainable.
-
Composable Skills: Always check .agent/skills/ for relevant tools (e.g., handling-errors , deployment-guard ).
Instructions for the Agent
-
Check Skills FIRST: Before executing ANY plan, scan .agent/skills/ for tools that can automate or safeguard your work.
-
Explicit Verification: Never report a task as "done" without running a verification command (e.g., npm test , grep , or a custom script).
-
Proactive planning: If a task is complex, update task.md and implementation_plan.md IMMEDIATELY.
Resources
-
See BRAINSTORMING.md
-
See TDD-GUIDE.md