research

research

Perform AI-powered research queries with project context to gather insights, analyze data, and save results directly to tasks or files for streamlined development workflows.

Instructions

Perform AI-powered research queries with project context

Input Schema

Name	Required	Description
`customContext`	No	Additional custom context text to include in the research
`detailLevel`	No	Detail level for the research response (default: medium)
`filePaths`	No	Comma-separated list of file paths for context (e.g., "src/api.js,docs/readme.md")
`includeProjectTree`	No	Include project file tree structure in context (default: false)
`projectRoot`	Yes	The directory of the project. Must be an absolute path.
`query`	Yes	Research query/prompt (required)
`saveTo`	No	Automatically save research results to specified task/subtask ID (e.g., "15" or "15.2")
`saveToFile`	No	Save research results to .taskmaster/docs/research/ directory (default: false)
`tag`	No	Tag context to operate on
`taskIds`	No	Comma-separated list of task/subtask IDs for context (e.g., "15,16.2,17")

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "customContext": {
      "description": "Additional custom context text to include in the research",
      "type": "string"
    },
    "detailLevel": {
      "description": "Detail level for the research response (default: medium)",
      "enum": [
        "low",
        "medium",
        "high"
      ],
      "type": "string"
    },
    "filePaths": {
      "description": "Comma-separated list of file paths for context (e.g., \"src/api.js,docs/readme.md\")",
      "type": "string"
    },
    "includeProjectTree": {
      "description": "Include project file tree structure in context (default: false)",
      "type": "boolean"
    },
    "projectRoot": {
      "description": "The directory of the project. Must be an absolute path.",
      "type": "string"
    },
    "query": {
      "description": "Research query/prompt (required)",
      "type": "string"
    },
    "saveTo": {
      "description": "Automatically save research results to specified task/subtask ID (e.g., \"15\" or \"15.2\")",
      "type": "string"
    },
    "saveToFile": {
      "description": "Save research results to .taskmaster/docs/research/ directory (default: false)",
      "type": "boolean"
    },
    "tag": {
      "description": "Tag context to operate on",
      "type": "string"
    },
    "taskIds": {
      "description": "Comma-separated list of task/subtask IDs for context (e.g., \"15,16.2,17\")",
      "type": "string"
    }
  },
  "required": [
    "query",
    "projectRoot"
  ],
  "type": "object"
}

Task Master

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Task Master

Related Tools

MCP directory API