From Todos
Batch-resolve ready todos in .claude/todos/. Dispatches parallel subagents (one per todo) with pass-paths-not-contents, aggregates their fixes, updates each todo's status to complete, and optionally feeds the pattern back into /compound for team knowledge. Filter by priority, source, or explicit numbers. Skips todos whose dependencies are not complete. Modes - interactive (confirm before each) / autofix / report-only / headless. Triggers: todo resolve, resolve todos, fix ready todos, batch fix todos, burn down todos, process the todo list.
How this skill is triggered — by the user, by Claude, or both
Slash command
/todos:todo-resolveThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
`/todo-triage` decides which todos are ready. `/todo-resolve` does the work.
/todo-triage decides which todos are ready. /todo-resolve does the work.
This skill exists because small findings accumulate. Ten p3 nits are individually trivial but collectively a drag. Dispatching one subagent per todo lets the orchestrator burn through them in parallel without polluting the main context.
/todo-triage promotes a batch of items to readyDo not run during active feature development on the same files - the parallel fan-out will conflict with in-flight edits.
Parse $ARGUMENTS for a mode token:
mode:interactive (default) - Plan the batch, show the plan, ask before dispatchingmode:autofix - Plan and dispatch without asking; write a run artifact at .claude/todos/.runs/YYYYMMDD-HHMM.md summarizing what landedmode:report-only - Produce the plan only. Do not dispatch. Safe for concurrent runsmode:headless - For skill-to-skill composition. Structured output envelope, no prompts, no conversational prose, terminal "Resolve complete" lineParse $ARGUMENTS for optional filters (compose with the mode token):
priority:p1 (or p2, p3) - only this priority bandsource:review (or pr-comment, debug, planning, ad-hoc) - only this sourcepr:123 - only todos tied to PR 123only:7,12,19 - only the listed sequence numbersstatus: ready todosList candidates: every .claude/todos/NNN-ready-*.md matching the filter.
For each candidate, read frontmatter and body.
Build a dependency graph from the dependencies frontmatter field.
Skip any todo whose dependencies are not status: complete. Record these as blocked in the plan, do not dispatch.
Print the plan:
Plan: resolve N ready todos in parallel.
dispatching:
#007 [p2] extract-auth-middleware (files: src/auth/*.ts)
#012 [p3] rename-foo-to-bar (files: src/utils/foo.ts)
blocked (dependencies not complete):
#019 [p2] add-rate-limiter (waits on #015)
skipped (out of filter):
#003 [p1] ...
In mode:interactive, ask: Dispatch N subagents in parallel? [y/n/edit]. In mode:autofix and mode:headless, proceed. In mode:report-only, stop here.
Dispatch one subagent per non-blocked todo, in parallel. Each subagent spec:
Objective - Implement the Proposed Change section of the todo file.
Context (pass paths, not contents - see modules/subagent-patterns/rules/subagent-patterns.md):
.claude/todos/NNN-ready-{priority}-{slug}.mdfiles frontmatter field (if present)AGENTS.md or CLAUDE.md for house styleConstraints:
files field. If a change requires editing a path not listed, STOP and return BLOCKED with an explanation./todo-create and keep it out of the current fix.Deliverable - Either:
DONE + diff + one-paragraph resolution note, orBLOCKED + reason, orNEEDS_CONTEXT + the specific missing information, orDONE_WITH_CONCERNS + diff + concerns sectionSee modules/subagent-patterns/rules/subagent-patterns.md for the four-state completion protocol.
When subagents return, do not trust self-reports. Two passes (see subagent-patterns):
Re-dispatch with specific feedback for any subagent that failed either stage. Do not silently patch subagent output.
For each DONE subagent:
#todo-NNN: {title} (plural todos: ... if batching multiple into one commit).status: ready -> status: complete## Resolution section with the resolution note and commit SHANNN-ready-{priority}-{slug}.md -> NNN-complete-{priority}-{slug}.mdFor each DONE_WITH_CONCERNS: same as DONE, but preserve the concerns section in the Resolution body for future reference.
For each BLOCKED or NEEDS_CONTEXT: leave the todo as ready, append a ## Attempt section noting what was tried and why it stalled.
Print a run summary:
Resolved N ready todos:
complete : M
blocked : K
needs_context : J
concerns : P
Commits: {shas}
If M >= 3 or any concerns were flagged, suggest:
Consider running /compound to capture the pattern that surfaced across these fixes.
Do not auto-invoke /compound. Compound is explicit - the user or the orchestrator decides when a batch of todos represents a durable team learning vs. just cleanup.
For todos with a pr: frontmatter field and source pr-comment:
gh api noting the resolution (commit SHA + one-line summary).If gh is not authenticated or the PR is merged, skip the comment and note it in the run summary.
When called from ce-review or a batch orchestrator in mode:headless:
{ complete: [...], blocked: [...], concerns: [...] }Resolve complete on its own line so the caller can detect terminationSee modules/subagent-patterns/rules/subagent-patterns.md for the full mode contract.
The adoption rationale for this whole module: agent time is cheap, tech debt is expensive. A p3 nit that sits in a review thread forever costs more in re-review and context-switching than it does to fix in a parallel subagent. Default to resolving, not deferring. The only reason to leave a ready todo unresolved is a real dependency or a legitimate scope concern - not "it is small, I will get to it."
Searches MemPalace before answering questions about past work, people, projects, or prior decisions. Returns verbatim stored content instead of guessing from model memory.
Guides Payload CMS config (payload.config.ts), collections, fields, hooks, access control, APIs. Debugs validation errors, security, relationships, queries, transactions, hook behavior.
Implements vector databases with Pinecone, Weaviate, Qdrant, Milvus, pgvector for semantic search, RAG, recommendations, and similarity systems. Optimizes embeddings, indexing, and hybrid search.
npx claudepluginhub lucasmccomb/ccgm --plugin todos