← Back to Kontasks
Claude Code Plans vs Todos Linkage
Explaining how Claude Code connects plans to actionable todos
Output
Plans vs Todos in Claude Code
Short Answer: No Direct Linking
Claude Code's Plan Mode and TodoWrite tool are separate features that don't automatically link to each other. They serve different purposes.
Plan Mode (EnterPlanMode)
- Used before implementation for user approval
- Explores codebase, writes plan to a file
- User reviews and approves before work begins
- Plan file is just a document - not executable
TodoWrite Tool
- Used during implementation for tracking
- Creates a visual task list in the UI
- Shows progress (pending → in_progress → completed)
- One task active at a time
The Gap
After a plan is approved, Claude must manually translate plan steps into todos. There's no automatic conversion from plan → todos.
Best practice: After exiting plan mode, Claude should immediately create todos matching the approved plan steps.
Kontasks are different - they're Konnect's custom async decision system, separate from Claude Code's native planning/todo features.
Quick Actions
Original Request
No layout configured
Details
Type
General
Status
Completed
Scope
vibetools
Tags
claude-codetodosplanning
Created
2 Jan 2026, 12:05 pm
Updated
2 Jan 2026, 12:05 pm
Created By
claude
Raw Data
{
"id": "32d02fa3-174b-4d8c-b540-c41d03f94360",
"type": "general",
"status": "completed",
"title": "Claude Code Plans vs Todos Linkage",
"description": "Explaining how Claude Code connects plans to actionable todos",
"context": {
"output": "<div style=\"background:#1e1e1e;color:#e0e0e0;padding:20px;border-radius:8px;font-family:sans-serif;\">\n<h2 style=\"color:#fff;margin:0 0 16px 0;\">Plans vs Todos in Claude Code</h2>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-bottom:16px;\">\n<h3 style=\"color:#61afef;margin:0 0 12px 0;\">Short Answer: No Direct Linking</h3>\n<p style=\"margin:0;line-height:1.6;\">Claude Code's <strong>Plan Mode</strong> and <strong>TodoWrite tool</strong> are separate features that don't automatically link to each other. They serve different purposes.</p>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-bottom:16px;\">\n<h3 style=\"color:#98c379;margin:0 0 12px 0;\">Plan Mode (EnterPlanMode)</h3>\n<ul style=\"margin:0;padding-left:20px;line-height:1.8;\">\n<li>Used <strong>before implementation</strong> for user approval</li>\n<li>Explores codebase, writes plan to a file</li>\n<li>User reviews and approves before work begins</li>\n<li>Plan file is just a document - not executable</li>\n</ul>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-bottom:16px;\">\n<h3 style=\"color:#e5c07b;margin:0 0 12px 0;\">TodoWrite Tool</h3>\n<ul style=\"margin:0;padding-left:20px;line-height:1.8;\">\n<li>Used <strong>during implementation</strong> for tracking</li>\n<li>Creates a visual task list in the UI</li>\n<li>Shows progress (pending → in_progress → completed)</li>\n<li>One task active at a time</li>\n</ul>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-bottom:16px;\">\n<h3 style=\"color:#c678dd;margin:0 0 12px 0;\">The Gap</h3>\n<p style=\"margin:0 0 12px 0;line-height:1.6;\">After a plan is approved, Claude must <strong>manually</strong> translate plan steps into todos. There's no automatic conversion from plan → todos.</p>\n<p style=\"margin:0;line-height:1.6;color:#7f848e;\">Best practice: After exiting plan mode, Claude should immediately create todos matching the approved plan steps.</p>\n</div>\n\n<div style=\"background:#3d3d3d;padding:12px;border-radius:6px;border-left:4px solid #61afef;\">\n<p style=\"margin:0;color:#e0e0e0;\"><strong>Kontasks are different</strong> - they're Konnect's custom async decision system, separate from Claude Code's native planning/todo features.</p>\n</div>\n</div>",
"requestedAt": "2026-01-02T08:43:00Z",
"requestId": "f63cc2d3-bf49-46b9-9a2f-8f9cdf000982"
},
"createdBy": "claude",
"createdAt": "2026-01-02T02:05:07.267Z",
"updatedAt": "2026-01-02T02:05:07.412Z",
"requestId": "f63cc2d3-bf49-46b9-9a2f-8f9cdf000982",
"scope": "vibetools",
"tags": [
"claude-code",
"todos",
"planning"
],
"targetUser": "claude"
}