Skip to content
Agent Orchestration
Command

/convert-task-to-subtask

Convert an existing task into a subtask.

BOOST
From plugin
claude-task-master
28k49 skills3 agents49 commands1 MCP
Install
> /plugin marketplace add eyaltoledano/claude-task-master
> /plugin install taskmaster@taskmaster

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/convert-task-to-subtask

Context preview

What this command does when you run it.

Convert an existing task into a subtask.

Command definition

convert-task-to-subtask.md

Convert an existing task into a subtask.

Arguments: $ARGUMENTS

Parse parent ID and task ID to convert.

Task Conversion

Converts an existing standalone task into a subtask of another task.

Argument Parsing

  • "move task 8 under 5"
  • "make 8 a subtask of 5"
  • "nest 8 in 5"
  • "5 8" → make task 8 a subtask of task 5

Execution

task-master add-subtask --parent=<parent-id> --task-id=<task-to-convert>

Pre-Conversion Checks

1. **Validation**

  • Both tasks exist and are valid
  • No circular parent relationships
  • Task isn't already a subtask
  • Logical hierarchy makes sense

2. **Impact Analysis**

  • Dependencies that will be affected
  • Tasks that depend on converting task
  • Priority alignment needed
  • Status compatibility

Conversion Process

1. Change task ID from "8" to "5.1" (next available) 2. Update all dependency references 3. Inherit parent's context where appropriate 4. Adjust priorities if needed 5. Update time estimates

Smart Features

  • Preserve task history
  • Maintain dependencies
  • Update all references
  • Create conversion log

Example

/taskmaster:add-subtask/from-task 5 8
→ Converting: Task #8 becomes subtask #5.1
→ Updated: 3 dependency references
→ Parent task #5 now has 1 subtask
→ Note: Subtask inherits parent's priority

Before: #8 "Implement validation" (standalone)
After:  #5.1 "Implement validation" (subtask of #5)

Post-Conversion

  • Show new task hierarchy
  • List updated dependencies
  • Verify project integrity
  • Suggest related conversions
Read more
Ships withclaude-task-master

An AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others.

Get the whole plugin
Stats
28,132
Stars
2,618
Forks
Maintained
Maintenance
JavaScript
Language
5mo ago
Last commit
1y ago
Created
3h ago
Added

Repo: eyaltoledano/claude-task-master

Other commands on claude-task-master.