myclaude/docs/PLUGIN-SYSTEM.md

Plugin System Guide

Native Claude Code plugin support for modular workflow installation

🎯 Overview

This repository provides 4 ready-to-use Claude Code plugins that can be installed individually or as a complete suite.

📦 Available Plugins

1. bmad-agile-workflow

Complete BMAD methodology with 6 specialized agents

Commands:

• /bmad-pilot - Full agile workflow orchestration

Agents:

• bmad-po - Product Owner (Sarah)
• bmad-architect - System Architect (Winston)
• bmad-sm - Scrum Master (Mike)
• bmad-dev - Developer (Alex)
• bmad-review - Code Reviewer
• bmad-qa - QA Engineer (Emma)
• bmad-orchestrator - Main orchestrator

Use for: Enterprise projects, complex features, full agile process

2. requirements-driven-workflow

Streamlined requirements-to-code workflow

Commands:

• /requirements-pilot - Requirements-driven development flow

Agents:

• requirements-generate - Requirements generation
• requirements-code - Code implementation
• requirements-review - Code review
• requirements-testing - Testing strategy

Use for: Quick prototyping, simple features, rapid development

3. development-essentials

Core development slash commands

Commands:

• /code - Direct implementation
• /debug - Systematic debugging
• /test - Testing strategy
• /optimize - Performance tuning
• /bugfix - Bug resolution
• /refactor - Code improvement
• /review - Code validation
• /ask - Technical consultation
• /docs - Documentation
• /think - Advanced analysis

Agents:

• code - Code implementation
• bugfix - Bug fixing
• debug - Debugging
• develop - General development

Use for: Daily coding tasks, quick implementations

4. advanced-ai-agents

GPT-5 deep reasoning integration

Commands: None (agent-only)

Agents:

• gpt5 - Deep reasoning and analysis

Use for: Complex architectural decisions, strategic planning

🚀 Installation Methods

Method 1: Plugin Commands (Recommended)

# List all available plugins
/plugin list

# Get detailed information about a plugin
/plugin info bmad-agile-workflow

# Install a specific plugin
/plugin install bmad-agile-workflow

# Install all plugins
/plugin install bmad-agile-workflow
/plugin install requirements-driven-workflow
/plugin install development-essentials
/plugin install advanced-ai-agents

# Remove an installed plugin
/plugin remove development-essentials

Method 2: Repository Reference

# Install from GitHub repository
/plugin marketplace add cexll/myclaude

This will present all available plugins from the repository.

Method 3: Make Commands

For traditional installation or selective deployment:

# Install everything
make install

# Deploy specific workflows
make deploy-bmad          # BMAD workflow only
make deploy-requirements  # Requirements workflow only
make deploy-commands      # All slash commands
make deploy-agents       # All agents

# Deploy everything
make deploy-all

# View all options
make help

Method 4: Manual Installation

Copy files to Claude Code configuration directories:

Commands:

cp bmad-agile-workflow/commands/*.md ~/.config/claude/commands/
cp requirements-driven-workflow/commands/*.md ~/.config/claude/commands/
cp development-essentials/commands/*.md ~/.config/claude/commands/

Agents:

cp bmad-agile-workflow/agents/*.md ~/.config/claude/agents/
cp requirements-driven-workflow/agents/*.md ~/.config/claude/agents/
cp development-essentials/agents/*.md ~/.config/claude/agents/
cp advanced-ai-agents/agents/*.md ~/.config/claude/agents/

Output Styles (optional):

cp output-styles/*.md ~/.config/claude/output-styles/

📋 Plugin Configuration

Plugins are defined in .claude-plugin/marketplace.json following the Claude Code plugin specification.

Plugin Metadata Structure

{
  "name": "plugin-name",
  "displayName": "Human Readable Name",
  "description": "Plugin description",
  "version": "1.0.0",
  "author": "Author Name",
  "category": "workflow|development|analysis",
  "keywords": ["keyword1", "keyword2"],
  "commands": ["command1", "command2"],
  "agents": ["agent1", "agent2"]
}

🔧 Plugin Management

Check Installed Plugins

/plugin list

Shows all installed plugins with their status.

Plugin Information

/plugin info <plugin-name>

Displays detailed information:

• Description
• Version
• Commands provided
• Agents included
• Author and keywords

Update Plugins

Plugins are updated when you pull the latest repository changes:

git pull origin main
make install

Uninstall Plugins

/plugin remove <plugin-name>

Or manually remove files:

# Remove commands
rm ~/.config/claude/commands/<command-name>.md

# Remove agents
rm ~/.config/claude/agents/<agent-name>.md

🎯 Plugin Selection Guide

Install Everything (Recommended for New Users)

make install

Provides complete functionality with all workflows and commands.

Selective Installation

For Agile Teams:

/plugin install bmad-agile-workflow

For Rapid Development:

/plugin install requirements-driven-workflow
/plugin install development-essentials

For Individual Developers:

/plugin install development-essentials
/plugin install advanced-ai-agents

For Code Quality Focus:

/plugin install development-essentials  # Includes /review
/plugin install bmad-agile-workflow     # Includes bmad-review

📁 Directory Structure

myclaude/
├── .claude-plugin/
│   └── marketplace.json          # Plugin registry
├── bmad-agile-workflow/
│   ├── commands/
│   │   └── bmad-pilot.md
│   └── agents/
│       ├── bmad-po.md
│       ├── bmad-architect.md
│       ├── bmad-sm.md
│       ├── bmad-dev.md
│       ├── bmad-review.md
│       ├── bmad-qa.md
│       └── bmad-orchestrator.md
├── requirements-driven-workflow/
│   ├── commands/
│   │   └── requirements-pilot.md
│   └── agents/
│       ├── requirements-generate.md
│       ├── requirements-code.md
│       ├── requirements-review.md
│       └── requirements-testing.md
├── development-essentials/
│   ├── commands/
│   │   ├── code.md
│   │   ├── debug.md
│   │   ├── test.md
│   │   └── ... (more commands)
│   └── agents/
│       ├── code.md
│       ├── bugfix.md
│       ├── debug.md
│       └── develop.md
├── advanced-ai-agents/
│   └── agents/
│       └── gpt5.md
└── output-styles/
    └── bmad-phase-context.md

🔄 Plugin Dependencies

No Dependencies: All plugins work independently

Complementary Combinations:

• BMAD + Advanced Agents (enhanced reviews)
• Requirements + Development Essentials (complete toolkit)
• All four plugins (full suite)

🛠️ Makefile Reference

# Installation
make install              # Install all plugins
make deploy-all          # Deploy all configurations

# Selective Deployment
make deploy-bmad         # BMAD workflow only
make deploy-requirements # Requirements workflow only
make deploy-commands     # All slash commands only
make deploy-agents       # All agents only

# Testing
make test-bmad          # Test BMAD workflow
make test-requirements  # Test Requirements workflow

# Cleanup
make clean              # Remove generated artifacts
make help               # Show all available commands

📚 Related Documentation

• BMAD Workflow - Complete BMAD guide
• Requirements Workflow - Lightweight workflow guide
• Development Commands - Command reference
• Quick Start Guide - Get started quickly

🔗 External Resources

• Claude Code Plugin Docs - Official plugin documentation
• Claude Code CLI - Claude Code interface

---

Modular Installation - Install only what you need, when you need it.