@jjlabsio/claude-crew 0.1.30 → 0.1.32

package/skills/crew-dev/SKILL.md

@@ -43,17 +43,48 @@ Agent(subagent_type="{role}", model="{model}", description="...", prompt="...")
 
 **codex provider:**
 ```
-Bash("codex exec --model {model} -c model_reasoning_effort=\"{reasoning}\" --dangerously-bypass-approvals-and-sandbox \"{prompt}\" < /dev/null")
+Bash("node \"${CLAUDE_PLUGIN_ROOT}/scripts/crew-codex-companion.mjs\" task --json {writeFlag} --expect-crew-result --model {model} --effort {reasoning} --prompt-file {promptFile}")
 ```
-- 프롬프트가 길면 임시 파일에 저장 후 `cat`으로 전달한다.
+- 프롬프트는 임시 파일에 저장하고 `--prompt-file`로 전달한다.
+- `writeFlag`는 `data/provider-catalog.json`의 `agent_runtime.{role}.codex_sandbox`가 `workspace-write`일 때만 `--write`로 설정한다. 기본값은 read-only이며 `dev`만 workspace-write다.
 - Codex는 CWD 기준으로 작업하므로 워크트리 안에서 실행한다.
-- Codex의 stdout에서 결과를 캡처한다.
+- Codex app-server thread id와 stdout에서 결과를 캡처한다.
+- 같은 Codex 작업을 이어갈 때는 `--resume-last`를 사용한다.
 
 **codex provider 제약:**
 - Codex는 Claude Code의 Read/Edit/Glob 도구가 아닌 자체 도구를 사용한다.
-- Codex 에이전트는 `.crew/` 파일에 직접 접근할 수 없으므로, 프롬프트에 필요한 내용을 인라인으로 주입해야 한다.
+- Codex 에이전트는 `.crew/` 접근 정책을 우회하면 안 된다. 필요한 `.crew/` 내용은 오케스트레이터가 프롬프트에 인라인으로 주입한다.
 - Codex dev-log.md 작성: Codex stdout을 오케스트레이터가 파싱하여 dev-log.md를 생성한다.
 
+### AgentResult 공통 프로토콜
+
+Codex provider를 사용하는 모든 에이전트는 마지막에 아래 블록을 반드시 출력한다. 오케스트레이터는 `--expect-crew-result` payload의 `crewAgentResult`를 파싱하여 상태별 후속 액션을 수행한다.
+
+```json
+<crew-agent-result>
+{
+  "status": "complete",
+  "artifact": "에이전트 최종 결과 또는 산출물",
+  "questions": [],
+  "requests": [],
+  "summary": "짧은 요약",
+  "error": null
+}
+</crew-agent-result>
+```
+
+허용 상태:
+- `complete`: `artifact`를 저장하거나 다음 단계로 전달한다.
+- `blocked_on_user`: `questions`를 `AskUserQuestion`으로 질문한 뒤 같은 에이전트를 `--resume-last`로 이어간다.
+- `needs_agent`: `requests`의 `role`/`prompt`를 `runAgent`로 실행한 뒤 결과를 같은 에이전트에 주입한다.
+- `needs_tool`: 오케스트레이터가 허용된 Claude Code 도구를 실행한 뒤 결과를 같은 에이전트에 주입한다.
+- `failed`: crash/retry/fallback/escalation 정책을 적용한다.
+
+루프 상한:
+- 한 에이전트 실행당 AgentResult 후속 루프는 최대 5회.
+- 유저 질문은 한 에이전트 실행당 최대 3회.
+- `needs_agent` 요청은 한 에이전트 실행당 최대 5개.
+
 ---
 
 ## 절대 금지
@@ -99,7 +130,7 @@ Bash("codex exec --model {model} -c model_reasoning_effort=\"{reasoning}\" --dan
 | 에이전트 | subagent_type | 볼 수 있는 것 | 차단 | 차단 근거 |
 |----------|--------------|-------------|------|----------|
 | **Dev** | dev | plan.md, contract.md | brief.md, spec.md, analysis.md | 의도 추측 방지, plan+contract에 필요 정보 포함 |
-| **CodeReviewer** | code-reviewer | git diff(직접 실행), 가드레일(인라인) | contract.md, plan.md, brief.md, spec.md, dev-log.md | 수용 기준 체리피킹 방지 (.crew/는 .gitignore 대상이므로 diff에 노출되지 않음) |
+| **CodeReviewer** | code-reviewer | git diff(직접 실행, `':!.crew/'` exclude), 가드레일(인라인) | contract.md, plan.md, brief.md, spec.md, dev-log.md | 수용 기준 체리피킹 방지 (.crew/는 git diff 호출 시 pathspec `':!.crew/'`로 명시적 exclude하여 메타 파일 노출 방지) |
 | **QA** | qa | plan.md | contract.md, brief.md, spec.md | 검증 편향 방지 |
 
 **중요**: 모든 에이전트 호출 시 반드시 `subagent_type` 파라미터를 지정해야 한다. `subagent_type`이 없으면 PreToolUse hook이 호출을 차단한다. `model` 파라미터는 생략 가능 — hook이 에이전트 정의에서 자동 주입한다.
@@ -112,13 +143,13 @@ Bash("codex exec --model {model} -c model_reasoning_effort=\"{reasoning}\" --dan
 
 **1a. Provider 설정 로드**
 
-1. `data/provider-catalog.json`을 읽어 `agent_defaults`를 로드한다.
+1. `data/provider-catalog.json`을 읽어 `agent_defaults`와 `agent_runtime`을 로드한다.
 2. `~/.claude/crew/config.json`이 있으면 `providers` 필드를 읽어 `agent_defaults`를 오버라이드한다 (유저 레벨).
 3. `{projectRoot}/.crew/config.json`이 있으면 `providers` 필드를 읽어 다시 오버라이드한다 (프로젝트 레벨, 최우선).
 4. codex provider가 하나라도 설정되어 있으면 `which codex`로 가용성을 확인한다.
-   - codex가 없으면 경고를 출력하고 해당 에이전트를 기본값(claude)으로 폴백한다.
+   - codex가 없으면 경고를 출력하고 해당 에이전트를 Claude provider의 에이전트 frontmatter 모델로 폴백한다.
 
-해석된 설정을 Phase 2, 3에서 ��용한다.
+해석된 provider/model 설정과 role별 runtime 정책을 Phase 2, 3에서 사용한다.
 
 **1b. contract.md 유효성 검사**
 
@@ -295,7 +326,12 @@ US-{k}에 해당하는 피드백만 수정한다. 다른 US의 코드를 변경
 오케스트레이터가 plan.md에서 US-{k} 섹션과 contract.md의 수용 기준을 추출하여 프롬프트에 인라인으로 주입한다.
 
 ```bash
-codex exec --model {model} -c model_reasoning_effort="{reasoning}" --dangerously-bypass-approvals-and-sandbox "$(cat <<'PROMPT'
+node "${CLAUDE_PLUGIN_ROOT}/scripts/crew-codex-companion.mjs" task --json --write --expect-crew-result --model {model} --effort "{reasoning}" --prompt-file "{promptFile}"
+```
+
+`{promptFile}` 내용:
+
+```markdown
 당신은 Dev 에이전트다. 아래 유저 스토리 US-{k}만 구현한다.
 
 ## US-{k} (plan.md에서 추출)
@@ -319,12 +355,18 @@ codex exec --model {model} -c model_reasoning_effort="{reasoning}" --dangerously
 - 기존 코드베이스의 컨벤션을 따른다.
 
 ## 완료 시 출력
-구현 요약을 출력하라:
-- 변경한 파일 목록
-- US-{k} 구현 내용 1줄 요약
-- 자체 검증 결과 (각 항목별 PASS/FAIL + 명령어 + 출력)
-PROMPT
-)" < /dev/null
+구현 요약을 출력하고, 마지막에 `<crew-agent-result>` 블록을 포함하라:
+
+<crew-agent-result>
+{
+  "status": "complete",
+  "artifact": "변경한 파일 목록, US-{k} 구현 요약, 자체 검증 결과",
+  "questions": [],
+  "requests": [],
+  "summary": "US-{k} 구현 완료",
+  "error": null
+}
+</crew-agent-result>
 ```
 
 Codex stdout을 캡처하여 dev-log.md의 US-{k} 섹션으로 추가한다.
@@ -415,7 +457,7 @@ CodeReviewer와 QA를 **동시에** 호출한다. US-k의 변경분만 검증한
 당신은 CodeReviewer 에이전트다. 코드 변경 사항의 품질을 판단한다.
 
 ## 입력
-`git diff HEAD`를 직접 실행하여 마지막 커밋 이후 변경 사항을 확인하라.
+`git diff HEAD -- ':!.crew/'`를 직접 실행하여 마지막 커밋 이후의 **코드 산출물 변경 사항만** 확인하라. (`.crew/` 디렉토리는 crew-dev 파이프라인의 메타 파일로, 본 리뷰 범위가 아니다.)
 contract.md, plan.md, brief.md, spec.md, dev-log.md는 읽지 않는다.
 코드만 보고 판단한다.
 
@@ -482,6 +524,14 @@ contract.md, brief.md, spec.md는 읽지 않는다.
 
 **병렬 실행 방법**: Phase 3과 동일 (provider 조합에 따라 Agent/Bash 병렬 호출).
 
+Codex provider인 CodeReviewer/QA는 read-only로 실행한다. `--write`를 붙이지 않는다.
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/scripts/crew-codex-companion.mjs" task --json --expect-crew-result --model {model} --effort "{reasoning}" --prompt-file "{promptFile}"
+```
+
+CodeReviewer/QA Codex 프롬프트도 마지막에 `<crew-agent-result>` 블록을 포함해야 한다. 검토/검증 결과는 `artifact`에 넣고, 판정이 불가능하면 `failed` 또는 `needs_tool`을 반환한다.
+
 **결과 저장 (오케스트레이터 직접)**:
 - CodeReviewer 결과 → `.crew/plans/{task-id}/review-report.md`
 - QA 결과 → `.crew/plans/{task-id}/qa-report.md`
@@ -591,7 +641,7 @@ CodeReviewer와 QA를 **동시에** 호출한다.
 당신은 CodeReviewer 에이전트다. 전체 코드 변경 사항의 품질을 판단한다.
 
 ## 입력
-`git diff main...HEAD`를 직접 실행하여 전체 변경 사항을 확인하라.
+`git diff main...HEAD -- ':!.crew/'`를 직접 실행하여 전체 **코드 산출물 변경 사항만** 확인하라. (`.crew/` 디렉토리는 crew-dev 파이프라인의 메타 파일로, 본 리뷰 범위가 아니다.)
 contract.md, plan.md, brief.md, spec.md, dev-log.md는 읽지 않는다.
 코드만 보고 판단한다.
 
@@ -675,7 +725,7 @@ CodeReviewer와 QA 에이전트는 read-only이므로 파일을 직접 작성하
 오케스트레이터는 CodeReviewer와 QA를 **동시에** 호출한다. provider 조합에 따라:
 
 - 둘 다 claude → Agent tool 2개를 한 번에 호출
-- 둘 다 codex → Bash tool 2개를 한 번에 호출
+- 둘 다 codex → read-only Bash tool 2개를 한 번에 호출 (`--write` 금지)
 - 혼합 → Agent + Bash를 한 번에 호출
 
 ---

package/skills/crew-interview/SKILL.md

@@ -34,6 +34,12 @@ description: 유저 요구사항을 인터뷰하여 개발 가능한 수준의 s
 
 ## 실행 순서
 
+PM 판단/질문/spec 작성 단계도 provider 설정 대상이다. 오케스트레이터는 `pm` 설정을 해석한 뒤 아래 인터뷰 로직을 PM 작업 프롬프트로 구성하여 `runAgent(role="pm", ...)`로 실행한다.
+
+- PM이 Claude provider이면 기존처럼 `AskUserQuestion`, Read/Write를 사용할 수 있다.
+- PM이 Codex provider이면 직접 질문하거나 `.crew/` 파일을 쓰지 않는다. 질문이 필요하면 `blocked_on_user`, 추가 탐색이 필요하면 `needs_agent`, 최종 spec은 `complete.artifact`로 반환한다.
+- Codex PM의 `artifact`는 오케스트레이터가 `.crew/plans/{task-id}/spec.md`로 저장한다.
+
 ### Phase 1 — 초기화 (자동)
 
 **1a. task-id 생성 + brief.md 작성**
@@ -46,7 +52,7 @@ task-id는 요청 내용에서 키워드를 추출하여 kebab-case로 생성한
 Explorer 서브에이전트를 병렬로 호출하여 프로젝트 구조를 파악한다.
 
 ```
-Agent(subagent_type="explorer", description="프로젝트 구조 탐색", prompt="...")
+runAgent(role="explorer", description="프로젝트 구조 탐색", prompt="...")
 ```
 
 탐색 목적:
@@ -124,7 +130,7 @@ NO 항목 중 **가장 선행되어야 할 것**을 선택한다.
 예: 유저가 "기존 결제 로직에 추가"라고 답하면 결제 관련 코드를 탐색.
 
 ```
-Agent(subagent_type="explorer", description="결제 관련 코드 탐색", prompt="...")
+runAgent(role="explorer", description="결제 관련 코드 탐색", prompt="...")
 ```
 
 **2e. 유저 답변 수신 + 큰 기획 갭 감지**
@@ -299,12 +305,34 @@ spec.md를 작성했습니다. 검토해주세요.
 
 ## 에이전트 호출 규칙
 
-| 에이전트 | subagent_type | 모델 | 용도 | 호출 시점 |
+오케스트레이터는 모든 에이전트를 `runAgent(role, prompt, providerConfig)` 규칙으로 호출한다.
+
+- Claude provider: `Agent(subagent_type="{role}", model="{model}", description="...", prompt="...")`
+- Codex provider: `node "${CLAUDE_PLUGIN_ROOT}/scripts/crew-codex-companion.mjs" task --json --expect-crew-result --model {model} --effort {reasoning} --prompt-file {promptFile}`
+- `data/provider-catalog.json`의 `agent_runtime.{role}.codex_sandbox`가 `workspace-write`일 때만 `--write`를 붙인다. interview 단계 에이전트는 모두 read-only다.
+- Codex provider는 `.crew/` 파일을 직접 읽거나 쓰지 않는다. 필요한 컨텍스트는 오케스트레이터가 프롬프트에 인라인 주입하고, 산출물은 `artifact`로 반환받아 오케스트레이터가 저장한다.
+
+| 에이전트 | subagent_type | 기본 provider/model | 용도 | 호출 시점 |
 |----------|--------------|------|------|----------|
-| Explorer | explorer | haiku | 코드베이스 탐색 (read-only) | Phase 1b (필수), Phase 2d (필요 시) |
-| Researcher | researcher | sonnet | 외부 조사 (WebSearch) | Phase 2 중 필요 시 |
+| Explorer | explorer | `agent_defaults.explorer` | 코드베이스 탐색 (read-only) | Phase 1b (필수), Phase 2d (필요 시) |
+| Researcher | researcher | `agent_defaults.researcher` | 외부 조사 (WebSearch) | Phase 2 중 필요 시 |
+
+**중요**: provider/model은 `.crew/config.json`, `~/.claude/crew/config.json`, `data/provider-catalog.json`의 `agent_defaults` 순서로 해석한다.
+
+Codex provider 결과는 마지막 `<crew-agent-result>` 블록으로 파싱한다.
+
+```json
+{
+  "status": "complete | blocked_on_user | needs_agent | needs_tool | failed",
+  "artifact": "최종 산출물 또는 결과",
+  "questions": [],
+  "requests": [],
+  "summary": "짧은 요약",
+  "error": null
+}
+```
 
-**중요**: 모든 에이전트 호출 시 반드시 `subagent_type` 파라미터를 지정해야 한다. `subagent_type`이 없으면 PreToolUse hook이 호출을 차단한다. `model` 파라미터는 생략 가능 — hook이 에이전트 정의에서 자동 주입한다.
+`blocked_on_user`는 오케스트레이터가 `AskUserQuestion`으로 처리하고, `needs_agent`는 요청된 role을 다시 `runAgent`로 실행한 뒤 결과를 원래 에이전트에 `--resume-last`로 주입한다.
 
 ---
 

package/skills/crew-plan/SKILL.md

@@ -40,6 +40,12 @@ crew-interview가 생성한 spec.md를 입력으로 받아 **HOW(어떻게 만
 
 ## 실행 순서
 
+TechLead, Planner, PlanEvaluator는 모두 provider 설정 대상이다. 오케스트레이터는 각 단계에서 `runAgent(role, prompt, providerConfig)`를 사용한다.
+
+- Claude provider이면 기존 Claude Code `Agent` 호출을 사용한다.
+- Codex provider이면 read-only companion task를 사용하고, 산출물은 `<crew-agent-result>.artifact`로 반환받아 오케스트레이터가 `.crew/` 파일에 저장한다.
+- Codex TechLead/Planner가 Explorer/Researcher가 필요하면 직접 호출하지 않고 `needs_agent`를 반환한다. 오케스트레이터가 요청된 에이전트를 실행한 뒤 결과를 원래 Codex thread에 `--resume-last`로 주입한다.
+
 ### Step 1 — spec.md 유효성 검사 (오케스트레이터 직접)
 
 `.crew/plans/{task-id}/spec.md`를 확인한다.
@@ -58,9 +64,9 @@ spec.md가 없거나 비어 있습니다. crew-interview를 먼저 실행해야
 
 ### Step 2 — TechLead 에이전트 실행
 
-**모델**: opus
+**provider/model**: 설정 resolver가 결정한다 (기본값: `agent_defaults.techlead`).
 
-호출:
+Claude provider 호출 예:
 
 ```
 Agent(subagent_type="techlead", description="TechLead: {task-id} 사전 분석", prompt="...")
@@ -79,14 +85,14 @@ WHAT(무엇을 만드는가)은 이미 정의되어 있으므로, HOW(어떻게
 
 ## 서브에이전트 호출
 - Explorer (Haiku): 코드베이스 탐색. 항상 호출. 병렬 2-3개로 호출하라.
-  Agent(subagent_type="explorer", description="코드베이스 탐색: {탐색 대상}", prompt="...")
+  runAgent(role="explorer", description="코드베이스 탐색: {탐색 대상}", prompt="...")
   **필수 탐색 항목**: 테스트 인프라도 반드시 탐색한다. Explorer 중 1개는 다음을 확인:
   - 테스트 프레임워크 설정 파일 (jest.config.*, vitest.config.*, pytest.ini 등)
   - 대표적인 테스트 파일 2-3개의 패턴
   - 커버리지 설정 여부
   - 테스트 실행 스크립트 (package.json scripts 등)
 - Researcher (Sonnet): 외부 리서치. 필요시만 호출.
-  Agent(subagent_type="researcher", description="외부 리서치: {리서치 대상}", prompt="...")
+  runAgent(role="researcher", description="외부 리서치: {리서치 대상}", prompt="...")
   **외부 API/서비스가 관련된 경우**: spec.md에 언급된 각 외부 대상(엔드포인트, 서비스, 플랫폼)에 대해 **개별적으로** 문서/인터페이스를 조사하라. 하나의 대상에 대한 문서를 다른 대상에 일반화하지 않는다. 문서가 확인되지 않는 대상은 "미검증 인터페이스"로 명시한다.
 
 ## 출력
@@ -152,9 +158,9 @@ TechLead의 analysis.md에서 테스트 인프라 섹션을 확인한 후, 오
 
 ### Step 3 — Planner 에이전트 실행
 
-**모델**: opus
+**provider/model**: 설정 resolver가 결정한다 (기본값: `agent_defaults.planner`).
 
-호출:
+Claude provider 호출 예:
 
 ```
 Agent(subagent_type="planner", description="Planner: {task-id} 구현 계획", prompt="...")
@@ -258,9 +264,9 @@ plan.md 최상단에 "이전 피드백 반영" 섹션을 추가한다.
 
 ### Step 4 — PlanEvaluator 에이전트 실행
 
-**모델**: sonnet (하드 임계값 판정에서 Opus 합리화 방지)
+**provider/model**: 설정 resolver가 결정한다 (기본값: `agent_defaults.plan-evaluator`).
 
-호출:
+Claude provider 호출 예:
 
 ```
 Agent(subagent_type="plan-evaluator", description="PlanEvaluator: {task-id} 계획 검증", prompt="...")
@@ -307,7 +313,7 @@ Agent(subagent_type="plan-evaluator", description="PlanEvaluator: {task-id} 계
 
 ## E3 코드 참조 확인
 Explorer 서브에이전트를 호출하여 plan.md에서 참조하는 파일/모듈이 존재하는지 확인하라.
-Agent(subagent_type="explorer", description="코드 참조 확인: {파일 목록 요약}", prompt="plan.md에서 참조하는 다음 파일/모듈이 존재하는지 확인하라: {파일 목록}")
+runAgent(role="explorer", description="코드 참조 확인: {파일 목록 요약}", prompt="plan.md에서 참조하는 다음 파일/모듈이 존재하는지 확인하라: {파일 목록}")
 
 ## 출력
 아래 형식으로 검증 결과를 텍스트로 반환하라. 파일을 직접 작성하지 않는다.
@@ -486,14 +492,36 @@ Planner + PlanEvaluator 사이클은 최대 5회 (초기 1회 + retry 최대 4
 
 ## 에이전트 호출 컨텍스트 규칙
 
-| 에이전트 | subagent_type | 모델 | 주입할 파일 | 차단할 파일 |
+오케스트레이터는 모든 에이전트를 `runAgent(role, prompt, providerConfig)` 규칙으로 호출한다.
+
+- Claude provider: `Agent(subagent_type="{role}", model="{model}", description="...", prompt="...")`
+- Codex provider: `node "${CLAUDE_PLUGIN_ROOT}/scripts/crew-codex-companion.mjs" task --json --expect-crew-result --model {model} --effort {reasoning} --prompt-file {promptFile}`
+- `data/provider-catalog.json`의 `agent_runtime.{role}.codex_sandbox`가 `workspace-write`일 때만 `--write`를 붙인다. plan 단계 에이전트는 모두 read-only다.
+- Codex provider는 `.crew/` 파일을 직접 읽거나 쓰지 않는다. 필요한 `spec.md`, `analysis.md`, `plan.md`, `review-{n}.md` 내용은 오케스트레이터가 프롬프트에 인라인 주입한다.
+
+| 에이전트 | subagent_type | 기본 provider/model | 주입할 파일 | 차단할 파일 |
 |----------|--------------|------|------------|------------|
-| TechLead | techlead | opus | spec.md | — |
-| Planner (첫 번째) | planner | opus | spec.md + analysis.md | brief.md |
-| Planner (retry) | planner | opus | spec.md + analysis.md + review-{n}.md | brief.md |
-| PlanEvaluator | plan-evaluator | sonnet | spec.md + analysis.md + plan.md | brief.md |
+| TechLead | techlead | `agent_defaults.techlead` | spec.md | — |
+| Planner (첫 번째) | planner | `agent_defaults.planner` | spec.md + analysis.md | brief.md |
+| Planner (retry) | planner | `agent_defaults.planner` | spec.md + analysis.md + review-{n}.md | brief.md |
+| PlanEvaluator | plan-evaluator | `agent_defaults.plan-evaluator` | spec.md + analysis.md + plan.md | brief.md |
+
+**중요**: provider/model은 `.crew/config.json`, `~/.claude/crew/config.json`, `data/provider-catalog.json`의 `agent_defaults` 순서로 해석한다. Claude provider는 `Agent(subagent_type=..., model=...)`로 호출하고, Codex provider는 `scripts/crew-codex-companion.mjs task`로 호출한다.
+
+Codex provider 결과는 마지막 `<crew-agent-result>` 블록으로 파싱한다.
+
+```json
+{
+  "status": "complete | blocked_on_user | needs_agent | needs_tool | failed",
+  "artifact": "최종 산출물 또는 결과",
+  "questions": [],
+  "requests": [],
+  "summary": "짧은 요약",
+  "error": null
+}
+```
 
-**중요**: 모든 에이전트 호출 시 반드시 `subagent_type` 파라미터를 지정해야 한다. `subagent_type`이 없으면 PreToolUse hook이 호출을 차단한다. `model` 파라미터는 생략 가능 — hook이 에이전트 정의에서 자동 주입한다.
+`blocked_on_user`는 오케스트레이터가 `AskUserQuestion`으로 처리한다. `needs_agent`는 Explorer/Researcher 등 요청된 role을 `runAgent`로 실행한 뒤 결과를 원래 에이전트에 `--resume-last`로 주입한다. 한 에이전트 실행의 후속 루프는 최대 5회다.
 
 ---
 

package/skills/crew-setup/SKILL.md

@@ -141,13 +141,19 @@ git rev-parse --show-toplevel
 
 `data/provider-catalog.json`을 읽어 사용 가능한 provider와 model 목록을 로드한다.
 
+카탈로그의 역할:
+- `claude.models`: 선택 가능한 Claude 모델 ID
+- `codex.models`: 선택 가능한 Codex 모델/reasoning 조합
+- `agent_defaults`: 에이전트별 기본 provider/model
+- `agent_runtime`: 에이전트별 Codex sandbox 정책 (`dev`만 `workspace-write`, 나머지는 `read-only`)
+
 ### 3c. Codex CLI 가용성 확인
 
 ```bash
 which codex
 ```
 
-- codex가 없으면: "Codex CLI가 설치되어 있지 않습니다. 모든 에이전트가 Claude를 사용합니다." 안내 후 Step 3를 스킵한다.
+- codex가 없으면: "Codex CLI가 설치되어 있지 않습니다. Codex provider 선택지는 표시하지 않습니다." 안내 후 Claude 모델만 설정한다.
 - codex가 있으면: 계속 진행한다.
 
 ### 3d. 기존 설정 표시
@@ -156,8 +162,14 @@ Step 3a에서 판별된 config 경로의 파일이 있으면 현재 설정을
 
 ```
 현재 에이전트 설정:
-  - dev: claude / opus (기본값)
-  - code-reviewer: claude / opus (기본값)
+  - pm: claude / opus (기본값)
+  - techlead: claude / opus (기본값)
+  - planner: claude / opus (기본값)
+  - plan-evaluator: claude / sonnet (기본값)
+  - explorer: claude / haiku (기본값)
+  - researcher: claude / sonnet (기본값)
+  - dev: codex / gpt-5.5 medium (기본값)
+  - code-reviewer: codex / gpt-5.5 medium (기본값)
   - qa: claude / sonnet (기본값)
 ```
 
@@ -167,46 +179,37 @@ Step 3a에서 판별된 config 경로의 파일이 있으면 현재 설정을
 
 ```
 설정을 변경할 에이전트를 선택하세요 (쉼표 구분, 엔터 = 스킵):
-  dev, code-reviewer, qa
+  pm, techlead, planner, plan-evaluator, explorer, researcher, dev, code-reviewer, qa
 ```
 
 - 사용자가 엔터만 누르거나 "없음"/"스킵"을 입력하면 Step 3를 종료한다.
-- 예시 입력: `dev`, `dev, code-reviewer`
+- 예시 입력: `planner`, `dev, code-reviewer`
 
 ### 3f. 선택된 에이전트별 설정
 
 선택된 각 에이전트에 대해 순차적으로:
 
-**Provider 선택:**
-```
-── {agent} ──
-Provider:
-  [1] claude
-  [2] codex
-```
+**Model 선택:**
 
-**Model 선택 (provider에 따라 목록이 다름):**
+카탈로그에서 `status: active` 모델 조합을 번호 목록으로 표시한다. 모델 설명은 표시하지 않고 provider/model/reasoning ID만 보여준다. 첫 항목은 항상 기본값이다.
 
-카탈로그에서 해당 provider의 models 배열을 번호 목록으로 표시한다. 1번이 추천.
-
-claude 선택 시:
 ```
 Model:
-  [1] Opus — 최고 품질, 복잡한 구현 (추천)
-  [2] Sonnet — 빠르고 저렴, Opus급 성능
-  [3] Haiku — 최저 비용, 단순 태스크
-```
-
-codex 선택 시:
-```
-Model:
-  [1] GPT-5.4 xhigh (추천) — 최고 성능, 토큰 多
-  [2] GPT-5.4 high — 고성능, 균형잡힌 비용
-  [3] GPT-5.4 medium — 빠르고 저렴
-  [4] o3 high — 추론 특화
-  [5] o3 medium — 추론 특화, 저비용
-  [6] GPT-5.4 Mini — 최저 비용
-```
+  [1] default: {default provider} / {default model} {default reasoning}
+  [2] claude / opus
+  [3] claude / claude-opus-4-7
+  [4] claude / claude-opus-4-6
+  [5] claude / sonnet
+  [6] claude / claude-sonnet-4-6
+  [7] claude / haiku
+  [8] claude / claude-haiku-4-5
+  [9] codex / gpt-5.5 / xhigh
+  [10] codex / gpt-5.5 / high
+  [11] codex / gpt-5.5 / medium
+  ...
+```
+
+codex가 설치되어 있지 않으면 codex 항목은 제외한다.
 
 ### 3g. 설정 저장
 
@@ -226,20 +229,21 @@ Model:
 ```json
 {
   "providers": {
-    "dev": { "provider": "codex", "model": "gpt-5.4", "reasoning": "xhigh" }
+    "planner": { "provider": "codex", "model": "gpt-5.5", "reasoning": "high" }
   }
 }
 ```
 
 - claude provider일 때: `reasoning` 필드 생략
 - codex provider일 때: 카탈로그의 `reasoning` 값 포함 (`null`이면 생략)
+- `agent_runtime`은 유저 config에 저장하지 않는다. runtime 권한은 플러그인 카탈로그 정책을 따른다.
 
 ### 3h. 확인 메시지
 
 ```
 ✓ Provider 설정 완료:
-  - dev: codex / gpt-5.4 xhigh
-  - code-reviewer: claude / opus (기본값)
+  - planner: codex / gpt-5.5 high
+  - dev: codex / gpt-5.5 medium (기본값)
   - qa: claude / sonnet (기본값)
 
 설정 파일: ~/.claude/crew/config.json (유저 레벨 — 모든 프로젝트 공유)