Skip to content

An agentic skills framework & software development methodology that works.

docs: add using-git-worktrees and subagent-driven-development to workflow

Jesse Vincent4ef2f9185da2
diff --git a/README.md b/README.md
index f3fb55024..63b4dbf79 100644
--- a/README.md
+++ b/README.md
@@ -28,17 +28,19 @@ Skills are markdown files with proven workflows. The system teaches agents: "You
**When you ask to build a feature:**
-1. **brainstorming** - Activates before writing code. Refines rough ideas through questions. Explores alternatives. Presents design in sections for validation. Outputs design document.
+1. **brainstorming** - Activates before writing code. Refines rough ideas through questions, explores alternatives, presents design in sections for validation. Saves design document.
-2. **writing-plans** - Activates when design is complete. Breaks work into tasks (2-5 minutes each). Includes exact file paths, complete code, verification commands. Outputs task-by-task plan.
+2. **using-git-worktrees** - Activates after design approval. Creates isolated workspace on new branch, runs project setup, verifies clean test baseline.
-3. **executing-plans** - Activates with a plan. Implements in batches with review checkpoints. Outputs working implementation.
+3. **writing-plans** - Activates with approved design. Breaks work into bite-sized tasks (2-5 minutes each). Every task has exact file paths, complete code, verification steps.
-4. **test-driven-development** - Activates during implementation. Enforces RED-GREEN-REFACTOR: write test, watch it fail, write code, watch it pass, commit. No code without failing test first.
+4. **subagent-driven-development** or **executing-plans** - Activates with plan. Dispatches fresh subagent per task (same session, fast iteration) or executes in batches (parallel session, human checkpoints).
-5. **requesting-code-review** - Activates between tasks. Reviews implementation against plan. Reports issues by severity.
+5. **test-driven-development** - Activates during implementation. Enforces RED-GREEN-REFACTOR: write failing test, watch it fail, write minimal code, watch it pass, commit. Deletes code written before tests.
-6. **finishing-a-development-branch** - Activates when work completes. Verifies tests, presents options (merge/PR/keep/discard), handles cleanup.
+6. **requesting-code-review** - Activates between tasks. Reviews against plan, reports issues by severity. Critical issues block progress.
+
+7. **finishing-a-development-branch** - Activates when tasks complete. Verifies tests, presents options (merge/PR/keep/discard), cleans up worktree.
**The agent decides which skills to use.** Skills activate automatically when your task matches their purpose.