From 23f40c162dd119a6fee13f483b407c4aa93e40b6 Mon Sep 17 00:00:00 2001 From: Copilot <198982749+Copilot@users.noreply.github.com> Date: Mon, 18 May 2026 20:15:04 +0200 Subject: [PATCH 1/5] docs: fix inaccurate descriptions in Basic Workflow README section (#1) --- README.md | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index ea17e30e0a..746378a1f7 100644 --- a/README.md +++ b/README.md @@ -153,19 +153,20 @@ already use it in another harness. ## The Basic Workflow -1. **brainstorming** - Activates before writing code. Refines rough ideas through questions, explores alternatives, presents design in sections for validation. Saves design document. +1. **brainstorming** - Activates before any implementation work. Refines rough ideas through questions, explores alternatives, presents design in sections for validation. Saves design document. -2. **using-git-worktrees** - Activates after design approval. Creates isolated workspace on new branch, runs project setup, verifies clean test baseline. +2. **writing-plans** - Invoked by brainstorming after spec approval. Breaks work into bite-sized tasks (2-5 minutes each). Every task has exact file paths, complete code, verification steps. -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. +3. **using-git-worktrees** - Activates before executing the plan. Creates isolated workspace on new branch, runs project setup, verifies clean test baseline. -4. **subagent-driven-development** or **executing-plans** - Activates with plan. Dispatches fresh subagent per task with two-stage review (spec compliance, then code quality), or executes in batches with human checkpoints. +4. **Implementation** - Repeat per task: + 1. Choose your execution path: + - **subagent-driven-development** *(preferred — requires subagent support)* — Dispatches a fresh subagent per task with two-stage review (spec compliance, then code quality). + - **executing-plans** *(fallback)* — Executes tasks in a separate session, stopping only on blockers. + 2. **test-driven-development** — Enforces RED-GREEN-REFACTOR: write failing test, watch it fail, write minimal code, watch it pass, commit. + 3. **requesting-code-review** — Reviews against plan, reports issues by severity. Critical issues block progress. -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. **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. +5. **finishing-a-development-branch** - Activates when tasks complete. Verifies tests, presents options (merge/PR/keep/discard), cleans up worktree if it was created by Superpowers. **The agent checks for relevant skills before any task.** Mandatory workflows, not suggestions. From bef8b978c3ef07343b633e21bef054c1a5db8d0b Mon Sep 17 00:00:00 2001 From: Copilot <198982749+Copilot@users.noreply.github.com> Date: Mon, 18 May 2026 21:37:26 +0200 Subject: [PATCH 2/5] README: align Basic Workflow step naming and nested list structure (#2) --- README.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 746378a1f7..2135aa5855 100644 --- a/README.md +++ b/README.md @@ -159,12 +159,12 @@ already use it in another harness. 3. **using-git-worktrees** - Activates before executing the plan. Creates isolated workspace on new branch, runs project setup, verifies clean test baseline. -4. **Implementation** - Repeat per task: - 1. Choose your execution path: - - **subagent-driven-development** *(preferred — requires subagent support)* — Dispatches a fresh subagent per task with two-stage review (spec compliance, then code quality). - - **executing-plans** *(fallback)* — Executes tasks in a separate session, stopping only on blockers. - 2. **test-driven-development** — Enforces RED-GREEN-REFACTOR: write failing test, watch it fail, write minimal code, watch it pass, commit. - 3. **requesting-code-review** — Reviews against plan, reports issues by severity. Critical issues block progress. +4. **subagent-driven-development** / **executing-plans** - Repeat per task: + 1. Choose your execution path: + - **subagent-driven-development** *(preferred — requires subagent support)* — Dispatches a fresh subagent per task with two-stage review (spec compliance, then code quality). + - **executing-plans** *(fallback)* — Executes tasks in a separate session, stopping only on blockers. + 2. **test-driven-development** — Enforces RED-GREEN-REFACTOR: write failing test, watch it fail, write minimal code, watch it pass, commit. + 3. **requesting-code-review** — Reviews against plan, reports issues by severity. Critical issues block progress. 5. **finishing-a-development-branch** - Activates when tasks complete. Verifies tests, presents options (merge/PR/keep/discard), cleans up worktree if it was created by Superpowers. From 9e8c1ab75cc39298e116d8b0aeacc5cf12de116a Mon Sep 17 00:00:00 2001 From: Valentin Laurent Date: Fri, 5 Jun 2026 17:53:18 +0200 Subject: [PATCH 3/5] Apply suggestion from @Valentin-Laurent --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 2135aa5855..9536c7e701 100644 --- a/README.md +++ b/README.md @@ -155,7 +155,7 @@ already use it in another harness. 1. **brainstorming** - Activates before any implementation work. Refines rough ideas through questions, explores alternatives, presents design in sections for validation. Saves design document. -2. **writing-plans** - Invoked by brainstorming after spec approval. Breaks work into bite-sized tasks (2-5 minutes each). Every task has exact file paths, complete code, verification steps. +2. **writing-plans** - Invoked by brainstorming after design approval. Breaks work into bite-sized tasks (2-5 minutes each). Every task has exact file paths, complete code, verification steps. 3. **using-git-worktrees** - Activates before executing the plan. Creates isolated workspace on new branch, runs project setup, verifies clean test baseline. From e8d36e7cf4c72f955af801a0ec8dbb05398c66b9 Mon Sep 17 00:00:00 2001 From: Valentin Laurent Date: Fri, 5 Jun 2026 17:53:29 +0200 Subject: [PATCH 4/5] Apply suggestion from @Valentin-Laurent --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9536c7e701..a98f030937 100644 --- a/README.md +++ b/README.md @@ -159,7 +159,7 @@ already use it in another harness. 3. **using-git-worktrees** - Activates before executing the plan. Creates isolated workspace on new branch, runs project setup, verifies clean test baseline. -4. **subagent-driven-development** / **executing-plans** - Repeat per task: +4. Implementation loop - Repeat per task: 1. Choose your execution path: - **subagent-driven-development** *(preferred — requires subagent support)* — Dispatches a fresh subagent per task with two-stage review (spec compliance, then code quality). - **executing-plans** *(fallback)* — Executes tasks in a separate session, stopping only on blockers. From 5c404f7fae88d43196f9794c508339919398fabc Mon Sep 17 00:00:00 2001 From: Valentin Laurent Date: Fri, 5 Jun 2026 17:53:37 +0200 Subject: [PATCH 5/5] Apply suggestion from @Valentin-Laurent --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index a98f030937..080fd750b3 100644 --- a/README.md +++ b/README.md @@ -166,7 +166,7 @@ already use it in another harness. 2. **test-driven-development** — Enforces RED-GREEN-REFACTOR: write failing test, watch it fail, write minimal code, watch it pass, commit. 3. **requesting-code-review** — Reviews against plan, reports issues by severity. Critical issues block progress. -5. **finishing-a-development-branch** - Activates when tasks complete. Verifies tests, presents options (merge/PR/keep/discard), cleans up worktree if it was created by Superpowers. +5. **finishing-a-development-branch** - Activates when tasks complete. Verifies tests, presents options (merge/PR/keep/discard), cleans up worktree if one was created. **The agent checks for relevant skills before any task.** Mandatory workflows, not suggestions.