Files
claude-task-master/assets/claude/TM_COMMANDS_GUIDE.md
Joe Danziger 95c299df64 Unify and streamline profile system architecture (#853)
* move claude rules and commands to assets/claude

* update claude profile to copy assets/claude to .claude

* fix formatting

* feat(profiles): Implement unified profile system

- Convert Claude and Codex profiles to use createProfile() factory
- Remove simple vs complex profile distinction in rule transformer
- Unify convertAllRulesToProfileRules() to handle all profiles consistently
- Fix mcpConfigPath construction in base-profile.js for null mcpConfigName
- Update terminology from 'simpleProfiles' to 'assetOnlyProfiles' throughout
- Ensure Claude .claude directory copying works in both CLI and MCP contexts
- All profiles now follow same execution flow with proper lifecycle functions

Changes:
- src/profiles/claude.js: Convert to createProfile() factory pattern
- src/profiles/codex.js: Convert to createProfile() factory pattern
- src/utils/rule-transformer.js: Unified profile handling logic
- src/utils/profiles.js: Remove simple profile categorization
- src/profiles/base-profile.js: Fix mcpConfigPath construction
- scripts/modules/commands.js: Update variable naming
- tests/: Update all tests for unified system and terminology

Fixes Claude profile asset copying issue in MCP context.
All tests passing (617 passed, 11 skipped).

* re-checkin claude files

* fix formatting

* chore: clean up test Claude rules files

* chore: add changeset for unified profile system

* add claude files back

* add changeset

* restore proper gitignore

* remove claude agents file from root

* remove incorrect doc

* simplify profiles and update tests

* update changeset

* update changeset

* remove profile specific code

* streamline profiles with defaults and update tests

* update changeset

* add newline at end of gitignore

* restore changes

* streamline profiles with defaults; update tests and add vscode test

* update rule profile tests

* update wording for clearer profile management

* refactor and clarify terminology

* use original projectRoot var name

* revert param desc

* use updated claude assets from neno

* add "YOUR_" before api key here

* streamline codex profile

* add gemini profile

* update gemini profile

* update tests

* relocate function

* update rules interactive setup Gemini desc

* remove duplicative code

* add comma
2025-07-09 13:22:11 +02:00

4.0 KiB

Task Master Commands for Claude Code

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

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