하네스 엔지니어링 — 민호의 하네스로 배우는 AI 팀 설계

1. 왜 지금 하네스인가

“클로드 코드는 치매에 걸린 아인슈타인이다.”

유튜버 메이커 에반의 이 비유는 AI 코딩 에이전트의 본질을 정확히 꿰뚫는다. 천재적 능력을 갖추고 있지만, 세션이 바뀌면 모든 맥락을 잊어버린다. 프롬프트 하나로 시작한 대화는 컨텍스트가 쌓이면서 “컴팩션”이 발동되고, 지시 위반과 버그 재발이 반복된다.

하네스(Harness)는 이 문제에 대한 구조적 해답이다. 등산할 때 몸에 묶는 안전장비처럼, AI 에이전트가 사용자의 방식대로 일관되고 실수 없이 작동하도록 잡아주는 구조화된 사전 설정(Structured Pre-Configuration)이다. 단순히 CLAUDE.md에 규칙을 나열하는 수준을 넘어, 에이전트의 역할을 정의하고, 스킬을 생성하며, 팀을 구성하는 메타 시스템까지 포함한다.

2. Claude Code Agent Teams — 팀 협업의 기반

하네스를 이해하려면 먼저 그 실행 환경인 Agent Teams를 알아야 한다. Claude Code v2.1.32부터 도입된 실험적 기능으로, 여러 Claude Code 인스턴스가 하나의 팀으로 동작한다.

2.1 아키텍처

2.2 Subagent vs Agent Teams

핵심은 팀원들이 프로젝트의 CLAUDE.md, MCP 서버, Skills를 자동으로 로드한다는 점이다. 즉, 하네스에서 정의한 스킬과 설정이 모든 팀원에게 전파된다. 하네스가 Agent Teams의 “공유 DNA” 역할을 하는 셈이다.

2.3 활성화 방법

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

3. 민호의 하네스 — 메타 스킬이라는 발상

민호의 하네스는 단순한 스킬이 아니라 “스킬을 만드는 스킬”, 즉 메타 스킬(Meta-Skill)이다. 사용자가 “이 프로젝트에 맞는 하네스를 만들어줘”라고 말하면, 도메인을 분석하고, 팀 아키텍처를 설계하고, 에이전트와 스킬을 자동 생성한다.

3.1 6단계 워크플로우

3.2 6가지 아키텍처 패턴

민호의 하네스가 제공하는 팀 설계 패턴은 분산 시스템 아키텍처에서 익숙한 구조들이다.

복합 패턴도 지원한다: Fan-out + Producer-Reviewer, Pipeline + Fan-out, Supervisor + Expert Pool 등을 조합하여 실제 프로젝트의 복잡성에 대응할 수 있다.

3.3 검증된 효과: +60% 품질 향상

황민호님의 A/B 실험 결과(revfactory/claude-code-harness)는 하네스의 효과를 수치로 보여준다.

특히 복잡도가 높을수록 효과가 커진다: Basic +23.8, Advanced +29.6, Expert +36.2. 단순 작업에서는 차이가 적지만, 전문가급 작업에서 하네스의 진가가 드러난다.

3.4 Harness 100 — 200개 프로덕션 패키지

revfactory/harness-100 리포지토리에는 10개 도메인에 걸쳐 200개의 프로덕션 레디 패키지가 포함되어 있다. 콘텐츠 제작, 소프트웨어 개발, 데이터/AI, 비즈니스 전략, 교육, 법률, 헬스케어 등 도메인별 4~5개의 전문 에이전트와 오케스트레이터 스킬로 구성된다. 1,808개의 마크다운 파일이 총집합한 이 리포지토리는 하네스 엔지니어링의 실전 카탈로그라 할 수 있다.

3.5 핵심 설계 철학

4. 테크라이팅 하네스 vs 민호의 하네스 — 스펙 비교

이제 우리 프로젝트의 BloomLabs Content Harness(테크라이팅 하네스)와 민호의 하네스를 나란히 놓고 비교해 보자. 하나는 “팀용 범용 생성기”이고, 다른 하나는 “개인용 콘텐츠 특화 시스템”이다.

4.1 배울 점: 민호의 하네스에서 가져올 것

1. 메타 스킬 관점: 테크라이팅 하네스의 스킬들은 수동으로 정의되었다. 민호의 하네스처럼 “하네스를 만드는 하네스” 방식을 도입하면, 새로운 콘텐츠 도메인(예: 마케팅 콘텐츠, 기술 문서)에 빠르게 확장할 수 있다.
2. Agent Teams 전환: 현재 Sub-agent 방식에서 Agent Teams로 전환하면, researcher가 발견한 소스를 writer에게 직접 전달하고, evaluator가 실시간 피드백을 줄 수 있다.
3. 6가지 아키텍처 패턴: 현재는 Producer-Reviewer 패턴만 사용하고 있다. Fan-out/Fan-in을 적용하면 여러 소스를 병렬 리서치하고, Expert Pool로 독자 유형별 전문 작성 에이전트를 운용할 수 있다.
4. Why-First 문서화: 규칙보다 이유를 설명하는 접근법은 LLM이 예외 상황을 더 잘 처리하게 만든다.

4.2 테크라이팅 하네스의 차별점

1. 심층 평가 체계: 5축 100점 평가는 단순 A/B 비교를 넘어, 외부 자료 참조 품질, 비개발자 접근성, 대상 독자 명확성, 구조 완결성, 사실 정확성을 개별적으로 측정한다.
2. 다중 매체 오케스트레이션: Memorizer, Confluence, Webnori Wiki, private-doc, Pencil Design까지 5개 매체를 하나의 하네스로 통합 관리한다.
3. 게이미피케이션: RPG 시스템(레벨/업적/XP)은 콘텐츠 제작의 지속적 동기부여 메커니즘으로, 범용 하네스에는 없는 독특한 설계다.
4. 이벤트 소싱 로그: 스냅샷 압축 기법으로 로그 비대화를 방지하면서도 모든 작업 이력을 보존한다.

5. 전문가별 하네스 활용 전망

2026년 하반기, 하네스 엔지니어링은 특정 직군을 넘어 모든 전문가에게 확산될 것이다.

민호의 Harness 100이 이미 10개 도메인에 200개 패키지를 제공하고 있다는 사실은, 이 확산이 이미 시작되었음을 보여준다.

6. 2026년은 하네스 엔지니어링의 해

돌이켜보면, AI 에이전트 활용의 진화 단계가 선명하게 보인다.

프롬프트 엔지니어링이 “한 마디를 잘 하는 것”이었다면, 컨텍스트 엔지니어링은 “기억을 잘 관리하는 것”이었다. 하네스 엔지니어링은 한 단계 더 올라간다 — “팀을 설계하는 것”이다.

하지만 이것은 동시에 우리에게 새로운 숙제를 안겨준다.

참고 자료

1. revfactory/harness — 황민호, 2026-03 (Tier1: GitHub 공식 레포)
2. revfactory/harness-100 — 황민호, 2026-03 (Tier1: 프로덕션 패키지 200개)
3. revfactory/claude-code-harness — 황민호, 2026 (Tier1: A/B 실험 결과)
4. Claude Code Agent Teams 공식 문서 — Anthropic, 2026 (Tier1: 공식 문서)
5. 메이커 에반, “클로드 코드 효율적 활용을 위한 10단계 로드맵”, 2026-03 (Tier3)
6. 오후다섯씨, “아직도 클로드 에이전트 안하세요? Skill 2.0 완전 정복”, 2026-03 (Tier3)