Context Vault

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

5 min read

한 줄 요약

“하네스 구성해줘” 한 마디로 도메인에 맞는 전문 에이전트 팀을 설계하고, 에이전트가 사용할 스킬까지 자동 생성해주는 Claude Code 메타 스킬.

핵심 아이디어

사람이 에이전트를 하나하나 설계하는 게 아니라, 하네스(Harness)가 에이전트 팀과 스킬을 자동 생성한다. 6가지 아키텍처 패턴을 지원하며 에이전트 간 오케스트레이션과 에러 핸들링 프로토콜을 포함.

지원 아키텍처 패턴

패턴설명예시
파이프라인순차 의존 작업기술 문서 작성
팬아웃/팬인병렬 독립 작업코드 리뷰 (보안/성능/스타일 병렬)
전문가 풀상황별 선택 호출법률 자문
생성-검증생성 후 품질 검수콘텐츠 제작
감독자중앙 에이전트가 동적 분배유튜브 콘텐츠 기획
계층적 위임상위→하위 재귀적 위임데이터 파이프라인 설계

6단계 워크플로우

1. 도메인 분석
2. 팀 아키텍처 설계 (에이전트 팀 vs 서브 에이전트)
3. 에이전트 정의 생성
4. 스킬 생성
5. 통합 및 오케스트레이션
6. 검증 및 테스트

실행 모드

모드방식적합한 경우
에이전트 팀 (기본)TeamCreate + SendMessage + TaskCreate2개 이상 에이전트, 협업 필요
서브 에이전트Agent 도구 직접 호출단발성 작업, 통신 불필요

생성되는 파일 구조

.claude/
├── agents/
│   ├── analyst.md      # 에이전트 정의
│   ├── builder.md
│   └── qa.md
└── skills/
    └── *.md            # 스킬 파일

하네스 구성 예시

딥 리서치:

“리서치 하네스를 구성해줘. 웹 검색, 학술 자료, 커뮤니티 반응 — 교차 검증 후 종합 보고서를 작성하는 팀.”

풀스택 웹개발:

“풀스택 웹사이트 개발 하네스를 구성해줘. 디자인, 프론트엔드(React/Next.js), 백엔드(API), QA를 파이프라인으로 조율하는 팀.”

코드 리뷰:

“종합 코드 리뷰 하네스를 구성해줘. 아키텍처, 보안, 성능, 코드 스타일을 병렬로 감사하는 팀.”

harness-100: 프로덕션 레디 100개 팀

  • GitHub: https://github.com/revfactory/harness-100
  • 10개 도메인, 100개 에이전트 팀 (한영 200패키지)
  • 콘텐츠 제작, SW 개발, 데이터/AI, 비즈니스 전략, 교육, 법률, 헬스케어 등
  • 총 1,808개 마크다운 파일
  • 각 하네스에 4-5명의 전문 에이전트 + 오케스트레이터 스킬 + 도메인 특화 스킬

실행 전 설정

# Claude Code의 에이전트 팀 기능 활성화 필요
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

연결된 노트

그래프 뷰