Claude Code Harness 플러그인 — 한 문장으로 에이전트 팀을 자동 생성한다

Claude Code Harness 플러그인 상세 정보 — 한 문장으로 에이전트 팀을 자동 생성한다

📌 이 글의 핵심 요약

• Harness는 한 문장 프롬프트로 전문 에이전트 팀을 자동 생성하는 Claude Code 플러그인
• 6가지 팀 아키텍처 패턴 중 도메인에 맞는 구조를 자동 선택
• 에이전트 정의, 스킬 파일, 오케스트레이터까지 한 번에 생성
• A/B 테스트에서 품질 점수 평균 60% 향상, 15전 15승 기록

📋 목차

1. Harness 플러그인이란
2. 설치 방법
3. 6가지 팀 아키텍처 패턴
4. 핵심 기능 상세
5. 실전 활용 분야
6. Harness 100 — 바로 쓸 수 있는 하네스 컬렉션
7. 정리 및 결론

Claude Code로 멀티 에이전트 작업을 시작하면 에이전트 역할 파일, 스킬, 오케스트레이터까지 직접 설계해야 한다. 생각보다 시간이 걸리는 작업이다. Harness는 이 과정을 한 문장으로 압축해주는 플러그인이다. "하네스 구성해줘"라고 입력하면 도메인에 맞는 에이전트 팀 전체가 자동으로 생성된다.

---

Harness 플러그인이란

Harness는 Claude Code용 팀 아키텍처 팩토리 플러그인이다. 복잡한 작업을 전문 에이전트 팀으로 분해하고 조율하는 구조 전체를 자동으로 설계해준다. 단순히 프롬프트를 개선하는 도구가 아니라, Claude Code의 에이전트 팀 시스템 위에서 동작하는 메타 레이어다.

Claude Code 생태계에는 세 개의 층이 있다. 개별 작업을 처리하는 에이전트·스킬, 이를 조율하는 오케스트레이터, 그리고 팀 구조 자체를 생성하는 메타 팩토리. Harness는 L3 메타 팩토리 계층에 위치한다. 하네스를 만드는 하네스다.

💡 Harness 핵심 정체

도메인을 입력하면 .claude/agents/에 에이전트 정의 파일, .claude/skills/에 스킬 파일, 그리고 팀을 조율하는 오케스트레이터 스킬을 한 번에 생성한다.

설치 방법

Claude Code 플러그인 마켓플레이스를 통해 설치하는 방법이 가장 간단하다. 에이전트 팀 기능은 아직 플래그로 활성화해야 한다는 점에 주의가 필요하다.

📦 설치 순서

• 1단계: Claude Code 플러그인 마켓플레이스에서 Harness 추가
• 2단계: 에이전트 팀 기능 활성화 — 쉘 프로필에 환경변수 플래그 추가
• 3단계: Claude Code 재시작 후 "하네스 구성해줘" 입력

수동 설치는 GitHub 저장소 클론 후 스킬 파일을 ~/.claude/skills/harness에 복사하면 된다.

6가지 팀 아키텍처 패턴

Harness가 도메인을 분석해 자동으로 선택하는 팀 구조는 여섯 가지다. 분산 시스템 설계에서 익숙한 개념들을 에이전트 오케스트레이션에 그대로 가져온 구조다.

① Pipeline — 순차 파이프라인

에이전트가 순서대로 작업을 이어받아 처리한다. 기획 → 작성 → 검토 → 배포처럼 앞 단계 결과가 다음 입력이 되는 워크플로우에 적합하다.

② Fan-out/Fan-in — 병렬 처리 후 통합

독립적인 작업을 여러 에이전트가 동시에 처리한 뒤 결과를 하나로 합친다. 코드 리뷰에서 아키텍처, 보안, 성능을 동시에 검사하고 단일 리포트로 통합하는 방식이 대표적이다.

③ Expert Pool — 전문가 선택 호출

입력 맥락에 따라 필요한 전문가 에이전트만 선택적으로 호출한다. 다양한 도메인 질문을 처리하는 시스템에 적합하다.

④ Producer-Reviewer — 생성 후 품질 검증

생성 에이전트가 결과물을 만들면 검증 에이전트가 품질을 확인한다. 콘텐츠 생성 후 일관성 리뷰, 코드 작성 후 보안 점검 구조에 맞다.

⑤ Supervisor — 감독자 중심 위임

감독자 에이전트가 작업을 판단해 하위 에이전트에게 위임한다. 작업 간 의존성이 복잡할 때 적합하다.

⑥ Hierarchical Delegation — 계층적 위임

최상위 에이전트 → 중간 관리자 → 실무 에이전트의 다단계 위임 구조다. 규모가 크고 작업 범위가 넓은 프로젝트에 적합하다.

핵심 기능 상세

Harness가 일반 템플릿 생성 도구와 다른 이유는 스킬 생성 방식과 검증 체계에 있다.

💡 Progressive Disclosure 스킬 생성

스킬 파일을 생성할 때 에이전트가 실제로 필요한 정보만 로드하고 상세 내용은 필요할 때만 불러오는 방식을 적용한다. 컨텍스트 창 낭비를 줄여 긴 작업에서도 품질이 유지된다.

🔍 검증 체계 3단계

• 트리거 검증 — 스킬이 올바른 시점에 호출되는지 확인
• 드라이런 테스트 — 실제 실행 전 동작 시뮬레이션
• A/B 비교 테스트 — 적용 전후 품질 차이를 수치로 측정

✅ Harness 장점

• 에이전트 팀 설계 시간 대폭 단축
• 도메인 무관하게 적용 가능
• 한국어 명령 완전 지원

❌ 고려사항

• 에이전트 팀 기능 플래그 별도 활성화 필요
• 복잡한 하네스는 토큰 소비가 많음

실전 활용 분야

Harness는 소프트웨어 개발에만 국한되지 않는다. 도메인을 가리지 않는 범용 구조 설계 도구다.

🎯 실제 적용 분야

• 소프트웨어 개발 — 기획, 구현, 테스트, 배포 자동화 파이프라인
• 콘텐츠 제작 — 유튜브 기획, 웹툰 스토리, 마케팅 카피
• 데이터 파이프라인 — 수집, 정제, 분석, 리포트 순차 처리
• 전략 보고서 — OKR 설계, SWOT 분석, 로드맵 수립 팀 조율

Harness 100 — 바로 쓸 수 있는 하네스 컬렉션

Harness 플러그인으로 처음부터 설계하는 게 부담스럽다면 Harness 100이 좋은 출발점이다. 10개 카테고리에 걸쳐 바로 사용 가능한 에이전트 팀 하네스 100개를 모아둔 프로젝트로, 각 하네스는 전문 에이전트 4~5명이 협업하는 구조다.

구분	Harness 플러그인	Harness 100
목적	하네스 자동 생성	완성된 하네스 제공
시작 방식	자연어 프롬프트	카탈로그에서 선택
커스터마이징	자유도 높음	제한적
진입 난이도	보통	낮음

정리 및 결론

✅ 핵심 정리

Harness는 Claude Code 멀티 에이전트 작업에서 반복되는 설계 작업을 한 문장으로 압축해주는 플러그인이다. 6가지 아키텍처 패턴, Progressive Disclosure 스킬 생성, 3단계 검증 체계까지 갖춰 실무 수준의 에이전트 팀을 빠르게 구성할 수 있다. 처음이라면 Harness 100에서 원하는 하네스를 골라 구조를 익힌 뒤 직접 설계로 넘어가는 순서를 추천한다.