agent-team-codex

Agent Team Codex

Codex CLI의 stable multi-agent 기능을 사용해 작업을 병렬 분배하는 운영 스킬입니다. Codex의 default/explorer/worker 역할을 기준으로 실행하며 특정 모델을 강제하지 않습니다.

Prerequisites

1. 현재 Codex에서 subagent 도구가 노출되는지 확인합니다. 현행 Codex는 [agents].enabled 기본값이 true입니다.
2. 사용자가 명시적으로 비활성화한 경우 그 선택을 존중하고 메인 컨텍스트에서 Wave를 순차 실행합니다.
3. 동시성 상한을 사용자가 조정하려는 경우에만 현재 설정명을 사용합니다:

[agents]
max_concurrent_threads_per_session = 6

사용자 정의 .toml agent는 필요하지 않습니다. 고유한 sandbox·MCP·모델 계약이 입증된 경우에만 별도 opt-in으로 추가합니다.

Source-only internal module resolution (mandatory)

code-reviewer와 조건부 orchestrator는 이 하네스가 내부 정책으로 읽는 source-only 모듈입니다. 등록된 스킬이나 slash command로 호출하지 않습니다.

각 선택된 모듈을 다음 순서로 해석하고 처음 확인된 exact SKILL.md 파일 하나를 읽습니다.

1. 현재 프로젝트의 skills/{name}/SKILL.md가 실제로 있으면 그 exact 파일.
2. 없으면 Codex active root의 ~/.codex/skills/{name}/SKILL.md exact 파일 (명시 opt-in 설치 지원).
3. 둘 다 없으면 Codex 전역 ~/.codex/SKILLS-CATALOG.md에서 정확한 모듈명 행을 찾습니다. 행이 하나일 때만 읽을 경로에 적힌 절대 SKILL.md를 그대로 읽고, 누락·중복 행은 fail-closed입니다. 기본 경로가 보통 .olympus/source-skills 아래여도 직접 조합하거나 추측하지 않습니다.
4. module_root는 읽은 SKILL.md의 부모입니다. 모듈의 references/, scripts/, commands/는 모두 이 루트에서 해석합니다.
5. Step 6 코드 리뷰에 도달했을 때만 code_reviewer_root를 만듭니다. hard file lock, 외부 ledger, 크로스-CLI 혼합이 실제로 필요해 MCP 분기를 선택한 뒤에만 orchestrator_root를 만들고 ${orchestrator_root}/commands/workpm-mcp.md를 읽습니다.

이 exact 파일 읽기는 내부 모듈 로드입니다. 런타임 Skill 목록/레지스트리를 근거로 호출하거나 모듈 이름을 slash command로 실행하지 않습니다.

code-reviewer를 읽지 못하면 codex review 1회와 explorer의 bounded 품질·보안·타입 체크만 실행하고 policy module: NOT RUN (native fallback), gate DEGRADED를 기록합니다. orchestrator/MCP를 읽지 못하면 파일 소유권을 직렬화할 수 있는 경우에만 메인 순차 경로로 축소하고 MCP: NOT RUN을 기록합니다. hard lock이 필수이면 해당 Wave는 BLOCKED입니다. 어느 누락도 PASS로 처리하지 않습니다.

Modes

1) 섹션 모드

• 입력에 docs/plan/*/sections/index.md 또는 zephermine 산출물이 있는 경우 (archive/ 경로 제외)
• 섹션 의존성을 Wave로 분리해 병렬 실행

2) 자유 모드

• 일반 작업 요청(예: "auth 리팩토링 + 테스트")
• 파일/모듈 기준으로 태스크를 직접 분해 후 병렬 실행

조건부 MCP 정책 분기