wrangler

Wrangler — Claude Code Plugin

English | 한국어

---

English

A Claude Code plugin that designs custom multi-agent harnesses tailored to each project. Not a fixed template — Wrangler analyzes your project's specific failures and proposes the right agent architecture (or recommends no harness at all).

Commands

Command	Description
/wrangler:design	Interactive harness design wizard — analyzes failures, picks a pattern, generates agent configs
/wrangler:run <agent>	Invoke a specific agent from your harness (e.g., /wrangler:run planner)
/wrangler:list	Show all agents in your harness with roles, models, and workflow

Quick Start

/wrangler:design          # Design your harness (first time)
/wrangler:list            # See what agents were created
/wrangler:run planner     # Run the planner agent
/wrangler:run generator   # Run the generator agent
/wrangler:run evaluator   # Run the evaluator agent

What It Does

Wrangler is a harness architect. The /wrangler:design wizard walks you through:

1. Project analysis — Understands what you're building (one question at a time)
2. Failure diagnosis — Classifies observed single-agent failures (direction / execution / quality / context)
3. Custom harness design — Proposes the minimal agent combination that fixes YOUR failures
4. Config generation — Creates .wrangler/harness.json + agent system prompts

Then use /wrangler:run <agent> to invoke each agent with its tailored system prompt.

Not Every Project Needs a Harness

Wrangler may recommend no harness at all if a single agent is sufficient.

Project	Recommended Architecture
Complex full-stack app	Planner → Generator → Evaluator
Design / creative task	Generator → Critic
Data migration	Validator → Transformer → Validator
Parallelizable workload	Decomposer → Workers → Assembler
Long task, no quality issues	Single agent + context reset
Simple feature	No harness needed

Installation

Via Marketplace (recommended)

# In Claude Code:
/marketplace add panicgit/wrangler
/plugin install wrangler

Manual Installation

# 1. Clone the repository
git clone https://github.com/panicgit/wrangler.git

# 2. Create the plugin directory
mkdir -p ~/.claude/plugins/cache/panicdev/wrangler/1.0.1

# 3. Copy contents (not the directory itself)
cp -r wrangler/* ~/.claude/plugins/cache/panicdev/wrangler/1.0.1/
cp -r wrangler/.claude-plugin ~/.claude/plugins/cache/panicdev/wrangler/1.0.1/

# 4. Install dependencies
cd ~/.claude/plugins/cache/panicdev/wrangler/1.0.1
npm install

# 5. Restart Claude Code

Update & Version Check

/plugin update wrangler    # Update to latest
/plugin list                        # Check installed version

Generated Files

After running /wrangler:design, all harness files are stored in .wrangler/ at your project root:

.wrangler/
├── harness.json                               ← Harness config (agents, workflow, loops)
├── progress.md                                ← Global progress (all agents read/write)
├── agents/
│   ├── planner.md                             ← Planner system prompt
│   ├── generator.md                           ← Generator system prompt
│   └── evaluator.md                           ← Evaluator system prompt
├── sprint-1/
│   ├── planner-to-generator--contract.md      ← Sprint scope + completion criteria
│   ├── evaluator-to-generator--feedback-01.md ← 1st evaluation
│   └── generator-to-next--handoff.md          ← Handoff when sprint ends
└── sprint-2/
    └── ...

Plugin Structure