§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 / 하네스 오케스트레이터

홈

AI Coding Tools

03 폴더 3층 구조

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

학습 블록

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):
- LAB 팀: github.com/SkoolChef/MultiAgentSystem clone → INSTALL.md
- upstream generator만: github.com/netwaif/multi-agent-starter marketplace / ZIP
플러그인 설치: multi-agent-starter 마켓플레이스 (또는 .cursor/skills/configure-multiagent)
채팅: 「멀티 에이전트 시스템 구성해줘」
flavor 선택: cursor · claude · codex · antigravity
터미널 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  (운영 정본 덮어쓰기)