configure-multiagent

Configure MultiAgent System

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

절차

1. 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, 멀티모달은 오케스트레이터 직접)
2. 대상 폴더 확인 — 어디에 설치할지 묻는다. (상위 폴더 오인 주의 — 정확한 경로를 확인받는다.)
3. 생성기 위치 — generator/는 이 SKILL.md와 같은 폴더 안에 있다(스킬 자기완결). 호스트별 분기 불필요 — 이 스킬 폴더 기준 ./generator/init.py. (Claude는 $CLAUDE_PLUGIN_ROOT/skills/configure-multiagent/generator/init.py로 해석됨.)
4. 실행 — 확인 후 (이 스킬 폴더의 generator 경로로):

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

   대화형으로 진행하려면 인자 없이 실행하면 메뉴가 뜬다.
5. 결과 보고 — init.py가 끝에 validate.py를 자동 실행한다. 그 PASS/FAIL을 그대로 사용자에게 보고한다. FAIL이 하나라도 있으면 "완료"라고 말하지 말 것.
6. 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 조각 블록(<!-- store:*:start/end -->)은 새 지침파일 끝에 재부착한다.
• 쓰기 권한: 파일 생성이므로 쓰기 권한이 필요하다. Codex에서는 workspace-write + 승인이 필요할 수 있다 — 막히면 사용자에게 권한을 안내한다.

Do NOT

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