Pārlūkot izejas kodu

docs: add workflow section showing brainstorm→plan→execute→finish flow

Jesse Vincent 9 mēneši atpakaļ
vecāks
revīzija
3f73365155
1 mainītis faili ar 23 papildinājumiem un 0 dzēšanām
  1. 23 0
      README.md

+ 23 - 0
README.md

@@ -26,6 +26,29 @@ Skills are markdown files with proven workflows. The system teaches agents: "You
 
 **Plus:** Slash commands (`/superpowers:brainstorm`, `/superpowers:write-plan`, `/superpowers:execute-plan`) activate skills directly.
 
+## The Workflow
+
+**1. Brainstorm the design**
+```
+/superpowers:brainstorm
+```
+Refine rough ideas through Socratic questioning. Explore alternatives. Present design in sections, validate each. Output: design document.
+
+**2. Write the implementation plan**
+```
+/superpowers:write-plan
+```
+Break design into bite-sized tasks (2-5 minutes each). Include exact file paths, complete code, test commands. Output: task-by-task plan.
+
+**3. Execute with TDD**
+```
+/superpowers:execute-plan
+```
+Implement in batches with review checkpoints. Each task follows RED-GREEN-REFACTOR. Tests fail first, then pass. Frequent commits.
+
+**4. Finish the branch**
+Skills guide verification, decision (merge/PR/keep), and cleanup. Tests pass before merge. No broken windows.
+
 ## Philosophy
 
 Test-driven development. Systematic over ad-hoc. Evidence over claims. Simplicity as primary goal.