Harness - Claude Code용 에이전트 팀 & 스킬 아키텍트 플러그인
목차
개요
Harness는 Claude Code용 플러그인으로, “하네스 구성해줘”라는 한 마디 명령으로 도메인 맞춤형 에이전트 팀을 자동 설계하고 필요한 스킬까지 생성해주는 메타 스킬이다. 카카오 AI Native 전략팀 리더인 황민호님이 개발했으며, Apache 2.0 라이선스로 오픈소스 공개되었다.
배경
Claude Code의 에이전트 기능이 확장되면서, 복잡한 작업을 여러 에이전트가 협력하여 수행하는 패턴이 주목받고 있다. 하지만 에이전트 팀을 직접 설계하고 스킬을 정의하는 과정은 상당한 노력이 필요하다. Harness는 이 과정을 자동화하여, 사용자가 도메인만 지정하면 최적의 에이전트 팀 구성을 자동으로 생성해준다.
핵심 내용
4가지 핵심 역량
| 역량 | 설명 |
|---|---|
| 에이전트 팀 설계 | 6가지 아키텍처 패턴을 기반으로 팀 구성 |
| 스킬 생성 | Progressive Disclosure를 활용한 자동 스킬 생성 |
| 오케스트레이션 | 에이전트 간 데이터 전달, 오류 처리, 협력 프로토콜 |
| 검증 | 트리거 검증, 드라이런 테스트, 비교 테스트 |
6가지 아키텍처 패턴
Harness는 작업 특성에 따라 최적의 아키텍처 패턴을 자동 선택한다.
| 패턴 | 설명 |
|---|---|
| 파이프라인 | 순차적 의존 작업 처리 |
| 팬아웃/팬인 | 병렬 독립 작업 실행 후 결과 병합 |
| 전문가 풀 | 상황별 적합한 에이전트 선택적 호출 |
| 생성-검증 | 산출물 생성 후 품질 검수 프로세스 |
| 감독자 | 중앙 에이전트가 동적으로 작업 분배 |
| 계층적 위임 | 상위에서 하위로 재귀적 위임 |
6단계 워크플로우
Harness는 다음 6단계를 거쳐 에이전트 팀을 구성한다.
- 도메인 분석 - 프로젝트와 작업 도메인 파악
- 팀 아키텍처 설계 - 최적의 아키텍처 패턴 선택
- 에이전트 정의 생성 - 각 에이전트의 역할과 책임 정의
- 스킬 생성 - 에이전트가 사용할 스킬 자동 생성
- 통합 및 오케스트레이션 - 에이전트 간 협력 프로토콜 설정
- 검증 및 테스트 - 생성된 팀의 동작 검증
프로젝트에 .claude/agents/ 디렉토리(에이전트 정의)와 .claude/skills/ 디렉토리(스킬 파일)가 자동 생성된다.
실행 모드
| 모드 | 적용 상황 |
|---|---|
| 에이전트 팀 (기본) | 2개 이상 에이전트의 협업이 필요할 때 |
| 서브 에이전트 | 단발성 작업, 에이전트 간 통신이 불필요할 때 |
설치 및 사용법
마켓플레이스를 통한 설치 방법은 다음과 같다.
1
2
/plugin marketplace add revfactory/harness
/plugin install harness@harness
글로벌 스킬로 직접 설치할 수도 있다.
1
cp -r skills/harness ~/.claude/skills/harness
사용 시에는 Claude Code에서 “Build a harness for this project”와 같은 프롬프트로 트리거할 수 있다. Agent Teams 기능 활성화를 위해 환경변수 설정이 필요하다.
1
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
활용 사례
Harness는 다양한 도메인에 적용 가능하다.
- 딥 리서치 - 웹 검색, 학술 자료, 커뮤니티 반응 기반 종합 보고서 작성
- 웹사이트 제작 - 디자인, 프론트엔드(React/Next.js), 백엔드, QA 파이프라인
- 웹툰 제작 - 스토리, 캐릭터, 레이아웃, 대사 에이전트 협력
- 유튜브 콘텐츠 - 트렌드 조사, 대본, SEO 최적화, 썸네일 기획
- 코드 리뷰 - 아키텍처, 보안, 성능, 스타일 병렬 감사
- API 문서 자동 생성 - 엔드포인트 분석, 설명 작성, 예제 생성, 리뷰
- 데이터 파이프라인 - 스키마 설계, ETL, 검증, 모니터링
- 마케팅 캠페인 - 시장 조사, 카피, 디자인, A/B 테스트 계획
성과와 벤치마크
Harness 100이라는 이름으로 10개 도메인의 100개 프로덕션 레디 에이전트 팀 패키지가 공개되었다. 한영 합쳐 총 200개 패키지, 1,808개 마크다운 파일로 구성된다.
15개 소프트웨어 엔지니어링 작업에서 테스트한 결과, 평균 품질 점수가 49.5에서 79.3으로 60% 향상되었다. 승률 100%, 출력 분산은 32% 감소하여 일관된 품질을 보여주었다.
실제 사용자 후기로는 VibeCoding 모노레포에 코드 감사 모드로 적용했을 때 정적 분석으로 놓친 항목들을 발견했다는 보고가 있다. 다만 Max 100 토큰 제한으로 즉시 한계에 도달한다는 피드백도 있었다.
결론
Harness는 Claude Code의 에이전트 팀 기능을 누구나 쉽게 활용할 수 있게 해주는 메타 스킬이다. 6가지 아키텍처 패턴과 자동화된 6단계 워크플로우로, 복잡한 에이전트 설계 과정을 “하네스 구성해줘” 한 마디로 해결한다. 벤치마크에서 품질 60% 향상이라는 실질적인 성과를 보여주고 있어, Claude Code 사용자라면 주목할 만한 도구다.