add_subtask

Attach a subtask to an existing task within Task Master, enabling detailed task breakdowns with titles, descriptions, statuses, dependencies, and implementation specifics for AI-driven development workflows.

Instructions

Add a subtask to an existing task

Input Schema

Name	Required	Description
`dependencies`	No	Comma-separated list of dependency IDs for the new subtask
`description`	No	Description for the new subtask
`details`	No	Implementation details for the new subtask
`file`	No	Absolute path to the tasks file (default: tasks/tasks.json)
`id`	Yes	Parent task ID (required)
`projectRoot`	Yes	The directory of the project. Must be an absolute path.
`skipGenerate`	No	Skip regenerating task files
`status`	No	Status for the new subtask (default: 'pending')
`tag`	No	Tag context to operate on
`taskId`	No	Existing task ID to convert to subtask
`title`	No	Title for the new subtask (when creating a new subtask)

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "dependencies": {
      "description": "Comma-separated list of dependency IDs for the new subtask",
      "type": "string"
    },
    "description": {
      "description": "Description for the new subtask",
      "type": "string"
    },
    "details": {
      "description": "Implementation details for the new subtask",
      "type": "string"
    },
    "file": {
      "description": "Absolute path to the tasks file (default: tasks/tasks.json)",
      "type": "string"
    },
    "id": {
      "description": "Parent task ID (required)",
      "type": "string"
    },
    "projectRoot": {
      "description": "The directory of the project. Must be an absolute path.",
      "type": "string"
    },
    "skipGenerate": {
      "description": "Skip regenerating task files",
      "type": "boolean"
    },
    "status": {
      "description": "Status for the new subtask (default: 'pending')",
      "type": "string"
    },
    "tag": {
      "description": "Tag context to operate on",
      "type": "string"
    },
    "taskId": {
      "description": "Existing task ID to convert to subtask",
      "type": "string"
    },
    "title": {
      "description": "Title for the new subtask (when creating a new subtask)",
      "type": "string"
    }
  },
  "required": [
    "id",
    "projectRoot"
  ],
  "type": "object"
}

Task Master

add_subtask

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Task Master

Related Tools

MCP directory API