Resolve TODOs Skill

Purpose: Resolve all TODO comments using parallel processing.

Arguments

• file-or-dir-path (optional): Path to a specific file or directory to scan for TODOs. If omitted, scans the entire repository.

Workflow

1. Gather TODOs

First, identify the scope:

• If an argument is provided, scan that specific file or directory

• If no argument, scan the entire codebase

Search for TODO comments in code files using Grep with pattern: (?i)TODO|FIXME|XXX

For each TODO found:

• Extract the TODO text

• Capture the file path and line number

• Include surrounding context (3-5 lines before and after) to understand the background

2. List TODOs

Present a comprehensive list of all TODOs with their context:

Found N TODOs

TODO 1: [Brief description]

Location: path/to/file.ext:line Context: ```language // Surrounding code context // With the TODO highlighted ```

TODO 2: ...

3. Prompt User Confirmation

Ask the user if they want to proceed with resolving all the TODOs:

"Found N TODOs. Do you want to proceed with resolving them? If yes, I'll use parallel processing to handle them efficiently."

Use AskUserQuestion to get confirmation before proceeding.

4. Plan Dependencies

Create a TodoWrite list of all TODOs. Analyze dependencies:

• Group TODOs by type (refactoring, feature addition, bug fix, etc.)

• Identify any dependencies between TODOs (e.g., one TODO requires another to complete first)

• Create a mermaid flow diagram showing the resolution order

Example mermaid diagram:

graph TD A[TODO: Rename variable X] --> B[TODO: Update references to X] C[TODO: Add new function] --> D[TODO: Write tests] B --> D

5. Resolve in Parallel

For each TODO that has no outstanding dependencies, spawn a general-purpose agent in parallel using the Task tool.

Example with 3 independent TODOs:

Launching parallel resolution agents for independent TODOs...

1. Spawning agent for TODO 1
2. Spawning agent for TODO 2
3. Spawning agent for TODO 3

Each Task should use subagent_type general-purpose with a prompt that includes:

• The TODO description

• The file location and context

• Clear instructions on what needs to be done

6. Commit & Resolve

After all parallel agents complete:

• Review the changes made

• Create a descriptive commit message summarizing all resolved TODOs

• Push to remote if configured

Notes

• The command searches for common TODO patterns: TODO , FIXME , XXX

• Context extraction helps understand the background and purpose of each TODO

• Parallel processing significantly speeds up resolution for independent TODOs

• Dependency analysis ensures correct resolution order