§01 · 학습 챕터

01. Harness Orchestrator

하네스 오케스트레이터

AI 코딩 도구 하나만 쓰는 것과 여러 AI를 역할에 맞게 조율하는 것은 다릅니다. Harness MultiAgent 2.0은 “강한 AI”를 파일 · 승인 · 검증으로 묶는 하네스(제어 장치) 입니다. 세션이 끊겨도 폴더만 읽으면 이어갈 수 있게 설계되어 있습니다.

정본: AGENTS.md · 매뉴얼 PDF v2.0 §01대상: 바이브코더 · 초급 개발자 (기술 용어 + 한글 설명 병행)

챕터 이동chapter-nav

이전·다음 챕터로 이동합니다. 본문은 아래 학습 블록 카드에서 펼칩니다.

첫 챕터

홈

Harness MultiAgent 2.1

02 설치 · init.py · validate.py

01. Harness Orchestrator 02. Install · validate 03. Folder 3 layers 04. Task lifecycle 05. Workers · MCP 06. Approval · envelope 07. Four flavors 08. RUNBOOK 09. KNOT · wiki 10. KNOT · install 11. KNOT · bridge LAB · Phase · Run

전체 학습 블록 카드learn-blocks

학습 블록

One-line definition

한 줄 정의

AGENTS.md · 매뉴얼 PDF v2.0 §01 · Harness MultiAgent 2.0 = 강한 LLM을 파일 · 승인 · 검증으로 묶는 file-as-memory 하네스.

문서 코드 본문현재 실습

학습 블록

Orchestrator vs Worker

역할 구분

AGENTS.md · 매뉴얼 PDF v2.0 §01 · 중요: 오케스트레이터의 “내부 추론”은 worker 호출이 아닙니다. 별도 모델을 부를 때만 workers_approved + [APPROVAL]이 필요합니다.

문서 코드 본문 실습

학습 블록

Canonical worker pool

표준 워커 3종

AGENTS.md · 매뉴얼 PDF v2.0 §01 · 교차 검수: critique는 지휘자와 다른 벤더가 담당. 자기 산출물을 자기가 검수하면 안 됩니다.

문서 코드 본문 실습

학습 블록

Memory = filesystem

파일이 곧 기억

AGENTS.md · 매뉴얼 PDF v2.0 §01 · MULTIAGENT_ROOT/tasks/<task-name>/

문서 코드 본문 실습

학습 블록

Collaboration patterns

협업 패턴

AGENTS.md · 매뉴얼 PDF v2.0 §01 · 금지: 워커끼리 결과 직접 참조. 통합은 항상 오케스트레이터.

문서 코드 본문 실습

학습 블록

Documentation authority

정본 수정 금지

AGENTS.md · 매뉴얼 PDF v2.0 §01 · multi-agent-system/은 운영 정본 — 임의 편집 금지.

문서 코드 본문 실습

학습 블록

Checklist

체크리스트

AGENTS.md · 매뉴얼 PDF v2.0 §01 · 체크리스트

문서 코드 본문 실습

선택 블록 본문block-detail

One-line definition

한 줄 정의

Harness MultiAgent 2.0 = 강한 LLM을 파일 · 승인 · 검증으로 묶는 file-as-memory 하네스.

키워드	한글 설명
file-as-memory	채팅이 아니라 `task.md` · `log.md` 등 디스크 파일이 기억
런타임 상태 0	서버에 숨은 “비밀 메모리” 없음 — 결정은 Markdown·JSON에만
하네스	말 잘하는 AI를 통제·추적하는 외곽 장치

쉬운 비유

일상	하네스에서
팀장이 일을 나눔	Orchestrator가 계획·통합
실무자가 따로 일함	Worker가 별도 모델 호출로 실행
회의록·결재 서류	`task.md` · `log.md` · `brief.md` · `result.md`

정본 발췌 (AGENTS.md)

Orchestrator (current host session — internal reasoning; NOT a worker)
└── Worker Pool (separate model calls — approval required)
    ├── claude    메인 구현 · critique
    ├── codex     보조 구현 · critique
    └── gemini    멀티모달 · 장문 · 제3자 시각

문서 권위 (충돌 시 순서)

AGENTS.md Documentation Authority와 동일 (AGENTS.md § Documentation Authority):

사용자 직접 지시
매뉴얼 PDF v2.0
multi-agent-starter generator templates
AGENTS.md · _shared/*
STRUCTURE-DESIGN.md
VIDEO-MANUAL-ANALYSIS.md (영상 요약·legacy drift 참고 — 규칙 아님)
YouTube 영상 (시연·동기 부여만)
runs/ (읽기 전용 — 본문으로 재작성 금지)

영상 링크: v1 · v2 — 매뉴얼 PDF와 충돌 시 PDF 정본.