agent-team-codexlisted

# Agent Team Codex Codex CLI의 실험 기능 `multi_agent`를 사용해 작업을 병렬 분배하는 운영 스킬입니다. Claude 전용 Agent Teams(Opus) 대신 Codex의 `default/explorer/worker` 역할을 기준으로 실행합니다. ## Prerequisites 1. Codex CLI `0.102.0+` 2. `config.toml`에 아래 설정: ```toml [features] multi_agent = true ``` 3. 권장 스레드 수: ```toml [agents] max_threads = 6 ``` 4. (선택) 사용자 정의 에이전트: ```toml [agents.fast_worker] description = "빠른 범위 구현 에이전트" config_file = "C:/Users/Administrator/.codex/agents/fast_worker.toml" ``` ## Modes ### 1) 섹션 모드 - 입력에 `docs/plan/*/sections/index.md` 또는 zephermine 산출물이 있는 경우 (archive/ 경로 제외) - 섹션 의존성을 Wave로 분리해 병렬 실행 ### 2) 자유 모드 - 일반 작업 요청(예: "auth 리팩토링 + 테스트") - 파일/모듈 기준으로 태스크를 직접 분해 후 병렬 실행 ## Workflow ### Step 0: 산출물 검토 (PM 게이트) > Claude 버전 agent-team의 Step 0과 동일한 역할. 설계 없이 구현을 시작하지 않는다. **섹션 모드에서 필수 확인:** 1. `plan.md` — 전체 구현 방향 파악 2. `sections/index.md` — 의존성 그래프 → Wave 분리 기준 3. `flow-diagrams/` — 공정 도면 존재 여부 (있으면 각 worker에게 담당 노드 배분) 4. 보조 문서 매핑: - `api-spec.md` → API 관련 worker에게 전달 - `db-schema.md` → DB 관련 worker에게 전달 - `design-system.md` → 프론트엔드 worker에게 전달 5. 각 section의 **Acceptance Criteria** 추출 → 마스터 체크리스트로 통합 **자유 모드에서는 건너뜀.** ### Step 1: 작업 분해 1. 목표를 3~8개의 독립 태스크로 분할 2. 태스크별 담당 파일 범위를 고정 3. 의존성 있는 태스크는 후행 Wave로 배치 상세 규칙: `references/role-mapping.md` ### Step 2: 역할 매칭 - `explorer`: 분석, 리스크 점검, 편집 금지 - `worker`: 구현/수정/테스트 - `default`: 조율, 병합 판단, 최종 보고 ### Step 3: 에이전트 스폰 Codex 프롬프트에서 자연어로 spawn 지시를 보냅니다. 템플릿은 `references/prompt-templates.md`를 사용합니다. 핵심 규칙: