이 글은 Claude Code 환경에서 에이전트 팀과 스킬을 자동으로 설계·생성해주는 Harness 플러그인에 대해 정리한 글입니다.
Harness가 어떤 문제를 해결하려는 도구인지, 내부 아키텍처 패턴과 워크플로우는 어떻게 구성돼 있는지, 그리고 실제로 어떤 유형의 에이전트 팀을 만들 수 있는지까지 입력된 정보를 기반으로 체계적으로 설명합니다. 멀티 에이전트 협업이 필요한 개발·콘텐츠·분석 작업을 어떻게 구조화할 수 있는지 이해하는 데 초점을 둡니다.
Harness란 무엇인가
Harness는 “하네스 구성해줘”라는 한 문장만으로, 특정 도메인에 맞는 전문 에이전트 팀과 이들이 사용할 스킬을 자동 생성해주는 메타 스킬 플러그인입니다.
Claude Code의 에이전트 팀 기능을 전제로 동작하며, 복잡한 협업 구조를 사람이 직접 설계하지 않아도 되도록 돕는 것이 핵심 목적입니다.
이 플러그인은 단순히 에이전트를 나열하는 수준이 아니라,
- 에이전트 간 역할 분담
- 작업 흐름(오케스트레이션)
- 에러 핸들링 프로토콜
까지 포함한 구조화된 팀 아키텍처를 자동으로 만들어냅니다.
Harness의 핵심 특징
1. 도메인 중심 메타 스킬
Harness는 특정 작업을 수행하는 단일 스킬이 아니라, 에이전트 팀 자체를 생성하는 메타 스킬입니다.
도메인 요구사항을 입력하면, 해당 도메인에 적합한 에이전트 역할과 협업 구조를 자동으로 설계합니다.
2. 6가지 아키텍처 패턴 지원
Harness는 작업 성격에 따라 다음과 같은 아키텍처 패턴을 선택해 에이전트를 구성합니다.
- 파이프라인: 순차적으로 의존 관계가 있는 작업
- 팬아웃 / 팬인: 병렬로 분산 실행 후 결과를 통합
- 전문가 풀: 상황에 따라 적절한 에이전트를 선택 호출
- 생성–검증: 결과 생성 후 별도 에이전트가 품질 검수
- 감독자: 중앙 에이전트가 작업을 동적으로 분배
- 계층적 위임: 상위 에이전트가 하위 에이전트에게 재귀적으로 위임
이를 통해 단순 작업부터 복합적인 협업 시나리오까지 폭넓게 대응할 수 있습니다.
Harness의 6단계 워크플로우
Harness는 다음의 6단계 절차로 에이전트 팀을 구성합니다.
- 도메인 분석
- 팀 아키텍처 설계 (에이전트 팀 vs 서브 에이전트)
- 에이전트 정의 생성
- 스킬 생성
- 통합 및 오케스트레이션
- 검증 및 테스트
이 흐름 덕분에 사용자는 내부 구현을 몰라도, 결과적으로 즉시 활용 가능한 협업 구조를 얻을 수 있습니다.
실행 모드: 에이전트 팀 vs 서브 에이전트
Harness는 작업 성격에 따라 두 가지 실행 모드를 제공합니다.
에이전트 팀 모드 (기본)
- TeamCreate + SendMessage + TaskCreate 방식
- 2개 이상의 에이전트 협업이 필요한 경우 권장
- 역할 분담과 상호 커뮤니케이션이 중요한 작업에 적합
서브 에이전트 모드
- Agent 도구를 직접 호출
- 단발성 작업, 통신이 필요 없는 경우에 적합
이 구분을 통해 불필요한 오버헤드를 줄이면서도 유연한 실행이 가능합니다.
자동 생성되는 파일 구조
Harness 실행 시 다음과 같은 파일들이 자동으로 생성됩니다.
- .claude/agents/
- 예: analyst.md, builder.md, qa.md
- .claude/skills/
- 각 에이전트가 사용할 스킬 정의 파일
즉, 팀 구조와 스킬 정의가 명시적인 마크다운 파일로 남아 재사용과 수정이 용이합니다.
생성 가능한 에이전트 팀 예시
Harness는 다양한 도메인에 맞는 팀 구성을 지원합니다.
- 딥 리서치 팀
웹 검색, 학술 자료, 커뮤니티 반응을 병렬 조사 후 교차 검증하여 종합 보고서 작성 - 웹사이트 제작 팀
디자인, 프론트엔드, 백엔드, QA를 파이프라인으로 조율하여 배포까지 관리 - 웹툰 제작 팀
스토리, 캐릭터 디자인, 패널 구성, 대사 편집을 분리하고 스타일 일관성 리뷰 수행 - 유튜브 콘텐츠 기획 팀
트렌드 조사부터 SEO, 썸네일 기획까지 감독자 에이전트가 조율 - 코드 리뷰 팀
아키텍처, 보안, 성능, 스타일을 병렬 감사 후 단일 리포트로 통합 - 기술 문서 자동 생성 팀
API 분석 → 설명 작성 → 예제 생성 → 품질 리뷰를 파이프라인으로 처리
이 외에도 데이터 파이프라인 설계, 마케팅 캠페인 등 다양한 시나리오를 지원합니다.
프로덕션 레디 하네스 패키지 공개
revfactory에서는 revfactory/harness-100 프로젝트를 통해
- 10개 도메인
- 100개의 프로덕션 레디 에이전트 팀 하네스
를 공개했습니다.
각 하네스는 4~5명의 전문 에이전트와 오케스트레이터 스킬, 도메인 특화 스킬을 포함하며,
콘텐츠 제작, 소프트웨어 개발, 데이터·AI, 비즈니스, 교육, 법률, 헬스케어 등 다양한 분야를 포괄합니다.
사용 전 준비 사항
Harness를 사용하려면 Claude Code의 에이전트 팀 기능이 활성화돼 있어야 합니다.
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
이 설정이 없으면 팀 기반 실행이 불가능합니다.
Harness는 멀티 에이전트 협업을 ‘설계의 문제’에서 ‘호출의 문제’로 바꾸는 도구입니다.
복잡한 역할 정의와 흐름 설계를 사람이 직접 하지 않아도, 도메인 요구만 전달하면 구조화된 팀이 즉시 생성됩니다.
앞으로 에이전트 기반 개발과 콘텐츠 생산이 확산될수록,
이처럼 아키텍처 자체를 자동화하는 메타 레벨 도구의 중요성은 더욱 커질 것으로 보입니다.
Harness는 그 흐름을 가장 실용적인 형태로 보여주는 사례라고 볼 수 있습니다.
https://github.com/revfactory/harness
GitHub - revfactory/harness: A meta-skill that designs domain-specific agent teams, defines specialized agents, and generates th
A meta-skill that designs domain-specific agent teams, defines specialized agents, and generates the skills they use. - revfactory/harness
github.com
'인공지능' 카테고리의 다른 글
| 추론 성능 중심으로 진화한 상태공간모델, Mamba-3 기술 정리 (0) | 2026.03.30 |
|---|---|
| Claude Code 웹 예약 실행 기능으로 반복 개발 업무 자동화하기 (0) | 2026.03.30 |
| CPU부터 LPU까지, AI를 움직이는 5가지 하드웨어 아키텍처 정리 (0) | 2026.03.30 |
| Vibe Coding XR: Gemini와 XR Blocks로 구현하는 AI 기반 XR 프로토타이핑 워크플로우 (0) | 2026.03.28 |
| macOS에서 실제 컴퓨터를 조작하는 Claude, Anthropic의 컴퓨터 사용 기능 업데이트 정리 (0) | 2026.03.27 |
