← → / SPACE · F=Full · N=Notes
Meetup · 2026

HARNESS

Claude Code를 위한
팀 아키텍처 팩토리
한 문장이면 팀이 만들어집니다.
Question

에이전트 한 명으로
왜 부족할까?

진짜 복잡한 일은,
한 명으로는 끝나지 않습니다.
The Pain

단일 에이전트의 한계

  • 컨텍스트 폭주 — 200K 토큰도 부족하다
  • 역할 혼동 — 코드 · 디자인 · QA · 리서치 한 사람이 다 하면 무너진다
  • 의사결정 흐림 — 자기 결과를 자기가 검수한다

이건 모델 성능 문제가 아니라 구조의 문제입니다.

The Insight

답은 이미 우리가 알고 있다.
팀.

전문가가 모이고, 메시지를 주고받고,
누가 무엇을 할지 합의합니다.

  • Claude Code는 이미 TeamCreate · SendMessage · TaskCreate 를 제공한다
  • 문제는 — 그 팀을 누가 설계할 것인가
What is Harness

Harness = 팀을 만드는 팩토리

도메인 한 문장 → 에이전트 팀 + 그들이 쓸 스킬.

하네스 구성해줘
  • 산출물: .claude/agents/*.md + .claude/skills/*/SKILL.md + 오케스트레이터
  • 다음 세션부터는 그 팀이 자동으로 호출됩니다.
Position

우리가 서 있는 자리 — L3 Meta-Factory

L3Meta-Factory · Team-Architecture Factory ← Harness
L3Meta-Factory · Runtime-Configuration Factory (Archon)
L2Cross-Harness Workflow (ECC)
L1Individual Harnesses

Archon은 결정적 런타임을, Harness는 팀 아키텍처를 뽑아냅니다.

Architecture Patterns

6가지 팀 아키텍처 패턴

01Pipeline · 파이프라인
02Fan-out / Fan-in
03Expert Pool · 전문가 풀
04Generation-Validation
05Supervisor · 감독자
06Hierarchical Delegation

모든 협업은 결국 이 6가지 중 하나입니다. 하네스가 알아서 고릅니다.

Deep-dive

가장 자주 쓰는 4가지

Pipeline

순차 의존 — 디자인 → 코드 → QA

Fan-out / Fan-in

병렬 독립 — 5개 자료 동시 수집 후 통합

Generation-Validation

생성-검증 루프 — 작가 + 편집자

Supervisor

중앙 조율자 — PM이 동적으로 분배

Separation of Concerns

누가 하느냐 vs 어떻게 하느냐

Agent · 역할

.claude/agents/qa.md

"QA 엔지니어 페르소나 · 검증 원칙 · 협업 프로토콜"

Skill · 능력

.claude/skills/test-runner/

"실제 테스트 실행 방법 · 도구 사용법 · 출력 포맷"

분리하면 재사용성이 폭발합니다.

Workflow

6 Phases · 어떻게 동작하나

1도메인 분석
2팀 아키텍처 설계
3에이전트 정의 생성
4스킬 생성
5오케스트레이션
6검증 & 테스트

매 단계가 분리되어 있어 결과가 재현 가능합니다.

Live Demo

한 문장으로 팀 만들기

웹툰 에피소드 제작 하네스를 구성해줘
  • agents/ · story-writer · character-designer · panel-planner · dialogue-editor
  • skills/ · story-arc · character-prompt · panel-layout · dialogue-polish
  • orchestrator · webtoon-episode-create

다음부터는 웹툰 만들어줘 한 마디면 끝.

Real Cases

실전 사례 세 가지

웹툰 제작

작가 · 캐릭터 디자이너 · 패널 기획 · 대사 편집 팀이 스타일 일관성을 서로 리뷰

풀스택 웹사이트

디자인 → FE(Next.js) → BE(API) → QA 파이프라인 — 와이어프레임부터 배포까지

딥 리서치

웹 · 학술 · 커뮤니티 자료 동시 수집 후 교차 검증 → 종합 보고

같은 하네스 스킬, 도메인마다 다른 팀.

Evolution Mechanism

하네스는 진화합니다

초기 하네스
실 프로젝트 사용
출시 하네스
/harness:evolve
  • 출시 시 변경된 델타를 팩토리로 되먹입니다
  • 다음 세대는 출시 상태에 가까운 초안부터 시작
  • 사용할수록 더 좋아집니다. 측정 가능하게.
Get Started

지금 바로 시작하기

/plugin marketplace add revfactory/harness
/plugin install harness@harness

그리고 첫 명령:

하네스 구성해줘

5분이면 첫 팀이 손에 들어옵니다. github.com/revfactory/harness

Thank you.

Let's talk.

사용 사례 · 막혔던 부분 · 시도하고 싶은 도메인 — 모두 환영합니다.

robin.hwang@kakaocorp.com · github.com/revfactory/harness
SPEAKER NOTES
"한 문장으로 시작합니다 — 하네스 구성해줘." 30분 동안 왜 이게 게임체인저인지 보여드립니다. 청중을 천천히 둘러보고 시작.
여러분 회사의 PRD 한 장을 코딩 에이전트 하나에 던져보셨나요? 컨텍스트 절벽, 일관성 붕괴, 끝없는 수정. 사람이라면? 팀을 짭니다.
모델 성능을 더 키워도 해결되지 않습니다. 한 사람이 풀스택+디자인+QA 다 하면 회사가 망하죠. 구조의 문제입니다.
Claude Code 4.6부터 팀 통신 도구가 정식 출시됐습니다. 인프라는 이미 있어요. 문제는 누가 팀을 설계하느냐.
하네스 = 팀을 만드는 팩토리. 사람이 팀을 설계하지 않습니다. 하네스가 합니다. 산출물은 마크다운 파일들 — 다음 세션에서 자동 호출됩니다.
L3 Meta-Factory. Archon은 결정적 런타임, 우리는 팀 아키텍처. 같은 층의 다른 서브레이어. 같이 쓰면 더 강합니다.
6가지 패턴. 모든 협업이 결국 이 6가지로 환원됩니다. 사람이 고르지 않습니다. 도메인을 던지면 패턴이 따라옵니다.
실전에서 95%는 이 4가지를 씁니다. 청중에게 직관적으로 어떤 작업이 어떤 패턴인지 한 번 물어보고 답하세요.
에이전트(역할)와 스킬(능력)을 분리하면 재사용성이 폭발합니다. QA 에이전트는 동일, 프로젝트별 스킬은 다르게.
6 Phase 워크플로우. 분리가 핵심입니다. 그래서 결과가 재현 가능합니다.
라이브 데모 시간. 시간이 없으면 사전 녹화한 30초 클립으로 대체. "이게 끝입니다" 한 마디 강조.
같은 하네스 스킬이 도메인마다 다른 팀을 짭니다. 사례 중 청중에게 가장 가까운 것 하나 선택해 깊이 설명.
진화 메커니즘. 하네스는 한 번 만들고 끝나는 게 아니라 사용하면서 더 좋아집니다. 측정 가능한 개선.
3개 라인이면 첫 팀 손에 들어옵니다. 깃허브 주소 강조. QR 코드 준비했으면 여기서 띄우세요.
Q&A 오픈. 한 명도 질문 안 하면 "여러분 도메인에서 가장 답답한 협업 패턴 하나 던져보세요"로 시동.