From caea5058d9b4ef138a7f1d42c999d366c6d94560 Mon Sep 17 00:00:00 2001 From: Garry Tan Date: Wed, 18 Mar 2026 11:13:23 -0700 Subject: [PATCH] chore: add worktree parallel debug agents to TODOS.md (P2) When /qa hits multiple stubborn bugs, parallel debug agents in isolated git worktrees could investigate simultaneously. Deferred from the sequential debug escalation PR as a follow-up. Co-Authored-By: Claude Opus 4.6 (1M context) --- TODOS.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/TODOS.md b/TODOS.md index 710399e2..ebb88462 100644 --- a/TODOS.md +++ b/TODOS.md @@ -422,6 +422,20 @@ **Priority:** P2 **Depends on:** `garrytan/team-supabase-store` branch landing on main +## Debug + +### Worktree-based parallel debug sub-agents + +**What:** When /qa hits multiple stubborn bugs, spawn parallel debug agents each in their own git worktree (`isolation: "worktree"` on the Agent call). They investigate simultaneously while /qa continues other work. Results cherry-picked back. + +**Why:** Sequential debug investigations add ~2-5 min per bug. With 3-4 hard bugs, that's 10-20 min of sequential waiting. Parallel worktree agents could investigate all simultaneously, with zero working-tree conflicts. + +**Context:** v1 ships sequential (debug-subagent-escalation PR). The Agent tool supports `isolation: "worktree"` which creates a temporary git worktree — each agent gets its own copy of the repo. Especially powerful in plan mode where /qa might find multiple hard bugs across different subsystems. + +**Effort:** M (human: ~1 week / CC: ~30min) +**Priority:** P2 +**Depends on:** Sequential debug escalation (debug-subagent-escalation PR) + ## Design Review ### /plan-design-review + /qa-design-review + /design-consultation — SHIPPED