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.