revfactory/harness

Harness는 Claude Code를 위한 팀 아키텍처 팩토리입니다. 'build a harness for this project'(영어) 또는 '하네스 구성해줘'(한국어) 또는 'ハーネスを構成して'(일본어)와 같이 요청하면, 플러그인이 사용자의 도메인 설명을 에이전트 팀과 그들이 사용하는 스킬로 변환합니다. 이 스킬들은 6가지 사전 정의된 팀 아키텍처 패턴 중에서 선택됩니다.

Harness는 Claude Code의 에이전트 팀 시스템을 활용하여 복잡한 작업을 전문화된 에이전트들의 협력적인 팀으로 분해합니다. 'Say "build a harness for this project"'라고 말하면, 사용자의 도메인에 맞춰진 에이전트 정의(.claude/agents/)와 스킬(.claude/skills/)을 자동으로 생성합니다.

Harness는 Claude Code 생태계의 L3 Meta-Factory 계층에 존재하며, 이 계층은 그 자체가 하나의 하네스가 되기보다는 다른 하네스들을 생성하는 역할을 합니다. L3 내부에서 우리는 특정 서브 계층인 Team-Architecture Factory를 선택합니다.

Layer	역할	공존하는 인접 요소
L3 — Meta-Factory / Team-Architecture Factory (저희)	도메인 문장 → 6가지 사전 정의된 팀 패턴을 통해 에이전트 팀 + 스킬 생성	—
L3 — Meta-Factory / Runtime-Configuration Factory	결정론적이고 반복 가능한 런타임 구성	coleam00/Archon
L3 — Meta-Factory / Codex Runtime Port	동일한 개념, Codex 런타임	SaehwanPark/meta-harness
L2 — Cross-Harness Workflow	여러 하네스에 걸쳐 스킬/규칙/훅 표준화	affaan-m/ECC

Archon은 결정론적 런타임 구성을 생성합니다. Harness는 에이전트가 사용하는 스킬과 함께 팀 아키텍처(파이프라인, 팬-아웃/팬-인, 전문가 풀, 프로듀서-리뷰어, 슈퍼바이저, 계층적 위임)를 생성합니다. 같은 L3의 다른 서브 계층들입니다. 런타임 결정론성이 필요하면 Archon을, 팀 아키텍처가 필요하면 Harness를 선택하거나, 둘을 결합하여 사용할 수 있습니다.

에이전트 팀 설계 (Agent Team Design)— 6가지 아키텍처 패턴: 파이프라인 (Pipeline), 팬아웃/팬인 (Fan-out/Fan-in), 전문가 풀 (Expert Pool), 생산자-검토자 (Producer-Reviewer), 감독자 (Supervisor), 계층적 위임 (Hierarchical Delegation)

기술 생성 (Skill Generation)— 효율적인 컨텍스트 관리를 위해 점진적 공개 (Progressive Disclosure) 방식을 사용하여 기술을 자동 생성

오케스트레이션 (Orchestration)— 에이전트 간 데이터 전달, 에러 처리 및 팀 조정 프로토콜

검증 (Validation)— 트리거 검증, 드라이 런 (dry-run) 테스트, 기술 사용 시와 미사용 시의 비교 테스트

1단계: 도메인 분석 (Domain Analysis)
↓
2단계: 팀 아키텍처 설계 (에이전트 팀 vs 하위 에이전트)
...

/plugin marketplace add revfactory/harness

/plugin install harness@harness-marketplace

# skills 디렉토리를 ~/.claude/skills/harness/로 복사합니다.
cp -r skills/harness ~/.claude/skills/harness

harness/
├── .claude-plugin/
│ └── plugin.json # 플러그인 매니페스트 (Plugin manifest)
...

Claude Code에서 다음과 같은 프롬프트로 트리거할 수 있습니다:

Build a harness for this project
(이 프로젝트를 위한 harness를 구축해줘)
Design an agent team for this domain
(이 도메인을 위한 에이전트 팀을 설계해줘)
Set up a harness
(harness를 설정해줘)

모드 (Mode)	설명 (Description)	권장 사항 (Recommended For)
에이전트 팀 (Agent Teams, 기본값)	TeamCreate + SendMessage + TaskCreate	협업이 필요한 2개 이상의 에이전트
하위 에이전트 (Subagents)	에이전트 도구 직접 호출 (Direct Agent tool invocation)	일회성 작업, 에이전트 간 통신이 필요 없는 경우

패턴 (Pattern)	설명 (Description)
파이프라인 (Pipeline)	순차적인 의존적 작업
...

Harness에 의해 생성된 파일:

your-project/
├── .claude/
│ ├── agents/ # 에이전트 정의 파일
...

Harness를 설치한 후 Claude Code에 아래의 프롬프트 중 아무거나 복사하여 사용하세요:

심층 조사 (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.
(심층 조사를 위한 harness를 구축해줘. 웹 검색, 학술 자료, 커뮤니티 여론 등 다양한 각도에서 어떤 주제든 조사하고, 발견된 내용을 교차 검증하여 종합적인 보고서를 작성할 수 있는 에이전트 팀이 필요해.)

웹사이트 개발 (Website Development)

Build a harness for full-stack website development. The team should handle
design, frontend (React/Next.js), backend (API), and QA testing in a
coordinated pipeline from wireframe to deployment.
(풀스택 웹사이트 개발을 위한 harness를 구축해줘. 팀은 와이어프레임부터 배포까지 조정된 파이프라인 내에서 디자인, 프론트엔드 (React/Next.js), 백엔드 (API), QA 테스트를 처리해야 해.)

웹툰 / 만화 제작 (Webtoon / Comic Production)

웹툰 / 만화 제작 (Webtoon / Comic Production)

웹툰 에피소드 제작을 위한 하네스 (harness)를 구축하세요. 스토리 작법, 캐릭터 디자인 프롬프트 (prompts), 칸 레이아웃 (panel layout) 계획, 그리고 대사 편집을 담당할 에이전트 (agents)가 필요합니다. 이들은 스타일 일관성을 위해 서로의 작업물을 검토해야 합니다.

YouTube 콘텐츠 기획 (YouTube Content Planning)

YouTube 콘텐츠 제작을 위한 하네스 (harness)를 구축하세요. 팀은 트렌딩 토픽 (trending topics)을 조사하고, 스크립트 (scripts)를 작성하며, SEO를 위한 제목/태그를 최적화하고, 썸네일 (thumbnail) 컨셉을 기획해야 합니다. 이 모든 과정은 관리자 에이전트 (supervisor agent)에 의해 조정됩니다.

코드 리뷰 및 리팩터링 (Code Review & Refactoring)

포괄적인 코드 리뷰를 위한 하네스 (harness)를 구축하세요. 아키텍처 (architecture), 보안 취약점 (security vulnerabilities), 성능 병목 현상 (performance bottlenecks), 그리고 코드 스타일 (code style)을 점검하는 병렬 에이전트 (parallel agents)를 구성한 뒤, 모든 결과물을 하나의 보고서로 통합하고자 합니다.

기술 문서화 (Technical Documentation)

이 코드베이스 (codebase)로부터 API 문서 (API documentation)를 생성하는 하네스 (harness)를 구축하세요. 에이전트 (agents)는 엔드포인트 (endpoints)를 분석하고, 설명을 작성하며, 사용 예시 (usage examples)를 생성하고, 완전성을 검토해야 합니다.

데이터 파이프라인 설계 (Data Pipeline Design)

데이터 파이프라인 (data pipelines) 설계를 위한 하네스 (harness)를 구축하세요. 스키마 (schema) 설계, ETL 로직, 데이터 검증 규칙 (data validation rules), 그리고 모니터링 설정 (monitoring setup)을 담당하며 하위 작업 (sub-tasks)을 계층적으로 위임하는 에이전트 (agents)가 필요합니다.

마케팅 캠페인 (Marketing Campaign)

마케팅 캠페인 생성을 위한 하네스 (harness)를 구축하세요. 팀은 타겟 시장 (target market)을 조사하고, 광고 카피 (ad copy)를 작성하며, 비주얼 컨셉 (visual concepts)을 디자인하고, 반복적인 품질 검토 (quality review)를 포함한 A/B 테스트 계획을 수립해야 합니다.

Harness는 Claude Code / 에이전트 프레임워크 (agent-framework) 생태계에서 유일한 존재가 아닙니다. 다음 리포지토리 (repos)들은 인접한 레이어 (layers)에 존재합니다. 각 리포지토리는 귀하의 필요에 맞는 것을 선택하거나 여러 개를 결합할 수 있도록 "X는 ..., Harness는 ..."라는 병렬 형식으로 설명되어 있습니다.

저장소 (Repo)	그들의 위치	Harness와의 관계
coleam00/Archon	"harness builder" — 결정론적이고(deterministic) 반복 가능한 런타임 설정 (runtime configurations)	동일한 L3 계층의 인접 서브 레이어(sub-layer). Archon은 런타임 설정 팩토리(Runtime-Configuration Factory)이며, Harness는 팀 아키텍처 팩토리(Team-Architecture Factory)입니다. 런타임의 결정론적 특성이 필요하면 Archon을, 팀 아키텍처가 필요하면 Harness를 선택하거나 두 가지를 결합하여 사용하십시오.
...

revfactory/harness-100 — 10개 도메인에 걸쳐 준비된 100개의 프로덕션 준비 완료(production-ready) 에이전트 팀 하네스(harness)로, 영어와 한국어 모두 제공됩니다 (총 200개 패키지). 각 하네스는 이 플러그인에 의해 생성된 4~5개의 전문가 에이전트(specialist agents), 오케스트레이터 기술(orchestrator skill), 그리고 도메인 특화 기술(domain-specific skills)을 포함합니다. 콘텐츠 제작, 소프트웨어 개발, 데이터/AI, 비즈니스 전략, 교육, 법률, 건강 등을 다루는 1,808개의 마크다운(markdown) 파일이 포함되어 있습니다.

revfactory/claude-code-harness — 구조화된 사전 설정(structured pre-configuration)이 LLM 코드 에이전트의 출력 품질에 미치는 영향을 측정하기 위해 15개의 소프트웨어 엔지니어링 작업을 대상으로 수행된 통제 실험(controlled experiment)입니다.

지표 (Metric)	Harness 미사용 시	Harness 사용 시	개선 사항
평균 품질 점수 (Average Quality Score)	49.5	79.3	+60%
...

핵심 결과: 효과는 작업 복잡도에 따라 확장됩니다 — 작업이 어려울수록 개선 폭이 더 커집니다 (+23.8 기초(Basic), +29.6 고급(Advanced), +36.2 전문가(Expert)).

모든 곳에서 사용해야 할 정확한 문구: 평균 품질 +60% (49.5 → 79.3), 승률 15/15, 분산(variance) −32% (n=15, 저자 측정 A/B 테스트, 제3자 재현 실험 대기 중).

전체 논문:

Hwang, M. (2026). Harness: Structured Pre-Configuration for Enhancing LLM Code Agent Output Quality.

• 활성화된 에이전트 팀:
  CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Q1. "+60%"라는 수치가 과장된 것 아닌가요?

A. +60%라는 수치는 저자가 측정한 A/B 테스트(n=15, 15개 작업, 자매 저장소인 claude-code-harness에서 측정) 결과에서 도출되었습니다. 이 저장소의 모든 인용문은 해당 수치와 함께 동일한 문장 내에 "n=15, 저자 측정, 제3자 재현 실험 대기 중"이라는 공개 정보를 병기합니다. 도입 결정을 내릴 때는 2~4주간의 내부 파일럿(pilot)을 실행하여 귀하만의 수치를 직접 측정해 보실 것을 권장합니다.

근거 (Evidence):

• 저자 A/B: revfactory/claude-code-harness
• 논문:
  Hwang, M. (2026). Harness: Structured Pre-Configuration for Enhancing LLM Code Agent Output Quality

Q2. 왜 "harness builder"가 아니라 "harness factory"인가요? Archon과 경쟁하는 것 아닌가요?

A. Archon은 결정론적 런타임 설정 (deterministic runtime configurations)을 생성합니다. 즉, **런타임 설정 팩토리 (Runtime-Configuration Factory)**입니다. Harness는 에이전트 팀 아키텍처 (팀 구조, 메시지 프로토콜, 리뷰 게이트)를 생성합니다. 즉, **팀 아키텍처 팩토리 (Team-Architecture Factory)**입니다. 이들은 **동일한 L3 메타 팩토리 (Meta-Factory)의 인접한 하위 계층 (neighbor sub-layers)**이며 서로 다른 요구사항을 충족합니다. 런타임의 결정론적 특성이 필요하다면 Archon을, 팀 아키텍처 패턴이 필요하다면 Harness를 선택하거나, 두 가지를 결합하십시오 (Harness로 아키텍처를 설계하고 → Archon으로 런타임을 배포).

근거 (Evidence):

• Archon 자기 정의: clawfit docs/reference-levels.md
• 하위 계층 선언: 상단의 Category — Where Harness Sits 섹션 참조 - Archon 리포지토리: github.com/coleam00/Archon

Q3. "Claude Code 전용"은 너무 좁은 범위 아닌가요? Gemini나 Codex는 어떻게 되나요?

A. 현재 공식 런타임은 Claude Code 전용입니다. 동일한 개념의 Codex 포팅 버전인 SaehwanPark/meta-harness가 이미 공개되어 있으므로, Codex 팀은 거기서부터 시작할 수 있습니다. Harness는 "다중 런타임, 얕은 통합 (multi-runtime, shallow)" 대신 "Claude-Code-네이티브, 깊은 통합 (Claude-Code-native, deep)"을 선택했습니다. 형제 리포지토리들(meta-harness, harness-init, OpenRig)과의 교차 런타임 (cross-runtime) 협업은 로드맵에 포함되어 있습니다.

근거 (Evidence):

• Codex 포팅: github.com/SaehwanPark/meta-harness
• 교차 런타임 스캐폴더 (Cross-runtime scaffolder): github.com/Gizele1/harness-init

Apache 2.0