harness

Harness

Agent Team & Skill Architect — A Claude Code Plugin

한국어

A meta-skill that designs domain-specific agent teams, defines specialized agents, and generates the skills they use.

Overview

Harness leverages Claude Code's agent team system to decompose complex tasks into coordinated teams of specialized agents. Say "build a harness for this project" and it automatically generates agent definitions (.claude/agents/) and skills (.claude/skills/) tailored to your domain.

Key Features

• Agent Team Design — 6 architectural patterns: Pipeline, Fan-out/Fan-in, Expert Pool, Producer-Reviewer, Supervisor, and Hierarchical Delegation
• Skill Generation — Auto-generates skills with Progressive Disclosure for efficient context management
• Orchestration — Inter-agent data passing, error handling, and team coordination protocols
• Validation — Trigger verification, dry-run testing, and with-skill vs without-skill comparison tests

Workflow

Phase 1: Domain Analysis
    ↓
Phase 2: Team Architecture Design (Agent Teams vs Subagents)
    ↓
Phase 3: Agent Definition Generation (.claude/agents/)
    ↓
Phase 4: Skill Generation (.claude/skills/)
    ↓
Phase 5: Integration & Orchestration
    ↓
Phase 6: Validation & Testing

Installation

Via Marketplace

Add the marketplace

/plugin marketplace add revfactory/harness

Install the plugin

/plugin install harness@harness

Direct Installation as Global Skill

# Copy the skills directory to ~/.claude/skills/harness/
cp -r skills/harness ~/.claude/skills/harness

Plugin Structure

harness/
├── .claude-plugin/
│   └── plugin.json                 # Plugin manifest
├── skills/
│   └── harness/
│       ├── SKILL.md                # Main skill definition (6-Phase workflow)
│       └── references/
│           ├── agent-design-patterns.md   # 6 architectural patterns
│           ├── orchestrator-template.md   # Team/subagent orchestrator templates
│           ├── team-examples.md           # 5 real-world team configurations
│           ├── skill-writing-guide.md     # Skill authoring guide
│           ├── skill-testing-guide.md     # Testing & evaluation methodology
│           └── qa-agent-guide.md          # QA agent integration guide
└── README.md

Usage

Trigger in Claude Code with prompts like:

Build a harness for this project
Design an agent team for this domain
Set up a harness

Execution Modes

Mode	Description	Recommended For
Agent Teams (default)	TeamCreate + SendMessage + TaskCreate	2+ agents requiring collaboration
Subagents	Direct Agent tool invocation	One-off tasks, no inter-agent communication needed

Architecture Patterns

Pattern	Description
Pipeline	Sequential dependent tasks
Fan-out/Fan-in	Parallel independent tasks
Expert Pool	Context-dependent selective invocation
Producer-Reviewer	Generation followed by quality review
Supervisor	Central agent with dynamic task distribution
Hierarchical Delegation	Top-down recursive delegation

Output

Files generated by Harness:

your-project/
├── .claude/
│   ├── agents/          # Agent definition files
│   │   ├── analyst.md
│   │   ├── builder.md
│   │   └── qa.md
│   └── skills/          # Skill files
│       ├── analyze/
│       │   └── skill.md
│       └── build/
│           ├── skill.md
│           └── references/

Use Cases — Try These Prompts

Copy any prompt below into Claude Code after installing Harness:

Deep Research

Build a harness for deep research. I need an agent team that can investigate
any topic from multiple angles — web search, academic sources, community
sentiment — then cross-validate findings and produce a comprehensive report.