Harness — Claude Code 에이전트 팀 & 스킬 아키텍트 플러그인

Context

Claude Code에서 멀티 에이전트 시스템을 구축할 때 각 도메인별로 에이전트 팀의 역할 분담, 협업 흐름, 개별 스킬을 수동으로 설계하고 정의해야 했다. 복잡한 작업 조율(오케스트레이션)과 에러 처리를 매번 구현하는 것이 반복적인 작업이었다.

Technical Solution

• 자연어 기반 메타 스킬 도입: "하네스 구성해줘" 한 마디로 도메인 분석 → 팀 아키텍처 설계 → 에이전트 정의 생성 → 스킬 생성 → 통합 및 오케스트레이션 → 검증을 6단계 워크플로우로 자동화
• 6가지 아키텍처 패턴 지원: 순차 의존 작업(파이프라인), 팬아웃/팬인(병렬 독립), 전문가 풀(상황별 선택 호출), 생성-검증(품질 검수), 감독자(중앙 동적 분배), 계층적 위임(재귀적 하향식)
• 에이전트 팀과 서브 에이전트 두 가지 실행 모드 제공: TeamCreate + SendMessage + TaskCreate 방식의 협업 에이전트 팀(2개 이상 에이전트·협업 필요 시) 또는 Agent 도구 직접 호출의 서브 에이전트(단발성 작업)
• 파일 기반 구성 자동화: .claude/agents/ 디렉토리에 에이전트 정의 파일(.md), .claude/skills/ 디렉토리에 스킬 파일을 자동 생성해 버전 관리 및 재사용 가능
• 오케스트레이션과 에러 핸들링 프로토콜 내장: 에이전트 간 통신, 작업 분배, 실패 처리를 플러그인이 자동으로 관리

Impact

Harness-100 레포지토리에서 10개 도메인 기준 100개의 프로덕션 레디 에이전트 팀 하네스(한영 200패키지) 공개, 1,808개 마크다운 파일로 구성된 사전 생성 템플릿 제공.

Key Takeaway

멀티 에이전트 시스템 설계를 프롬프트 기반 자동화로 추상화하면 도메인마다 유사한 오케스트레이션 로직 반복 구현을 피하고 아키텍처 패턴 선택지를 체계화할 수 있다. 사전 검증된 100개 하네스 템플릿은 각 도메인의 에이전트 팀 구성에 대한 참고 사례로 기능한다.