mirror of https://github.com/eyaltoledano/claude-task-master.git synced 2026-01-30 06:12:05 +00:00

Files

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

4.3 KiB

Raw Permalink Blame History

Task Master Commands for Claude Code

📖 New to Claude Code + Task Master? See the Complete Claude Code Setup Guide for installation options.

This guide is specifically for users who have installed the Task Master plugin and want to use slash commands.

Complete guide to using Task Master through Claude Code's slash commands.

Overview

All Task Master functionality is available through the /project:tm/ namespace with natural language support and intelligent features.

Quick Start

# Install Task Master
/project:tm/setup/quick-install

# Initialize project
/project:tm/init/quick

# Parse requirements
/project:tm/parse-prd requirements.md

# Start working
/project:tm/next

Command Structure

Commands are organized hierarchically to match Task Master's CLI:

Main commands at /project:tm/[command]
Subcommands for specific operations /project:tm/[command]/[subcommand]
Natural language arguments accepted throughout

Complete Command Reference

Setup & Configuration

/project:tm/setup/install - Full installation guide
/project:tm/setup/quick-install - One-line install
/project:tm/init - Initialize project
/project:tm/init/quick - Quick init with -y
/project:tm/models - View AI config
/project:tm/models/setup - Configure AI

Task Generation

/project:tm/parse-prd - Generate from PRD
/project:tm/parse-prd/with-research - Enhanced parsing
/project:tm/generate - Create task files

Task Management

/project:tm/list - List with natural language filters
/project:tm/list/with-subtasks - Hierarchical view
/project:tm/list/by-status <status> - Filter by status
/project:tm/show <id> - Task details
/project:tm/add-task - Create task
/project:tm/update - Update tasks
/project:tm/remove-task - Delete task

Status Management

/project:tm/set-status/to-pending <id>
/project:tm/set-status/to-in-progress <id>
/project:tm/set-status/to-done <id>
/project:tm/set-status/to-review <id>
/project:tm/set-status/to-deferred <id>
/project:tm/set-status/to-cancelled <id>

Task Analysis

/project:tm/analyze-complexity - AI analysis
/project:tm/complexity-report - View report
/project:tm/expand <id> - Break down task
/project:tm/expand/all - Expand all complex

Dependencies

/project:tm/add-dependency - Add dependency
/project:tm/remove-dependency - Remove dependency
/project:tm/validate-dependencies - Check issues
/project:tm/fix-dependencies - Auto-fix

Workflows

/project:tm/workflows/smart-flow - Adaptive workflows
/project:tm/workflows/pipeline - Chain commands
/project:tm/workflows/auto-implement - AI implementation

Utilities

/project:tm/status - Project dashboard
/project:tm/next - Next task recommendation
/project:tm/utils/analyze - Project analysis
/project:tm/learn - Interactive help

Key Features

Natural Language Support

All commands understand natural language:

/project:tm/list pending high priority
/project:tm/update mark 23 as done
/project:tm/add-task implement OAuth login

Smart Context

Commands analyze project state and provide intelligent suggestions based on:

Current task status
Dependencies
Team patterns
Project phase

Visual Enhancements

Progress bars and indicators
Status badges
Organized displays
Clear hierarchies

Common Workflows

Daily Development

/project:tm/workflows/smart-flow morning
/project:tm/next
/project:tm/set-status/to-in-progress <id>
/project:tm/set-status/to-done <id>

Task Breakdown

/project:tm/show <id>
/project:tm/expand <id>
/project:tm/list/with-subtasks

Sprint Planning

/project:tm/analyze-complexity
/project:tm/workflows/pipeline init → expand/all → status

Migration from Old Commands

Old	New
`/project:task-master:list`	`/project:tm/list`
`/project:task-master:complete`	`/project:tm/set-status/to-done`
`/project:workflows:auto-implement`	`/project:tm/workflows/auto-implement`

Tips

Use /project:tm/ + Tab for command discovery
Natural language is supported everywhere
Commands provide smart defaults
Chain commands for automation
Check /project:tm/learn for interactive help

4.3 KiB Raw Permalink Blame History