orchestration

🎭 Orchestration Plugin for Claude Code

Like N8N in Claude Code

If you like the project, consider ⭐ it!

Multi-agent workflow orchestration. Chain AI agents to automate complex tasks using natural language or declarative syntax.

---

Installation

1. Add Plugin Marketplace

First, add the orchestration marketplace to your Claude Code:

/plugin marketplace add mbruhler/claude-orchestration

2. Install the Plugin

/plugin install orchestration@mbruhler

Or use the interactive menu:

/plugin

Then select "Browse Plugins" → find orchestration → Install

3. Verify Installation

Check that the plugin is installed:

/help

You should see orchestration commands like /orchestration:menu, /orchestration:init, etc.

---

Quick Start

Новичкам: если нужен максимально простой гайд без погружения в код, посмотрите "Простое руководство по плагину оркестрации".

0. Import Your Custom Agents (Optional)

/orchestration:init

Import your custom agents from ~/.claude/agents/ into the orchestration plugin.

Example:

/orchestration:init
→ Select agents to import
→ Agents become available as expert-code-implementer, etc. and the plugin can create workflows using them

1. Natural Language

"Create a workflow that fetches 10 Reddit posts about startups,
analyzes competition, and shows a ratings table"

The plugin:

• ✅ Creates necessary temp scripts (Python/Node.js)
• ✅ Guides you through clickable questions
• ✅ Generates and executes optimized workflow
• ✅ Returns formatted results

2. Direct Syntax

# Parallel bug investigation
[
  Explore:"Find related code":code ||
  general-purpose:"Check recent changes":changes ||
  general-purpose:"Search similar issues":similar
] ->
general-purpose:"Identify root cause from {code}, {changes}, {similar}":analysis ->
@review:"Approve fix?" ->
general-purpose:"Implement fix and run tests":fix ->
general-purpose:"Commit changes with detailed message"

3. Templates

"Use the TDD implementation template"

---

Core Features

Flow Control

# Sequential
step1 -> step2 -> step3

# Parallel
[task1 || task2 || task3]

# Conditional
test -> (if passed)~> deploy
     -> (if failed)~> rollback

Auto Temp Scripts

Automatically creates Python/Node.js scripts for:

• 🌐 Web scraping (BeautifulSoup, Selenium)
• 📡 APIs (Reddit, Twitter, GitHub)
• 📊 Data processing (pandas, NumPy)
• 🗄️ Database queries

Manual Checkpoints

build:"Compile app" ->
@review:"Check output. Continue?" ->
deploy:"Deploy to production"

Visual Progress

╔════════════════════════════════════╗
║  TDD Implementation                ║
╠════════════════════════════════════╣
║    [Write Test] ●                  ║
║         │                          ║
║    [Implement] ○                   ║
║         │                          ║
║    [@Review] ○                     ║
╠════════════════════════════════════╣
║ Status: Writing test...            ║
╚════════════════════════════════════╝

---

Syntax Reference

Syntax	Meaning	Example
->	Sequential	step1 -> step2
`		`
~>	Conditional	(if passed)~> next
@label	Checkpoint	@review-code
:var	Capture output	analyze:"task":result
{var}	Use variable	"Process {result}"
$agent	Temp agent	$scanner:"Scan"

---

Built-in Agents

• Explore - Fast codebase exploration and search
• Plan - Planning and breaking down tasks
• general-purpose - Versatile agent for complex multi-step tasks

---

Examples

Reddit Startup Analyzer

general-purpose:"Create Python PRAW script to fetch 10 r/startups posts.
                 Return JSON with title, url, description":posts ->

[
  general-purpose:"Research competition for post {posts[0]}":a1 ||
  general-purpose:"Research competition for post {posts[1]}":a2 ||
  # ... parallel analyses
] ->

general-purpose:"Rate ideas (1-10) on competition, market, feasibility.
                 Create markdown table":ratings ->

@review:"Review {ratings}. Ban any?" ->

general-purpose:"Generate top 3 opportunities summary"

TDD Implementation

# RED: Write failing test
general-purpose:"Write failing test for the feature":test ->
general-purpose:"Run test suite - verify it fails":red_result ->
@review-coverage:"Test coverage sufficient?" ->

# GREEN: Minimal implementation
general-purpose:"Write minimal code to pass the test":impl ->
general-purpose:"Run test suite - verify it passes":green_result ->
@review:"Code quality OK?" ->