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

3.1 KiB

Raw Blame History

Taskmaster AI - Claude Code Plugin Marketplace

📖 Looking for Claude Code setup? See the Complete Claude Code Setup Guide for all integration options (MCP, Plugin, Provider).

This document is specifically for plugin marketplace installation. The repository includes a Claude Code plugin marketplace in .claude-plugin/marketplace.json.

Installation

From GitHub (Public Repository)

Once this repository is pushed to GitHub, users can install with:

# Add the marketplace
/plugin marketplace add eyaltoledano/claude-task-master

# Install the plugin
/plugin install taskmaster@taskmaster

Local Development/Testing

# From the project root directory
cd /path/to/claude-task-master

# Build the plugin first
cd packages/claude-code-plugin
npm run build
cd ../..

# In Claude Code
/plugin marketplace add .
/plugin install taskmaster@taskmaster

Marketplace Structure

claude-task-master/
├── .claude-plugin/
│   └── marketplace.json        # Marketplace manifest (at repo root)
│
├── packages/claude-code-plugin/
│   ├── src/build.ts           # Build tooling
│   └── [generated plugin files]
│
└── assets/claude/              # Plugin source files
    ├── commands/
    └── agents/

Available Plugins

taskmaster

AI-powered task management system for ambitious development workflows.

Features:

49 slash commands for comprehensive task management
3 specialized AI agents (orchestrator, executor, checker)
MCP server integration
Complexity analysis and auto-expansion
Dependency management and validation
Automated workflow capabilities

Quick Start:

/tm:init
/tm:parse-prd
/tm:next

For Contributors

Adding New Plugins

To add more plugins to this marketplace:

Update marketplace.json:

{
  "plugins": [
    {
      "name": "new-plugin",
      "source": "./path/to/plugin",
      "description": "Plugin description",
      "version": "1.0.0"
    }
  ]
}

Commit and push the changes
Users update with: /plugin marketplace update taskmaster

Marketplace Versioning

The marketplace version is tracked in .claude-plugin/marketplace.json:

{
  "metadata": {
    "version": "1.0.0"
  }
}

Increment the version when adding or updating plugins.

Team Configuration

Organizations can auto-install this marketplace for all team members by adding to .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "task-master": {
      "source": {
        "source": "github",
        "repo": "eyaltoledano/claude-task-master"
      }
    }
  },
  "enabledPlugins": {
    "taskmaster": {
      "marketplace": "taskmaster"
    }
  }
}

Team members who trust the repository folder will automatically get the marketplace and plugins installed.

3.1 KiB Raw Blame History