todo-resolve

Dispatch parallel subagents to implement ready todos and update todo files.

1|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/lucasmccomb/ccgm --skill todo-resolve-lucasmccomb
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: todo-resolve
Source: https://github.com/lucasmccomb/ccgm/tree/main/modules/todos/skills/todo-resolve
Command: npx skills add https://github.com/lucasmccomb/ccgm --skill todo-resolve-lucasmccomb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual overhead of resolving many small, ready-to-fix todos by orchestrating parallel subagents that implement each proposed change and update the todo ledger, reducing reviewer ping-pong and backlog friction.

Core Features & Use Cases

  • Automated Parallel Fixes: Plan and dispatch one subagent per ready todo, passing file paths (not contents) and aggregating results.
  • Safe Orchestration: Build a dependency graph, skip blocked items, enforce a four-state completion protocol (DONE, DONE_WITH_CONCERNS, BLOCKED, NEEDS_CONTEXT), and perform two-stage review before committing.
  • Commit, Update, and Report: Stage/commit diffs per todo, rename and update todo files with resolution metadata, optionally post GitHub PR back-references, and produce structured or human-readable run summaries.
  • Modes & Filtering: Operate interactively, autofix, report-only, or headless; filter by priority, source, PR, or explicit todo numbers.

Quick Start

Run /todo-resolve in mode:interactive to plan, review, and dispatch parallel subagents for ready todos.

Frequently Asked Questions about todo-resolve

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I batch-resolve code review todos in parallel using subagents?▼

Batch-resolving code review todos is handled by dispatching parallel subagents to implement each proposed change in .claude/todos files, aggregating results and updating the ledger automatically to reduce manual backlog friction.

How do I automate triage and pre-release cleanup for repository maintenance?▼

Automating triage and pre-release cleanup is achieved by filtering ready todos by priority, source, PR, or explicit IDs, then dispatching subagents in interactive, autofix, report-only, or headless modes to implement changes.

Can I run parallel git subagents to fix ready todos without dependency conflicts?▼

Running parallel subagents safely requires building a dependency graph to skip blocked items, passing file paths rather than contents, and enforcing a four-state completion protocol before staging and committing diffs.

What is the four-state completion protocol for automated todo resolution?▼

The four-state completion protocol tracks each subagent's resolution outcome as DONE, DONE_WITH_CONCERNS, BLOCKED, or NEEDS_CONTEXT, ensuring a two-stage review process validates results before committing any diffs.

Does todo-resolve work with GitHub PR comments and back-references?▼

GitHub PR integration is supported by optionally posting back-references as comments after subagents resolve todos, while also staging commits, renaming todo files, and producing structured or human-readable run summaries.

When should I avoid parallel subagent dispatch for repository maintenance?▼

Parallel subagent dispatch should be avoided when todos lack clear file paths, when dependency graphs show heavy blocking conflicts, or when interactive review is required for sensitive pre-release cleanup workflows.