driangle/taskmd/import-todos

Import TODOs

Discover TODO/FIXME comments in the codebase and convert selected ones into task files.

Instructions

The user may optionally provide flags in $ARGUMENTS (e.g. --marker TODO, --dir ./src, --include "*.go").

1. Discover TODOs: Run taskmd todos list --format json $ARGUMENTS via Bash to find all TODO/FIXME/HACK/XXX/NOTE/BUG/OPTIMIZE comments in the codebase

• If the command fails, check that taskmd is installed and the todos subcommand is available (requires taskmd v0.12+)

1. Handle empty results: If no TODOs are found (empty JSON array [] or no output), inform the user:

> "No TODO/FIXME comments found in the codebase. Try widening your search with --dir or removing --marker filters."

• Stop here — do not proceed further

1. Check for duplicates: Run taskmd list --format json to get existing task titles. For each TODO, check if its text closely matches an existing task title (case-insensitive substring match). Flag any potential duplicates.

1. Present the list: Display the TODOs as a numbered list in this format:

``` Found N TODO comments:

# | Marker | File | Text -----|--------|-------------------------------|---------------------------------- 1 | TODO | src/auth.go:42 | implement rate limiting 2 | FIXME | src/handler.go:15 | handle timeout errors 3 | TODO | src/db.go:88 | add connection pooling *4 | TODO | src/cache.go:12 | optimize cache (possible duplicate: task 045) ```

Mark potential duplicates with * and note the matching task.

1. Ask the user: Ask which TODOs to convert into tasks. Accept:

• Specific numbers: 1, 3, 5
• Ranges: 1-5
• A combination: 1-3, 7, 9-11
• all to convert everything
• none or empty to cancel

1. Handle cancellation: If the user selects none or cancels, exit gracefully:

> "No TODOs selected. Exiting."

1. Convert selected TODOs: For each selected TODO, invoke the /add-task skill using the Skill tool:

• Use the TODO text as the task description
• Include the source file and line number as context
• Use the marker type as a hint for the task type (e.g. FIXME/BUG → type bug, TODO → type feature)
• Format the skill argument as: <marker>: <text> (from <file>:<line>)

Example Skill invocation: `` Skill: add-task Args: "TODO: implement rate limiting (from src/auth.go:42)" ``

1. Report results: After all tasks are created, summarize:

``` Created N task(s) from TODOs:

• Task <ID>: <title> (from <file>:<line>)
• Task <ID>: <title> (from <file>:<line>)

```