Files
claude-task-master/apps/docs/docs.json
claude[bot] 78115616ae docs: consolidate Claude Code documentation and fix confusion
Fixes #1550

This PR addresses the documentation chaos reported in issue #1550 by:

1. Creating a comprehensive Claude Code setup guide at apps/docs/integrations/claude-code.mdx that:
   - Clearly explains all 3 integration options (MCP Server, Plugin, Provider)
   - Includes a comparison table to help users choose the right option
   - Clarifies the naming confusion between task-master-ai (MCP package) and task-master (CLI)
   - Provides comprehensive troubleshooting for common issues

2. Simplifying README.md:
   - Consolidated duplicate Claude Code installation sections
   - Added prominent links to the comprehensive guide
   - Reduced confusion by pointing to single source of truth

3. Updating documentation navigation:
   - Added new 'Integrations' section to docs.json
   - Made Claude Code guide easily discoverable

4. Deprecating redundant documentation:
   - Added deprecation notices to docs/claude-code-integration.md
   - Added deprecation notices to docs/examples/claude-code-usage.md
   - Both files now point to the new consolidated guide

5. Adding context to existing files:
   - Explained CLAUDE.md auto-load purpose
   - Clarified CLAUDE_CODE_PLUGIN.md is for plugin users
   - Added setup guide link to TM_COMMANDS_GUIDE.md

This creates a single landing page (docs.task-master.dev/integrations/claude-code)
that new users can reference, eliminating the confusion from multiple
installation methods scattered across 5+ different files.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Ralph Khreish <Crunchyman-ralph@users.noreply.github.com>
2026-01-02 11:57:26 +00:00

100 lines
2.2 KiB
JSON

{
"$schema": "https://mintlify.com/docs.json",
"theme": "mint",
"name": "Task Master",
"colors": {
"primary": "#3366CC",
"light": "#6699FF",
"dark": "#24478F"
},
"favicon": "/favicon.svg",
"navigation": {
"tabs": [
{
"tab": "Task Master Documentation",
"groups": [
{
"group": "Welcome",
"pages": ["introduction"]
},
{
"group": "Getting Started",
"pages": [
{
"group": "Quick Start",
"pages": [
"getting-started/quick-start/quick-start",
"getting-started/quick-start/requirements",
"getting-started/quick-start/installation",
"getting-started/quick-start/configuration-quick",
"getting-started/quick-start/prd-quick",
"getting-started/quick-start/tasks-quick",
"getting-started/quick-start/execute-quick"
]
},
"getting-started/api-keys",
"getting-started/faq",
"getting-started/contribute"
]
},
{
"group": "Best Practices",
"pages": [
"best-practices/index",
"best-practices/configuration-advanced",
"best-practices/advanced-tasks"
]
},
{
"group": "Technical Capabilities",
"pages": [
"capabilities/mcp",
"capabilities/cli-root-commands",
"capabilities/task-structure"
]
},
{
"group": "Integrations",
"pages": ["integrations/claude-code"]
},
{
"group": "AI Providers",
"pages": ["providers/azure"]
},
{
"group": "TDD Workflow (Autopilot)",
"pages": [
"tdd-workflow/quickstart",
"tdd-workflow/ai-agent-integration"
]
}
]
}
],
"global": {
"anchors": [
{
"anchor": "Github",
"href": "https://github.com/eyaltoledano/claude-task-master",
"icon": "github"
},
{
"anchor": "Discord",
"href": "https://discord.gg/fWJkU7rf",
"icon": "discord"
}
]
}
},
"logo": {
"light": "/logo/light.svg",
"dark": "/logo/dark.svg"
},
"footer": {
"socials": {
"x": "https://x.com/TaskmasterAI",
"github": "https://github.com/eyaltoledano/claude-task-master"
}
}
}