harness

15초 모션 릴 · 전체 2분 인터랙티브 워크스루 보기 (한국어) →

Harness v2 — Claude Code를 위한 팀 아키텍처 팩토리
English | 한국어

Harness는 Claude Code를 위한 팀 아키텍처 팩토리입니다. "build a harness for this project" · "하네스 구성해줘" 한 문장이면, 플러그인이 도메인 설명을 에이전트 팀과 그들이 사용하는 스킬로 바꿔줍니다.

v2의 새로운 점
v2는 현재 Claude Code 멀티 에이전트 런타임을 위해 처음부터 다시 구축한 버전입니다:

세 가지 네이티브 실행 모드. v1은 더 이상 존재하지 않는 실험적 TeamCreate API 위에 구축된 두 가지 모드만 알고 있었습니다. v2는 오늘날 실제로 제공되는 것을 대상으로 합니다:

Workflow 오케스트레이션 — 팬아웃, 검증 루프, 대규모 실행을 위한 결정론적 스크립트 ( pipeline() / parallel() / schemas / budgets)
지속적 에이전트 협업 — 명명된 에이전트 + SendMessage + 공유 작업 목록, 턴 간 컨텍스트 유지
서브 에이전트 위임 — 가벼운 원샷 병렬 디스패치

워크플로 네이티브 품질 패턴. 적대적 검증, 심사 패널, loop-until-dry, 멀티모달 스윕, 완전성 비평가 — 생성된 하네스가 그럴듯하지만 틀린 출력을 걸러내도록 코드화했습니다.
실험적 플래그 없음. CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 의존성이 완전히 사라졌습니다.
합리적인 모델 정책. v1은 모든 에이전트를 model: "opus" 로 고정했습니다. v2는 작업의 복잡도, 기간, 자율성, 지연 요구에 따라 에이전트별로 티어 — fable / opus / sonnet — 를 선택하며, 근거 없는 일괄 고정을 금지합니다.
/harness:evolve 실제 제공. v1이 문서로만 남겼던 진화 메커니즘이 이제 실제 스킬입니다: 초기 하네스와 현재 하네스 사이의 델타를 포착하고, 피드백을 일반화하여 에이전트/스킬/오케스트레이터에 다시 반영합니다.
v1 마이그레이션 내장. 팩토리가 v1 아티팩트 ( TeamCreate , TeamDelete , 실험적 플래그)를 감지하고 기계적 마이그레이션 경로를 제공합니다.

핵심 기능

에이전트 팀 설계 — 여섯 가지 아키텍처 패턴 (Pipeline, Fan-out/Fan-in, Expert Pool, Producer-Reviewer, Supervisor, Hierarchical Delegation), 각각 최적의 v2 실행 모드에 매핑
스킬 생성 — Progressive Disclosure를 통한 컨텍스트 효율적 스킬
오케스트레이션 — 데이터 전달 프로토콜 (구조화 스키마, 파일, 메시지, 작업), 오류 처리, 재개 지원
검증 — 트리거 평가, 드라이런, 스킬 사용 vs. 미사용 A/B 테스트 (선택적으로 워크플로 자체로 수행)
진화 — /harness:evolve 가 사용 피드백을 측정 가능한 차세대 개선으로 전환

워크플로
Phase 0: 기존 하네스 감사 (신규 / 확장 / 유지 — v1 아티팩트는 여기서 감지)
Phase 1: 도메인 분석 (작업의 제어 흐름 형태 포함)
Phase 2: 실행 모드 및 팀 아키텍처 설계
Phase 3: 에이전트 정의 (.claude/agents/)
Phase 4: 스킬 생성 (.claude/skills/)
Phase 5: 오케스트레이션 및 CLAUDE.md 포인터
Phase 6: 검증 및 테스트
Phase 7: 유지보수 — /harness:evolve 를 통한 진화

설치
마켓플레이스 경유
/plugin marketplace add revfactory/harness
/plugin install harness@harness-marketplace
글로벌 스킬로
cp -r skills/harness ~ /.claude/skills/harness
cp -r skills/evolve ~ /.claude/skills/harness-evolve
환경 변수나 실험적 플래그가 필요하지 않습니다.

사용법
하네스 구성해줘
build a harness for this project
design an agent team for <domain>

생성된 하네스를 사용한 후:

하네스 회고해줘 / evolve the harness with this feedback

실행 모드 선택

모드
프리미티브
사용 시점

Workflow 오케스트레이션
Workflow 스크립트
제어 흐름이 결정론적일 때: 열거 가능한 팬아웃, 검증 루프, 대규모, 구조화된 출력

지속적 에이전트
Agent(name:) + SendMessage + tasks
컨텍스트를 유지하는 장기 전문가; 반복적 피드백과 협상

서브 에이전트 위임
원샷 Agent 호출
발사 후 망각형 병렬 작업; 결과만 필요할 때

팩토리는 팀 규모가 아니라 제어 흐름의 형태 로 모드를 선택하며, 더 적합할 경우 단계별로 모드를 혼합합니다.

생성되는 아티팩트
your-project/
├── .claude/
│ ├── agents/ # 에이전트 정의 (누가)
│ │ ├── analyst.md
│ │ ├── builder.md
│ │ └── qa.md
│ └── skills/ # 스킬 (어떻게) + 오케스트레이터 하나 (누가-언제-어떤 순서로)
│ ├── analyze/SKILL.md
│ └── build/SKILL.md
└── CLAUDE.md # 최소 포인터: 트리거 규칙 + 변경 이력

v1에서 마이그레이션
docs/migration-v1-to-v2.md 를 참고하세요. 요약: TeamCreate / TeamDelete /broadcast/플래그 참조를 제거하고, 팬아웃을 Workflow 스크립트로 변환하고, 나머지 협업을 명명된 에이전트 + SendMessage 로 재작성하고, 일괄 model: "opus" 고정을 제거합니다. 팩토리는 v1 아티팩트를 감지하면 이를 자동화합니다 (Phase 0).

이전 결과 (v1)
15개의 소프트웨어 엔지니어링 작업에 대한 통제된 A/B 실험으로, 구조화된 사전 구성이 LLM 코드 에이전트 출력 품질에 미치는 영향을 측정했습니다: 평균 품질 49.5 → 79.3 (+60%), 15/15 승률, 출력 분산 −32% (n=15, 저자 수행, revfactory/claude-code-harness 참고). 이는 저자가 측정한 수치로 간주하시고, 도입 결정을 위해서는 자체 파일럿을 실행하세요.

라이선스
Apache 2.0