process-todo

Categorize and dispatch TODO.md items across git worktrees.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/jeff-hamm/ai-tools --skill process-todo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: process-todo
Source: https://github.com/jeff-hamm/ai-tools/tree/main/src/skills/process-todo
Command: npx skills add https://github.com/jeff-hamm/ai-tools --skill process-todo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Process TODO.md backlog by categorizing items, showing approval options, and dispatching fault-tolerant fixes across git worktrees; it orchestrates multi-item remediation while handling both structured findings and freeform checklists.

Core Features & Use Cases

  • Batch categorize and triage TODO.md items to safe, discussable, or planning states.
  • Dispatch parallel subagents across isolated worktrees with per-item branches and a central ledger.
  • Resume incomplete sessions, audit changes, and integrate with code-review workflows.

Quick Start

Run the skill on TODO.md to categorize items, present choices, and dispatch fault-tolerant fixes across git worktrees.

Frequently Asked Questions about process-todo

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

FAQPage Schema
How do I automate batch triage of TODO items across git worktrees?

Batch triage of TODO items across git worktrees is automated by categorizing backlog entries into safe, discussable, or planning states, then dispatching parallel subagents to isolated worktrees with per-item branches for fault-tolerant remediation.

Can I resume an incomplete TODO backlog triage session if it gets interrupted?

Interrupted TODO backlog triage sessions can be resumed using a central ledger that tracks dispatch progress, allowing you to audit changes and continue incomplete remediation across worktrees without losing state.

How does batch TODO dispatch integrate with code review workflows?

Batch TODO dispatch integrates with code review workflows by applying post-review remediation to structured findings and freeform checklists, categorizing items, and dispatching fixes to isolated worktrees for review-ready branches.

What is the maximum number of parallel tasks supported when dispatching TODO fixes to worktrees?

Parallel dispatch of TODO fixes across worktrees supports a maximum of three concurrent subagents, ensuring isolated per-item branch creation while maintaining fault tolerance through the central ledger.

Do I need structured findings to triage a TODO backlog, or can I use freeform checklists?

TODO backlog triage supports both structured findings and freeform checklists, categorizing items into actionable states and dispatching them across git worktrees without requiring a specific input format.

Why use isolated git worktrees for batch TODO remediation instead of a single branch?

Isolated git worktrees provide per-item branches for batch TODO remediation, preventing merge conflicts during parallel dispatch and enabling fault-tolerant resume through the central ledger if any subagent task fails.