Files

Eyal Toledano 023f51c579 feat(research): Adds MCP tool for command

- New MCP Tool: research tool enables AI-powered research with project context
- Context Integration: Supports task IDs, file paths, custom context, and project tree
- Fuzzy Task Discovery: Automatically finds relevant tasks using semantic search
- Token Management: Detailed token counting and breakdown by context type
- Multiple Detail Levels: Support for low, medium, and high detail research responses
- Telemetry Integration: Full cost tracking and usage analytics
- Direct Function: researchDirect with comprehensive parameter validation
- Silent Mode: Prevents console output interference with MCP JSON responses
- Error Handling: Robust error handling with proper MCP response formatting

This completes subtasks 94.5 (Direct Function) and 94.6 (MCP Tool) for the research command implementation, providing a powerful research interface for integrated development environments like Cursor.

Updated documentation across taskmaster.mdc, README.md, command-reference.md, examples.md, tutorial.md, and docs/README.md to highlight research capabilities and usage patterns.

2025-05-25 20:16:48 -04:00

4.6 KiB

Raw Blame History

Example Cursor AI Interactions

Here are some common interactions with Cursor AI when using Task Master:

Starting a new project

I've just initialized a new project with Claude Task Master. I have a PRD at scripts/prd.txt.
Can you help me parse it and set up the initial tasks?

Working on tasks

What's the next task I should work on? Please consider dependencies and priorities.

Implementing a specific task

I'd like to implement task 4. Can you help me understand what needs to be done and how to approach it?

Viewing multiple tasks

Can you show me tasks 1, 3, and 5 so I can understand their relationship?

I need to see the status of tasks 44, 55, and their subtasks. Can you show me those?

Show me tasks 10, 12, and 15 and give me some batch actions I can perform on them.

Managing subtasks

I need to regenerate the subtasks for task 3 with a different approach. Can you help me clear and regenerate them?

Handling changes

I've decided to use MongoDB instead of PostgreSQL. Can you update all future tasks to reflect this change?

Completing work

I've finished implementing the authentication system described in task 2. All tests are passing.
Please mark it as complete and tell me what I should work on next.

Reorganizing tasks

I think subtask 5.2 would fit better as part of task 7. Can you move it there?

(Agent runs: task-master move --from=5.2 --to=7.3)

Task 8 should actually be a subtask of task 4. Can you reorganize this?

(Agent runs: task-master move --from=8 --to=4.1)

I just merged the main branch and there's a conflict in tasks.json. My teammates created tasks 10-15 on their branch while I created tasks 10-12 on my branch. Can you help me resolve this by moving my tasks?

(Agent runs:

task-master move --from=10 --to=16
task-master move --from=11 --to=17
task-master move --from=12 --to=18

)

Analyzing complexity

Can you analyze the complexity of our tasks to help me understand which ones need to be broken down further?

Viewing complexity report

Can you show me the complexity report in a more readable format?

Breaking Down Complex Tasks

Task 5 seems complex. Can you break it down into subtasks?

(Agent runs: task-master expand --id=5)

Please break down task 5 using research-backed generation.

(Agent runs: task-master expand --id=5 --research)

Updating Tasks with Research

We need to update task 15 based on the latest React Query v5 changes. Can you research this and update the task?

(Agent runs: task-master update-task --id=15 --prompt="Update based on React Query v5 changes" --research)

Adding Tasks with Research

Please add a new task to implement user profile image uploads using Cloudinary, research the best approach.

(Agent runs: task-master add-task --prompt="Implement user profile image uploads using Cloudinary" --research)

Research-Driven Development

Getting Fresh Information

Research the latest best practices for implementing JWT authentication in Node.js applications.

(Agent runs: task-master research "Latest best practices for JWT authentication in Node.js")

Research with Project Context

I'm working on task 15 which involves API optimization. Can you research current best practices for our specific implementation?

(Agent runs: task-master research "API optimization best practices" --id=15 --files=src/api.js)

Research Before Implementation

Before I implement task 8 (React Query integration), can you research the latest React Query v5 patterns and any breaking changes?

(Agent runs: task-master research "React Query v5 patterns and breaking changes" --id=8)

Research and Update Pattern

Research the latest security recommendations for Express.js applications and update our authentication task with the findings.