36d559db26
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.
2.0 KiB
2.0 KiB
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?
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)