resolve-todo-parallel

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

Get all unresolved TODOs from the /todos/*.md directory

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

Create a task list of all unresolved items grouped by type (e.g., in Claude Code, 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.

Spawn a 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 the todo set is large enough that even batched short returns are likely to get noisy, use a per-run scratch directory such as :

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

Load the 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 . If no document was created (user declined or no non-trivial learnings), continue to step 6.

List all todos and identify those with or status, then delete them to keep the todo list clean and actionable.

If a scratch directory was used and the user did not ask to inspect it, clean it up after todo cleanup succeeds.

After cleanup, output a summary:

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