From 7c10bdc76fa5514eb10ff64a889a809236d074b4 Mon Sep 17 00:00:00 2001 From: Lex Christopherson Date: Tue, 13 Jan 2026 17:46:55 -0600 Subject: [PATCH] docs: recommend execute-phase as primary execution command execute-phase with parallel agents is the recommended path. execute-plan is for single-plan or interactive checkpoint handling. Co-Authored-By: Claude Opus 4.5 --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 81fbe64b0..07776c329 100644 --- a/README.md +++ b/README.md @@ -172,17 +172,17 @@ Produces: ``` /gsd:plan-phase 1 # System creates atomic task plans -/gsd:execute-plan # Subagent implements autonomously +/gsd:execute-phase 1 # Parallel agents execute all plans ``` -Each phase breaks into 2-3 atomic tasks. Each task runs in a fresh subagent context — 200k tokens purely for implementation, zero degradation. +Each phase breaks into 2-3 task plans. Each plan runs in a fresh subagent context — 200k tokens purely for implementation, zero degradation. Plans without dependencies run in parallel. -**For multi-plan phases:** +**For single-plan or interactive execution:** ``` -/gsd:execute-phase 1 # Run all plans in parallel, "walk away" execution +/gsd:execute-plan # Run one plan at a time with checkpoints ``` -Use `/gsd:execute-plan` for interactive single-plan execution with checkpoints. Use `/gsd:execute-phase` when you have multiple plans and want parallel "walk away" automation. +Use `/gsd:execute-phase` for parallel "walk away" automation (recommended). Use `/gsd:execute-plan` when you need interactive single-plan execution with manual checkpoints. ### 4. Ship and iterate