name

configure-multiagent

description

Use when the user wants to set up / scaffold / install a file-based multi-agent orchestration system in a folder. Triggers on "멀티 에이전트 시스템 구성해줘", "멀티에이전트 세팅", "멀티 에이전트 시스템 만들어줘", "set up a multi-agent system", "configure multi-agent orchestration here". Scaffolds the system (approval gate, task re-entry protocol, topology patterns, invariant self-check) for Claude Code, Codex, or Antigravity via a deterministic generator.

Configure MultiAgent System

이 스킬은 file-as-memory 멀티에이전트 오케스트레이션 시스템을 대상 폴더에 생성한다. 직접 파일을 손으로 쓰지 말 것 — 반드시 이 스킬 폴더에 함께 들어있는 결정적 생성기 generator/init.py를 실행한다 (불변식·일관성 보장).

절차

flavor 확인 — 사용자에게 묻는다(또는 현재 호스트로 제안):
- claude — Claude Code 오케스트레이터 (워커: claude-main / codex-main / codex-critic / gemini)
- codex — Codex 오케스트레이터 (워커: codex-main / claude-critic / gemini)
- antigravity — Antigravity 오케스트레이터 (Gemini 3.1 Pro High; 워커: claude-main / codex-main / codex-critic, 멀티모달은 오케스트레이터 직접)
대상 폴더 확인 — 어디에 설치할지 묻는다. (상위 폴더 오인 주의 — 정확한 경로를 확인받는다.)
생성기 위치 — generator/는 이 SKILL.md와 같은 폴더 안에 있다(스킬 자기완결). 호스트별 분기 불필요 — 이 스킬 폴더 기준 ./generator/init.py. (Claude는 $CLAUDE_PLUGIN_ROOT/skills/configure-multiagent/generator/init.py로 해석됨.)
실행 — 확인 후 (이 스킬 폴더의 generator 경로로):
```
python3 "<이 스킬 폴더>/generator/init.py" --flavor <claude|codex|antigravity> --target "<대상폴더>" --yes
```
대화형으로 진행하려면 인자 없이 실행하면 메뉴가 뜬다.
결과 보고 — init.py가 끝에 validate.py를 자동 실행한다. 그 PASS/FAIL을 그대로 사용자에게 보고한다. FAIL이 하나라도 있으면 "완료"라고 말하지 말 것.
knot·요금가드 안내(선택) — 사용자가 knot 지식 vault나 goal 요금가드를 찾으면 알린다: 두 구성의 설치는 v3.0.0부터 loadout 카탈로그(https://github.com/netwaif/loadout) 담당이다("CLAUDE.md 구성 골라 담아줘"). knot 능동 스킬(save/ingest/query/lint)은 v3.1.0부터 knot 자체 플러그인이 배포한다(마켓플레이스에 netwaif/knot 추가). 가드 배선 자산(claude Stop 훅·codex 워처)도 v3.2.0부터 loadout guard 품목이 전부 제공한다(codex는 --flavor codex).

동작 보장

결정적: 번들 템플릿을 그대로 복사. 모델이 시스템 파일을 창작하지 않는다.
안전: 대상에 기존 tasks/·_local/ 사용자 데이터가 있으면 보존(update 모드). 기존 지침파일(CLAUDE.md/AGENTS.md)은 덮어쓰기 전 .multiagent-bak으로 백업하고, loadout store 조각 블록()은 새 지침파일 끝에 재부착한다.
쓰기 권한: 파일 생성이므로 쓰기 권한이 필요하다. Codex에서는 workspace-write + 승인이 필요할 수 있다 — 막히면 사용자에게 권한을 안내한다.

Do NOT

시스템 파일(CLAUDE.md/AGENTS.md, _shared/*, _templates/*)을 직접 작성·수정하지 말 것. 항상 init.py로 생성.
플러그인 자신의 폴더나 generator/templates/(이 스킬 폴더 안) 안에 설치하지 말 것 (init.py가 막지만 시도도 금지).
validate FAIL을 숨기거나 "대충 됐다"고 보고하지 말 것.

Configure MultiAgent System

절차

flavor 확인 — 사용자에게 묻는다(또는 현재 호스트로 제안):

claude — Claude Code 오케스트레이터 (워커: claude-main / codex-main / codex-critic / gemini)
codex — Codex 오케스트레이터 (워커: codex-main / claude-critic / gemini)
antigravity — Antigravity 오케스트레이터 (Gemini 3.1 Pro High; 워커: claude-main / codex-main / codex-critic, 멀티모달은 오케스트레이터 직접)

대상 폴더 확인 — 어디에 설치할지 묻는다. (상위 폴더 오인 주의 — 정확한 경로를 확인받는다.)

생성기 위치 — generator/는 이 SKILL.md와 같은 폴더 안에 있다(스킬 자기완결). 호스트별 분기 불필요 — 이 스킬 폴더 기준 ./generator/init.py. (Claude는 $CLAUDE_PLUGIN_ROOT/skills/configure-multiagent/generator/init.py로 해석됨.)

실행 — 확인 후 (이 스킬 폴더의 generator 경로로):

python3 "<이 스킬 폴더>/generator/init.py" --flavor <claude|codex|antigravity> --target "<대상폴더>" --yes

대화형으로 진행하려면 인자 없이 실행하면 메뉴가 뜬다.

결과 보고 — init.py가 끝에 validate.py를 자동 실행한다. 그 PASS/FAIL을 그대로 사용자에게 보고한다. FAIL이 하나라도 있으면 "완료"라고 말하지 말 것.

knot·요금가드 안내(선택) — 사용자가 knot 지식 vault나 goal 요금가드를 찾으면 알린다: 두 구성의 설치는 v3.0.0부터 loadout 카탈로그(https://github.com/netwaif/loadout) 담당이다("CLAUDE.md 구성 골라 담아줘"). knot 능동 스킬(save/ingest/query/lint)은 v3.1.0부터 knot 자체 플러그인이 배포한다(마켓플레이스에 netwaif/knot 추가). 가드 배선 자산(claude Stop 훅·codex 워처)도 v3.2.0부터 loadout guard 품목이 전부 제공한다(codex는 --flavor codex).

동작 보장

결정적: 번들 템플릿을 그대로 복사. 모델이 시스템 파일을 창작하지 않는다.

안전: 대상에 기존 tasks/·_local/ 사용자 데이터가 있으면 보존(update 모드). 기존 지침파일(CLAUDE.md/AGENTS.md)은 덮어쓰기 전 .multiagent-bak으로 백업하고, loadout store 조각 블록()은 새 지침파일 끝에 재부착한다.

쓰기 권한: 파일 생성이므로 쓰기 권한이 필요하다. Codex에서는 workspace-write + 승인이 필요할 수 있다 — 막히면 사용자에게 권한을 안내한다.

Do NOT

시스템 파일(CLAUDE.md/AGENTS.md, _shared/*, _templates/*)을 직접 작성·수정하지 말 것. 항상 init.py로 생성.

플러그인 자신의 폴더나 generator/templates/(이 스킬 폴더 안) 안에 설치하지 말 것 (init.py가 막지만 시도도 금지).

validate FAIL을 숨기거나 "대충 됐다"고 보고하지 말 것.