2025-04-09 00:16:43 +02:00
|
|
|
# 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?
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 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
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
We'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.
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 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?
|
|
|
|
|
```
|
docs: Update documentation for new AI/config architecture and finalize cleanup
This commit updates all relevant documentation (READMEs, docs/*, .cursor/rules) to accurately reflect the finalized unified AI service architecture and the new configuration system (.taskmasterconfig + .env/mcp.json). It also includes the final code cleanup steps related to the refactoring.
Key Changes:
1. **Documentation Updates:**
* Revised `README.md`, `README-task-master.md`, `assets/scripts_README.md`, `docs/configuration.md`, and `docs/tutorial.md` to explain the new configuration split (.taskmasterconfig vs .env/mcp.json).
* Updated MCP configuration examples in READMEs and tutorials to only include API keys in the `env` block.
* Added/updated examples for using the `--research` flag in `docs/command-reference.md`, `docs/examples.md`, and `docs/tutorial.md`.
* Updated `.cursor/rules/ai_services.mdc`, `.cursor/rules/architecture.mdc`, `.cursor/rules/dev_workflow.mdc`, `.cursor/rules/mcp.mdc`, `.cursor/rules/taskmaster.mdc`, `.cursor/rules/utilities.mdc`, and `.cursor/rules/new_features.mdc` to align with the new architecture, removing references to old patterns/files.
* Removed internal rule links from user-facing rules (`taskmaster.mdc`, `dev_workflow.mdc`, `self_improve.mdc`).
* Deleted outdated example file `docs/ai-client-utils-example.md`.
2. **Final Code Refactor & Cleanup:**
* Corrected `update-task-by-id.js` by removing the last import from the old `ai-services.js`.
* Refactored `update-subtask-by-id.js` to correctly use the unified service and logger patterns.
* Removed the obsolete export block from `mcp-server/src/core/task-master-core.js`.
* Corrected logger implementation in `update-tasks.js` for CLI context.
* Updated API key mapping in `config-manager.js` and `ai-services-unified.js`.
3. **Configuration Files:**
* Updated API keys in `.cursor/mcp.json`, replacing `GROK_API_KEY` with `XAI_API_KEY`.
* Updated `.env.example` with current API key names.
* Added `azureOpenaiBaseUrl` to `.taskmasterconfig` example.
4. **Task Management:**
* Marked documentation subtask 61.10 as 'done'.
* Includes various other task content/status updates from the diff summary.
5. **Changeset:**
* Added `.changeset/cuddly-zebras-matter.md` for user-facing `expand`/`expand-all` improvements.
This commit concludes the major architectural refactoring (Task 61) and ensures the documentation accurately reflects the current system.
2025-04-25 14:43:12 -04:00
|
|
|
|
|
|
|
|
### 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`)
|