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>
