Claude Code 플러그인 Harness 완전 정복 – AI 팀 자동화 설정 방법

Claude Code 플러그인 Harness 완전 정복 – AI 팀 자동화 설정 방법

Claude Code로 혼자 다 하고 계신가요?

리서치하고, 초안 쓰고, 검수하고, 배포까지. 잘하면 잘할수록 할 일은 늘어납니다. 근데 이걸 AI 에이전트 팀에 통째로 넘길 수 있다면 어떨까요?

카카오 AI Native 전략 팀 리더 황민호 님이 공개한 Claude Code 플러그인 Harness(하네스) 는 프롬프트 한 줄로 전문 AI 에이전트 팀을 자동 설계합니다.

리서치 에이전트, 작성 에이전트, 검수 에이전트가 각자 역할을 나눠 맡고, 감독자 에이전트가 전체를 조율합니다. 직접 팀을 짤 필요도 없습니다.

“유튜브 콘텐츠 제작 하네스를 구성해줘” 한 마디면 끝입니다.

이 글에서는 Harness의 개념부터 6가지 아키텍처 패턴, 실전 프롬프트 예시, 그리고 즉시 쓸 수 있는 harness-100 패키지 무료 활용법까지 한 번에 정리합니다.

Claude Code AI 자동화를 제대로 써보고 싶다면, 지금부터 읽어보세요.

Harness란? Claude Code 전용 AI 메타 스킬 플러그인 개념 정리

일반 플러그인은 “이 일 해줘”입니다. Harness는 다릅니다. “이 일을 할 팀을 만들고, 팀원들이 쓸 도구까지 만들어줘”가 Harness가 하는 일입니다.

그래서 메타 스킬(Meta Skill) 이라고 부릅니다. 스킬을 만드는 스킬이라는 뜻이죠.

실행 결과물이 재미있습니다. Claude Code 안에 자동으로 .claude/agents/ 폴더가 생기고, analyst.md, builder.md, qa.md 같은 에이전트 정의 파일들이 들어찹니다.

옆에 .claude/skills/ 폴더에는 각 에이전트가 사용할 스킬 파일도 함께 생성됩니다. 말 그대로 팀 전체가 자동 조직됩니다.

환경 변수 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1만 켜두면 됩니다.

나머지는 Harness가 다 합니다. GitHub에서 직접 설치하고 싶다면 아래 링크를 참고하세요.

👉 revfactory/harness — GitHub 공식 저장소

설치 방법, 환경 설정, 예시 프롬프트가 모두 정리되어 있습니다.

Harness는 6가지 아키텍처 패턴을 지원합니다. 복잡하게 들리지만 실제로는 단순합니다. 내 작업이 어떤 흐름인지만 생각하면 자연스럽게 맞는 패턴이 나옵니다.

파이프라인 (Pipeline): 순서가 중요한 작업입니다. A가 끝나야 B가 시작되고, B가 끝나야 C가 시작됩니다. 블로그 포스팅 자동화에 딱입니다.

키워드 분석 → 아웃라인 작성 → 본문 생성 → SEO 최적화 순서로 에이전트가 릴레이를 뜁니다.

팬아웃/팬인 (Fan-out/Fan-in): 동시에 여러 각도에서 처리하고 결과를 합칩니다. 코드 리뷰에서 아키텍처 검토, 보안 취약점 분석, 성능 분석을 동시에 돌린 뒤 하나의 리포트로 통합하는 방식이 대표적입니다.

전문가 풀 (Expert Pool): 상황에 따라 필요한 전문가를 골라 씁니다. 딥 리서치 팀이라면 웹 검색 전문가, 학술 자료 전문가, 커뮤니티 반응 분석가 중 적합한 에이전트를 선택 호출합니다.

생성-검증 (Generate-Verify): 만들고, 검수하고, 다시 만들고. 마케팅 카피 작업에 잘 맞습니다. 퀄리티 루프를 자동으로 돌려줍니다.

감독자 (Supervisor): 중앙 감독자 에이전트가 팀원들에게 일을 배분합니다. 유튜브 콘텐츠 기획처럼 트렌드 조사, 대본, SEO, 썸네일 컨셉 등 다양한 역할이 필요한 프로젝트에 최적입니다.

계층적 위임 (Hierarchical Delegation): 상위 에이전트가 하위 에이전트에게 재귀적으로 작업을 쪼개 넘깁니다. 데이터 파이프라인 설계처럼 복잡도가 높은 작업에 씁니다.

Harness에 한 줄 입력하면 내부에서 이 여섯 단계가 조용히 실행됩니다.

“유튜브 콘텐츠 제작 하네스를 구성해줘. 트렌드 조사, 대본 작성, SEO 최적화, 썸네일 기획을 감독자 에이전트가 조율하는 팀.” 이 한 문장이 입력되는 순간, 위 6단계가 자동 실행되고 완성된 팀이 폴더에 쌓입니다.

말이 어려울 필요 없습니다. 지금 일하는 방식을 그대로 문장으로 옮기면 됩니다.

딥 리서치 팀:

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

마케팅 캠페인 팀:

“마케팅 캠페인 하네스를 구성해줘. 타겟 시장 조사, 광고 카피 작성, 비주얼 컨셉, A/B 테스트 계획을 반복 품질 리뷰와 함께 진행하는 팀.”

블로그 콘텐츠 자동화 팀:

“SEO 블로그 하네스를 구성해줘. 키워드 리서치, 아웃라인 설계, 본문 작성, 메타 디스크립션 최적화까지 파이프라인으로 처리하는 팀.”

직접 팀을 설계하는 게 번거롭다면, revfactory/harness-100 패키지를 쓰면 됩니다. Harness로 미리 만들어놓은 프로덕션 레디 에이전트 팀 100개가 들어있습니다.

클론 한 번으로 즉시 사용 가능한 팀 100개가 손에 들어옵니다. 아래에서 직접 확인해보세요.

👉 revfactory/harness-100 — 100개 프로덕션 레디 AI 팀 패키지

한국어 버전 포함, 1,808개 마크다운 파일 즉시 클론 가능합니다.

구분	에이전트 팀	서브 에이전트
방식	TeamCreate + SendMessage 기반 협업	Agent 도구 직접 호출
적합 상황	2개 이상 에이전트, 협업 필요	단발성 작업, 통신 불필요
복잡도	높음 (오케스트레이션 포함)	낮음 (단순 직접 호출)
추천 도메인	웹사이트 제작, 콘텐츠 팀, 데이터 파이프라인	단순 코드 검토, 단일 문서 변환