Dream Team

Assemble your dream team of Claude Code agents to solve complex tasks through a systematic 5-phase workflow.

Overview

Dream Team is a Claude Code plugin that orchestrates teams of specialized agents to tackle complex development tasks. It automatically analyzes your project, identifies talent gaps, discovers and assembles the right agents and skills, and then coordinates them to execute your task.

The 5-Phase Workflow

1. Scope - Analyze project structure, architecture, and existing capabilities
2. Team-Plan - Identify talent gaps between available resources and task requirements
3. Assemble - Discover plugins, agents, and skills (top 5 matches)
4. Train - Create custom agents and skills for remaining gaps (auto-generated)
5. Execute - Orchestrate an agent team to solve the task

Prerequisites

Enable Agent Teams (Required)

Dream Team requires Claude Code's experimental agent teams feature for parallel agent coordination.

Add to your .claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Or set the environment variable:

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Without this enabled, Dream Team will fall back to sequential subagent execution (slower, less parallel).

Installation

Via Custom Marketplace (Recommended)

Dream Team is distributed through a custom marketplace. Add it to Claude Code:

# Add the marketplace
claude plugin marketplace add drbscl/dream-team

# Install the plugin
claude plugin install dream-team@dream-team-marketplace

Or interactively within Claude Code:

/plugin marketplace add drbscl/dream-team
/plugin install dream-team@dream-team-marketplace

From Source (Development)

git clone https://github.com/drbscl/dream-team.git
claude --plugin-dir ./dream-team

Usage

/dream-team [your task description]

Examples

/dream-team Refactor the authentication module to use JWT tokens with refresh token rotation

/dream-team Add comprehensive test coverage for the payment processing API

/dream-team Optimize the database queries for the analytics dashboard

/dream-team Create a new microservice for user notifications

⚠️ Security Notice

IMPORTANT SECURITY WARNING

DO NOT run with --dangerously-skip-permissions during the assembly phase!

External agents and skills from third-party sources may contain:

• Prompt injections
• Malicious instructions
• Unintended behaviors

CRITICAL: Popularity or install count does NOT mean something is safe. A widely-used agent could still contain vulnerabilities or malicious code. You must review every resource yourself before approving it.

Best Practices

1. Review Before Installing

   • Read agent/skill descriptions carefully
   • Check the source repository for suspicious code
   • Verify the author/publisher identity
   • Look at recent commits and issues
   • Never install based on popularity alone

2. Use Minimal Permissions

   • Don't use --dangerously-skip-permissions right away
   • Review permission prompts individually
   • Understand what each resource is requesting

User Approval Checkpoints

The workflow includes 3 mandatory approval points:

1. Assembly Review

Before installing external resources, you'll see:

• Resource name and description
• Source location (repository/URL)
• Relevance score

You choose which to install.

2. Training Review

Before creating custom agents/skills, you'll see:

• Proposed agent definitions (name, description, system prompt)
• Proposed skill definitions (purpose, instructions)
• Where they'll be saved (.claude/agents/, .claude/skills/)

You approve, modify, or skip each one.

3. Execute Review

Before spawning the team, you'll see:

• Team composition (which agents will be spawned)
• Task breakdown and assignments
• Estimated number of teammates
• Execution mode (agent teams vs subagents)

You confirm before execution begins.

How It Works

Phase 1: Scope

The plugin analyzes your project:

• Reads CLAUDE.md, README, package.json, and other config files
• Explores codebase structure
• Catalogs existing .claude/ configuration
• Identifies tech stack and patterns

Phase 2: Team-Plan

The plugin identifies gaps:

• Deconstructs your task into specific requirements
• Maps required capabilities (security, performance, testing, etc.)
• Compares against existing agents and skills
• Determines if assembly/training is needed

Phase 3: Assemble

If gaps exist, the plugin searches:

• Plugins: Official Claude marketplace (top 5 matches)
• Agents: VoltAgent repository (top 5 matches)
• Skills: skills.sh registry (top 5 matches)

Resources are ranked by relevance and popularity.

Phase 4: Train

If gaps remain, the plugin creates:

• Custom agent definitions for missing expertise
• Custom skill definitions for project-specific needs
• All saved to .claude/agents/ and .claude/skills/

Phase 5: Execute

The plugin orchestrates the team:

• Creates agent team (if enabled) or uses subagents
• Spawns teammates with specific roles
• Assigns tasks and coordinates work
• Synthesizes results

Resource Discovery

Plugins

• Source: Official Claude Code marketplace
• Method: Direct marketplace API queries
• Limit: Top 5 by relevance

Agents

• Source: VoltAgent/awesome-claude-code-subagents
• Method: GitHub raw file fetching
• Limit: Top 5 by category relevance
• Categories: Core Dev, Language Specialists, Infrastructure, Quality & Security, Data & AI, Developer Experience, Specialized Domains, Business & Product, Meta & Orchestration, Research & Analysis

Skills

• Source: skills.sh registry
• Method: Registry API queries
• Limit: Top 5 by install count + relevance

Requirements

• Claude Code 1.0.33 or later
• Git (for fetching agents from repositories)
• curl or wget (for API queries)
• (Optional) CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 for parallel execution

Project Structure

dream-team/
├── .claude-plugin/
│   └── plugin.json           # Plugin manifest
├── commands/
│   └── dream-team.md         # Main orchestration command
├── skills/
│   ├── scope/                # Project analysis
│   ├── team-plan/            # Gap identification
│   ├── assemble-plugins/     # Plugin discovery
│   ├── assemble-agents/      # Agent discovery
│   ├── assemble-skills/      # Skill discovery
│   ├── train/                # Custom resource creation
│   └── execute/              # Team orchestration
├── README.md
└── LICENSE

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Development Setup

git clone https://github.com/drbscl/dream-team.git
cd dream-team
claude --plugin-dir .

Testing

Test the plugin with various project types:

• Web applications (React, Vue, Angular)
• APIs (REST, GraphQL)
• Mobile apps (React Native, Flutter)
• Data/ML projects
• Infrastructure/DevOps tasks

License

MIT License - see LICENSE for details.

Acknowledgments

• Claude Code by Anthropic
• VoltAgent for the agent catalog
• skills.sh for the skill registry
• The Claude Code community for inspiration and feedback

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions

---

Remember: Always review external resources before installing them. Security first! 🔒