Harness MultiAgent 허브

§02 · 학습 챕터

02. Install · validate

설치 · init.py · 검증

멀티에이전트 시스템은 AI가 매번 AGENTS.md나 _shared/를 즉흥 창작하지 않습니다. 플러그인 + init.py 한 줄로 정해진 템플릿이 복사되고, validate.py가 구조가 맞는지 자동 검사합니다.

정본: multi-agent-starter generator · docs/FOUR-FLAVOR-NAMING.md · AGENTS.md대상: 바이브코더 · 초급 개발자 (기술 용어 + 한글 설명 병행)
챕터 이동chapter-nav

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

이전

01. Harness Orchestrator / 하네스 오케스트레이터

홈

Harness MultiAgent 2.1

다음

03 폴더 3층 구조

01. Harness Orchestrator02. Install · validate03. Folder 3 layers04. Task lifecycle05. Workers · MCP06. Approval · envelope07. Four flavors08. RUNBOOK09. KNOT · wiki10. KNOT · install11. KNOT · bridgeLAB · Phase · Run
전체 학습 블록 카드learn-blocks
학습 블록

Deterministic install

결정적 설치

multi-agent-starter generator · docs/FOUR-FLAVOR-NAMING.md · AGENTS.md · 결정적(deterministic) = 같은 flavor·target이면 항상 같은 폴더 구조가 나옵니다. LLM이 규칙 파일을 새로 쓰지 않습니다. 하네스의 첫 안전장치입니다.

문서코드본문현재실습
학습 블록

init.py commands

init.py 명령

multi-agent-starter generator · docs/FOUR-FLAVOR-NAMING.md · AGENTS.md · INIT=multi-agent-starter/plugins/multi-agent-starter/skills/configure-multiagent/generator/init.py

문서코드본문실습
학습 블록

Four flavors

4-flavor 비교

multi-agent-starter generator · docs/FOUR-FLAVOR-NAMING.md · AGENTS.md · 쉬운 정리: _shared · _templates · tasks/ 구조는 같고, 어느 앱 창에서 지휘하느냐만 다릅니다.

문서코드본문실습
학습 블록

Post-install files

설치 후 핵심 파일

multi-agent-starter generator · docs/FOUR-FLAVOR-NAMING.md · AGENTS.md · MCP(Model Context Protocol) = IDE가 Codex 같은 외부 AI를 도구처럼 호출하는 표준 통로.

문서코드본문실습
학습 블록

validate.py checks

validate.py 검증

multi-agent-starter generator · docs/FOUR-FLAVOR-NAMING.md · AGENTS.md · 검증 스크립트가 보는 것 (개념):

문서코드본문실습
학습 블록

Common mistakes

자주 하는 실수

multi-agent-starter generator · docs/FOUR-FLAVOR-NAMING.md · AGENTS.md · 자주 하는 실수

문서코드본문실습
학습 블록

Checklist

체크리스트

multi-agent-starter generator · docs/FOUR-FLAVOR-NAMING.md · AGENTS.md · 체크리스트

문서코드본문실습
선택 블록 본문block-detail

Deterministic install

결정적 설치

결정적(deterministic) = 같은 flavor·target이면 항상 같은 폴더 구조가 나옵니다. LLM이 규칙 파일을 새로 쓰지 않습니다. 하네스의 첫 안전장치입니다.

개념 한글 왜 중요한가
generator init.py 템플릿 복사만 — 창작 없음
validate validate.py flavor별 11~12 불변식 자동 점검 (cursor 11/11)
flavor cursor/claude/codex/antigravity 지휘자 앱만 다름, 구조 동일

Cursor에서 시작하기 (가장 흔한 경로)

  1. 저장소 (택1):
  2. 플러그인 설치: multi-agent-starter 마켓플레이스 (또는 .cursor/skills/configure-multiagent)
  3. 채팅: 「멀티 에이전트 시스템 구성해줘」
  4. flavor 선택: cursor · claude · codex · antigravity
  5. 터미널 init.py → validate.py ALL PASS 확인

설치 경로 분기: MultiAgentSystem monorepo는 multi-agent-starter/plugins/.../init.py 경로. standalone starter만 쓸 때는 upstream repo의 generator·build_zip.py를 따릅니다.

정본 발췌 (FOUR-FLAVOR-NAMING.md)

규칙: multi-agent-{flavor} — 소문자 kebab-case
금지: init.py --target multi-agent-system  (운영 정본 덮어쓰기)