gvkhosla/resolve-todo-parallel

Resolve all TODO comments using parallel processing, document lessons learned, then clean up completed todos.

Workflow

1. Analyze

Get all unresolved TODOs from .context/compound-engineering/todos/*.md and legacy todos/*.md

Residual actionable work may come from ce:review-beta mode:autonomous after its in-skill safe_auto pass. Treat those todos as normal unresolved work items; the review skill has already decided they should not be auto-fixed inline.

If any todo recommends deleting, removing, or gitignoring files in docs/brainstorms/, docs/plans/, or docs/solutions/, skip it and mark it as wont_fix. These are compound-engineering pipeline artifacts that are intentional and permanent.

2. Plan

Create a task list of all unresolved items grouped by type (e.g., TaskCreate in Claude Code, update_plan in Codex). Analyze dependencies and prioritize items that others depend on. For example, if a rename is needed, it must complete before dependent items. Output a mermaid flow diagram showing execution order — what can run in parallel, and what must run first.

3. Implement (PARALLEL)

Spawn a compound-engineering:workflow:pr-comment-resolver agent for each unresolved item.

If there are 3 items, spawn 3 agents — one per item. Prefer running all agents in parallel; if the platform does not support parallel dispatch, run them sequentially respecting the dependency order from step 2.

Keep parent-context pressure bounded:

• If there are 1-4 unresolved items, direct parallel returns are fine
• If there are 5+ unresolved items, launch in batches of at most 4 agents at a time
• Require each resolver agent to return only a short status summary to the parent: todo handled, files changed, tests run or skipped, and any blocker that still needs follow-up

If the todo set is large enough that even batched short returns are likely to get noisy, use a per-run scratch directory such as .context/compound-engineering/resolve-todo-parallel/<run-id>/:

• Have each resolver write a compact artifact for its todo there
• Return only a completion summary to the parent
• Re-read only the artifacts that are needed to summarize outcomes, document learnings, or decide whether a todo is truly resolved

4. Commit & Resolve

• Commit changes
• Remove the TODO from the file, and mark it as resolved.
• Push to remote

GATE: STOP. Verify that todos have been resolved and changes committed. Do NOT proceed to step 5 if no todos were resolved.

5. Compound on Lessons Learned

Load the ce:compound skill to document what was learned from resolving the todos.

The todo resolutions often surface patterns, recurring issues, or architectural insights worth capturing. This step ensures that knowledge compounds rather than being lost.

GATE: STOP. Verify that the compound skill produced a solution document in docs/solutions/. If no document was created (user declined or no non-trivial learnings), continue to step 6.

6. Clean Up Completed Todos

Search both .context/compound-engineering/todos/ and legacy todos/ for files with done, resolved, or complete status, then delete them to keep the todo list clean and actionable.

If a per-run scratch directory was created at .context/compound-engineering/resolve-todo-parallel/<run-id>/, and the user did not ask to inspect it, delete that specific <run-id>/ directory after todo cleanup succeeds. Do not delete any other .context/ subdirectories.

After cleanup, output a summary:

Todos resolved: [count]
Lessons documented: [path to solution doc, or "skipped"]
Todos cleaned up: [count deleted]