@jjlabsio/claude-crew 0.1.21 → 0.1.23

package/.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
       "name": "claude-crew",
       "source": "./",
       "description": "오케스트레이터 + PM, 플래너, 개발, QA, 마케팅 에이전트 팀으로 단일 제품의 개발과 마케팅을 통합 관리",
-      "version": "0.1.21",
+      "version": "0.1.23",
       "author": {
         "name": "Jaejin Song",
         "email": "wowlxx28@gmail.com"
@@ -28,5 +28,5 @@
       "category": "workflow"
     }
   ],
-  "version": "0.1.21"
+  "version": "0.1.23"
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-crew",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "description": "1인 SaaS 개발자를 위한 멀티 에이전트 오케스트레이션 — 개발, 마케팅, 일정을 한 대화에서 통합 관리",
   "author": {
     "name": "Jaejin Song",

package/data/provider-catalog.json

@@ -0,0 +1,24 @@
+{
+  "claude": {
+    "models": [
+      { "id": "opus", "label": "Opus 4.6 — 최고 품질, 복잡한 구현", "default_for": ["dev", "code-reviewer"] },
+      { "id": "sonnet", "label": "Sonnet 4.6 — 빠르고 저렴, Opus급 성능", "default_for": ["qa"] },
+      { "id": "haiku", "label": "Haiku 4.5 — 최저 비용, 단순 태스크", "default_for": [] }
+    ]
+  },
+  "codex": {
+    "models": [
+      { "id": "gpt-5.4", "reasoning": "xhigh", "label": "GPT-5.4 xhigh (추천) — 최고 성능, 토큰 多", "default_for": ["dev", "code-reviewer"] },
+      { "id": "gpt-5.4", "reasoning": "high", "label": "GPT-5.4 high — 고성능, 균형잡힌 비용", "default_for": [] },
+      { "id": "gpt-5.4", "reasoning": "medium", "label": "GPT-5.4 medium — 빠르고 저렴", "default_for": [] },
+      { "id": "o3", "reasoning": "high", "label": "o3 high — 추론 특화", "default_for": [] },
+      { "id": "o3", "reasoning": "medium", "label": "o3 medium — 추론 특화, 저비용", "default_for": [] },
+      { "id": "gpt-5.4-mini", "reasoning": null, "label": "GPT-5.4 Mini — 최저 비용", "default_for": ["qa"] }
+    ]
+  },
+  "agent_defaults": {
+    "dev": { "provider": "claude", "model": "opus" },
+    "code-reviewer": { "provider": "claude", "model": "opus" },
+    "qa": { "provider": "claude", "model": "sonnet" }
+  }
+}

package/hud/index.mjs

@@ -21,6 +21,7 @@ import { homedir } from 'node:os';
 const RESET = '\x1b[0m';
 const bold = (s) => `\x1b[1m${s}\x1b[22m`;
 const dim = (s) => `\x1b[2m${s}\x1b[22m`;
+const subdued = (s) => `\x1b[38;5;248m${s}${RESET}`;
 const yellow = (s) => `\x1b[33m${s}\x1b[39m`;
 const red = (s) => `\x1b[31m${s}\x1b[39m`;
 const green = (s) => `\x1b[32m${s}\x1b[39m`;
@@ -237,7 +238,7 @@ function colorizeRateLimits(limits) {
   };
   const formatWindow = (label, pct, resetAt) => {
     const reset = formatResetTime(resetAt);
-    const resetStr = reset ? ` ${dim(`(${reset})`)}` : '';
+    const resetStr = reset ? ` ${subdued(`(${reset})`)}` : '';
     return `${label}:${colorize(pct)}${resetStr}`;
   };
   const parts = [];
@@ -246,6 +247,41 @@ function colorizeRateLimits(limits) {
   return parts.join(' ');
 }
 
+// ---------------------------------------------------------------------------
+// Worktree-aware transcript path resolution
+// ---------------------------------------------------------------------------
+// When Claude Code enters a worktree, stdin.transcript_path points to a
+// worktree-specific project directory whose transcript only contains events
+// after worktree entry — todos created before are lost.
+//
+// Fix: detect worktree, locate the original project transcript with the same
+// session ID, and merge todos from the original into the worktree result.
+//
+// Parallel worktrees: each gets its own transcript_path but the original
+// project transcript is shared. Each worktree merges from the same original,
+// so all see the full todo list without interfering with each other.
+function resolveOriginalTranscriptPath(transcriptPath, cwd) {
+  if (!transcriptPath || !cwd) return null;
+
+  const commonDir = gitExec('git rev-parse --git-common-dir', cwd);
+  if (!commonDir || commonDir === '.git' || commonDir.startsWith('.')) return null;
+
+  // commonDir is absolute: /path/to/main-repo/.git
+  const mainRepoPath = dirname(commonDir);
+  const transcriptFilename = basename(transcriptPath);
+  const transcriptDir = dirname(transcriptPath);
+  const projectsBase = dirname(transcriptDir);
+
+  // Convert main repo path to Claude Code project dir format:
+  // /Users/foo/myproject → -Users-foo-myproject
+  const mainProjectDirName = mainRepoPath.replace(/\//g, '-');
+  const originalPath = join(projectsBase, mainProjectDirName, transcriptFilename);
+
+  if (originalPath === transcriptPath) return null;
+  if (existsSync(originalPath)) return originalPath;
+  return null;
+}
+
 // ---------------------------------------------------------------------------
 // Transcript parsing (agents + skills)
 // ---------------------------------------------------------------------------
@@ -510,7 +546,7 @@ function renderAgentsMultiLine(agents, maxLines = 5) {
     const desc = a.description.length > 40 ? a.description.slice(0, 37) + '...' : a.description;
 
     detailLines.push(
-      `${dim(prefix)} ${cyan(name)} ${dim(model)} : ${desc} ${dim(`(${duration})`)}`
+      `${dim(prefix)} ${cyan(name)} ${subdued(model)} : ${desc} ${subdued(`(${duration})`)}`
     );
   });
 
@@ -534,7 +570,7 @@ function renderTodosLine(todos) {
 
   if (!inProgress) {
     if (completed === total && total > 0) {
-      return `${green('\u2713')} all done ${dim(`(${completed}/${total})`)}`;
+      return `${green('\u2713')} all done ${subdued(`(${completed}/${total})`)}`;
     }
     return null;
   }
@@ -542,7 +578,7 @@ function renderTodosLine(todos) {
   const content = inProgress.content.length > 50
     ? inProgress.content.slice(0, 47) + '...'
     : inProgress.content;
-  return `${yellow('\u25b8')} ${content} ${dim(`(${completed}/${total})`)}`;
+  return `${yellow('\u25b8')} ${content} ${subdued(`(${completed}/${total})`)}`;
 }
 
 // ---------------------------------------------------------------------------
@@ -628,6 +664,21 @@ async function main() {
 
   const transcript = parseTranscript(stdin.transcript_path);
 
+  // In worktrees, merge todos from the original project transcript.
+  // The worktree transcript only has events after EnterWorktree, so todos
+  // created before are missing. The original transcript has the full history.
+  // If the worktree transcript also has todos (created after worktree entry),
+  // use the worktree's todos since they are more up-to-date for that session.
+  if (transcript.todos.length === 0) {
+    const originalPath = resolveOriginalTranscriptPath(stdin.transcript_path, cwd);
+    if (originalPath) {
+      const originalTranscript = parseTranscript(originalPath);
+      if (originalTranscript.todos.length > 0) {
+        transcript.todos = originalTranscript.todos;
+      }
+    }
+  }
+
   const { headerPart, detailLines } = renderAgentsMultiLine(transcript.agents);
   if (headerPart) {
     midElements.push(headerPart);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jjlabsio/claude-crew",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "description": "1인 SaaS 개발자를 위한 멀티 에이전트 오케스트레이션 — 개발, 마케팅, 일정을 한 대화에서 통합 관리",
   "author": "Jaejin Song <wowlxx28@gmail.com>",
   "license": "MIT",
@@ -18,6 +18,7 @@
   "files": [
     ".claude-plugin/",
     "agents/",
+    "data/",
     "skills/",
     "hooks/",
     "hud/",

package/skills/crew-dev/SKILL.md

@@ -14,6 +14,47 @@ description: contract.md를 입력으로 받아 Dev + CodeReviewer + QA 파이
 
 ---
 
+## Multi-Provider 지원
+
+에이전트별로 claude 또는 codex provider를 사용할 수 있다. `/crew-setup`에서 설정한 `.crew/config.json`을 기반으로 디스패치한다.
+
+### Provider 설정 해석
+
+오케스트레이터는 Phase 1에서 `.crew/config.json`과 `data/provider-catalog.json`을 읽어 각 에이전트의 provider 설정을 결정한다.
+
+**우선순위:**
+1. `.crew/config.json`의 `providers.{role}` — 있으면 사용
+2. `data/provider-catalog.json`의 `agent_defaults.{role}` — 폴백
+
+**해석된 설정 예시:**
+```json
+{ "provider": "codex", "model": "gpt-5.4", "reasoning": "xhigh" }
+{ "provider": "claude", "model": "opus" }
+```
+
+### 디스패치 규칙
+
+**claude provider:**
+```
+Agent(subagent_type="{role}", model="{model}", description="...", prompt="...")
+```
+기존과 동일. `model` 파라미터를 설정값으로 전달한다.
+
+**codex provider:**
+```
+Bash("codex exec --model {model} -c model_reasoning_effort=\"{reasoning}\" --dangerously-bypass-approvals-and-sandbox \"{prompt}\"")
+```
+- 프롬프트가 길면 임시 파일에 저장 후 `cat`으로 전달한다.
+- Codex는 CWD 기준으로 작업하므로 워크트리 안에서 실행한다.
+- Codex의 stdout에서 결과를 캡처한다.
+
+**codex provider 제약:**
+- Codex는 Claude Code의 Read/Edit/Glob 도구가 아닌 자체 도구를 사용한다.
+- Codex 에이전트는 `.crew/` 파일에 직접 접근할 수 없으므로, 프롬프트에 필요한 내용을 인라인으로 주입해야 한다.
+- Codex dev-log.md 작성: Codex stdout을 오케스트레이터가 파싱하여 dev-log.md를 생성한다.
+
+---
+
 ## 절대 금지
 
 - 오케스트레이터가 코드를 직접 작성하지 않는다.
@@ -64,7 +105,16 @@ description: contract.md를 입력으로 받아 Dev + CodeReviewer + QA 파이
 
 ### Phase 1 — 환경 준비 (오케스트레이터 직접)
 
-**1a. contract.md 유효성 검사**
+**1a. Provider 설정 로드**
+
+1. `data/provider-catalog.json`을 읽어 `agent_defaults`를 로드한다.
+2. `.crew/config.json`이 있으면 `providers` 필드를 읽어 `agent_defaults`를 오버라이드한다.
+3. codex provider가 하나라도 설정되어 있으면 `which codex`로 가용성을 확인한다.
+   - codex가 없으면 경고를 출력하고 해당 에이전트를 기본값(claude)으로 폴백한다.
+
+해석된 설정을 Phase 2, 3에서 ��용한다.
+
+**1b. contract.md 유효성 검사**
 
 `.crew/plans/{task-id}/contract.md`를 읽는다.
 - 파일이 존재하는가?
@@ -82,17 +132,25 @@ contract.md 유효성 검사에 실패했습니다.
 [3] 이 태스크를 보류
 ```
 
-**1b. 워크트리 생성**
+**1c. 워크트리 생성**
+
+Claude Code의 `EnterWorktree` 도구를 사용한다:
+
+```
+EnterWorktree(name="feat/{task-id}")
+```
+
+워크트리 진입 후 브랜치를 `origin/main` 기준으로 리셋한다:
 
 ```bash
 git fetch origin main
-git worktree add ../{project}-worktree-feat-{task-id} -b feat/{task-id} origin/main
+git reset --hard origin/main
 ```
 
-워크트리 디렉토리로 이동한다. 이후 모든 작업은 워크트리에서 수행한다.
-환경 파일(`.env*` 등)이 있으면 복사한다.
+이후 모든 작업은 워크트리에서 수행한다.
+환경 파일(`.env*` 등)이 원본 프로젝트에 있으면 복사한다.
 
-**1c. 상태 갱신**
+**1d. 상태 갱신**
 
 contract.md의 `## 상태` 섹션을 갱신한다:
 
@@ -105,12 +163,14 @@ IN_PROGRESS — Dev 에이전트가 구현 중이다.
 
 ### Phase 2 — 구현 (Dev 에이전트)
 
-**모델**: opus
+Phase 1a에서 해석된 dev 설정에 따라 디스패치한다.
+
+#### Phase 2 — claude provider인 경우
 
 호출:
 
 ```
-Agent(subagent_type="dev", description="Dev: {task-id} 구현", prompt="...")
+Agent(subagent_type="dev", model="{설정된 모델}", description="Dev: {task-id} 구현", prompt="...")
 ```
 
 **첫 번째 실행 시 에이전트 프롬프트**:
@@ -180,6 +240,53 @@ brief.md, spec.md, analysis.md는 읽지 않는다.
 - 자체 검증 5개 모두 PASS 해야 완료를 선언할 수 있다.
 ```
 
+#### Phase 2 — codex provider인 경우
+
+오케스트레이터가 다음을 수행한다:
+
+1. plan.md와 contract.md의 내용을 읽어 프롬프트에 인라인으로 주입한다.
+2. Codex를 실행한다:
+
+```bash
+codex exec --model {model} -c model_reasoning_effort="{reasoning}" --dangerously-bypass-approvals-and-sandbox "$(cat <<'PROMPT'
+당신은 Dev 에이전트다. 아래 plan.md를 기반으로 코드를 구현한다.
+
+## plan.md
+{오케스트레이터가 plan.md 내용을 여기에 인라인 삽입}
+
+## contract.md (수용 기준)
+{오케스트레이터가 contract.md의 수용 기준 섹션을 여기에 인라인 삽입}
+
+## 작업 순서
+1. 코드베이스를 탐색하여 관련 파일을 파악한다.
+2. 유저 스토리 단위로 순차 구현한다.
+3. 모든 구현 완료 후 자체 검증을 실행한다:
+   - 빌드 성공 확인
+   - 린트 통과 확인
+   - 타입 체크 통과 확인
+   - 기존 테스트 스위트 통과 확인
+4. 자체 검증이 실패하면 직접 수정하여 통과시킨다.
+
+## 규칙
+- plan.md에 없는 것을 구현하지 않는다.
+- 자체 검증 모두 PASS 해야 완료를 선언할 수 있다.
+- 기존 코드베이스의 컨벤션을 따른다.
+
+## 완료 시 출력
+구현 요약을 마지막에 출력하라:
+- 변경한 파일 목록
+- 각 유저 스토리별 구현 내용 1줄 요약
+- 자체 검증 결과 (각 항목별 PASS/FAIL + 명령어 + 출력)
+PROMPT
+)"
+```
+
+3. Codex stdout을 캡처하여 `.crew/plans/{task-id}/dev-log.md`를 생성한다.
+
+**retry 시 (codex provider)**:
+
+동일한 패턴으로, 프롬프트에 review-report-{n}.md와 qa-report-{n}.md 내용을 인라인 삽입한다.
+
 **Phase 2 실패 조건**: Dev 에이전트가 자체 검증을 통과하지 못한 채 완료를 선언하면 에스컬레이션.
 
 ---
@@ -190,14 +297,41 @@ CodeReviewer와 QA를 **동시에** Agent tool 2개로 호출한다.
 
 #### Phase 3a — CodeReviewer
 
-**모델**: opus
+Phase 1a에서 해석된 code-reviewer 설정에 따라 디스패치한다.
 
-호출:
+**claude provider 호출:**
 
 ```
-Agent(subagent_type="code-reviewer", description="CodeReviewer: {task-id} 코드 리뷰", prompt="...")
+Agent(subagent_type="code-reviewer", model="{설정된 모델}", description="CodeReviewer: {task-id} 코드 리뷰", prompt="...")
+```
+
+**codex provider 호출:**
+
+오케스트레이터가 `git diff main...HEAD`를 실행하여 diff를 캡처한 뒤, diff와 가드레일을 프롬프트에 인라인 삽입하여 Codex를 실행한다.
+
+```bash
+codex exec --model {model} -c model_reasoning_effort="{reasoning}" --dangerously-bypass-approvals-and-sandbox "$(cat <<'PROMPT'
+당신은 CodeReviewer다. 아래 코드 변경 사항의 품질을 판단하라.
+
+## 변경 사항 (git diff)
+{오케스트레이터가 git diff 결과를 인라인 삽입}
+
+## 가드레일
+### Must
+{contract.md에서 추출한 Must 항목}
+### Must NOT
+{contract.md에서 추출한 Must NOT 항목}
+
+## 검토 항목 / 판정 규칙 / 출력 형식
+(claude provider 프롬프트와 동일)
+PROMPT
+)"
 ```
 
+Codex stdout을 캡처하여 review-report.md 내용으로 사용한다.
+
+**공통 사전 작업 (provider 무관):**
+
 오케스트레이터가 해야 할 사전 작업:
 1. contract.md에서 가드레일 섹션(Must/Must NOT)만 추출한다.
 2. 가드레일을 CodeReviewer 프롬프트에 인라인으로 주입한다.
@@ -239,12 +373,20 @@ contract.md, plan.md, brief.md, spec.md, dev-log.md는 읽지 않는다.
 
 #### Phase 3b — QA
 
-**모델**: sonnet
+Phase 1a에서 해석된 qa 설정에 따라 디스패치한다.
 
-호출:
+**claude provider 호출:**
 
 ```
-Agent(subagent_type="qa", description="QA: {task-id} 검증", prompt="...")
+Agent(subagent_type="qa", model="{설정된 모델}", description="QA: {task-id} 검증", prompt="...")
+```
+
+**codex provider 호출:**
+
+오케스트레이터가 plan.md 내용을 읽어 프롬프트에 인라인 삽입하여 Codex를 실행한다. Codex stdout을 캡처하여 qa-report.md 내용으로 사용한다.
+
+```bash
+codex exec --model {model} -c model_reasoning_effort="{reasoning}" --dangerously-bypass-approvals-and-sandbox "{QA 프롬프트 + plan.md 인라인}"
 ```
 
 에이전트 프롬프트:
@@ -290,11 +432,16 @@ CodeReviewer와 QA 에이전트는 read-only이므로 파일을 직접 작성하
 
 **Phase 3 병렬 실행 방법**:
 
-오케스트레이터는 한 번의 메시지에서 두 개의 Agent tool 호출을 동시에 수행한다:
+오케스트레이터는 CodeReviewer와 QA를 **동시에** 호출한다. provider 조합에 따라:
+
+- 둘 다 claude → Agent tool 2개를 한 번에 호출
+- 둘 다 codex → Bash tool 2개를 한 번에 호출
+- 혼합 → Agent + Bash를 한 번에 호출
 
 ```
-Agent(subagent_type="code-reviewer", description="CodeReviewer: {task-id} 코드 리뷰", prompt="...")
-Agent(subagent_type="qa", description="QA: {task-id} 검증", prompt="...")
+# 예: code-reviewer=claude, qa=codex
+Agent(subagent_type="code-reviewer", model="opus", description="CodeReviewer: {task-id}", prompt="...")
+Bash("codex exec --model gpt-5.4 ... '{QA 프롬프트}'")
 ```
 
 ---
@@ -339,7 +486,15 @@ PR: {PR URL}
 
 `.dev_loop_count` 파일이 존재하면 삭제한다.
 
-**5d. 완료 반환**
+**5d. 워크트리 종료**
+
+```
+ExitWorktree(action="remove")
+```
+
+PR push가 완료되었으므로 로컬 워크트리를 제거하고 원본 프로젝트 디렉토리로 복귀한다.
+
+**5e. 완료 반환**
 
 ```
 상태: COMPLETE
@@ -378,6 +533,7 @@ Phase 4에서 FAIL이면:
 에스컬레이션 시:
 - `.dev_loop_count` 파일을 삭제한다.
 - contract.md 상태를 `BLOCKED`으로 갱신한다.
+- `ExitWorktree(action="keep")`으로 원본 프로젝트 디렉토리로 복귀한다.
 
 **조건 2 — 같은 기준 3회 연속 실패**:
 
@@ -391,6 +547,8 @@ review-report.md와 qa-report.md에서 FAIL 항목을 확인한다.
 [3] 이 태스크를 보류
 ```
 
+에스컬레이션 시 `ExitWorktree(action="keep")`으로 원본 프로젝트 디렉토리로 복귀한다.
+
 **6c. 피드백 아카이브**
 
 `n = 카운터 + 1`

package/skills/crew-setup/SKILL.md

@@ -1,13 +1,17 @@
 ---
 name: crew-setup
-description: claude-crew 플러그인 초기 설정 — HUD statusline 설치
+description: claude-crew 플러그인 초기 설정 — HUD statusline 설치 + provider 설정
 ---
 
 ## 역할
 
-claude-crew 플러그인의 HUD statusline을 사용자 환경에 설치한다.
+claude-crew 플러그인의 초기 설정을 수행한다:
+1. HUD statusline 설치
+2. 에이전트별 provider/model 설정
 
-## 절차
+---
+
+## Step 1 — HUD statusline 설치
 
 1. `~/.claude/settings.json`을 읽는다.
 2. `statusLine` 필드를 crew HUD 스크립트로 설정한다:
@@ -23,7 +27,115 @@ claude-crew 플러그인의 HUD statusline을 사용자 환경에 설치한다.
    - 성공 시: "CREW HUD가 설치되었습니다. 다음 세션부터 statusline에 표시됩니다."
    - 실패 시: 에러 내용을 알린다.
 
-## 주의
+**주의**: `settings.json`의 다른 필드는 절대 수정하지 않는다. statusLine만 교체한다.
+
+---
+
+## Step 2 — Provider 설정
+
+에이전트별로 어떤 provider(claude/codex)와 model을 사용할지 설정한다.
+
+### 2a. 카탈로그 로드
+
+`data/provider-catalog.json`을 읽어 사용 가능한 provider와 model 목록을 로드한다.
+
+### 2b. Codex CLI 가용성 확인
+
+```bash
+which codex
+```
+
+- codex가 없으면: "Codex CLI가 설치되어 있지 않습니다. 모든 에이전트가 Claude를 사용합니다." 안내 후 Step 2를 스킵한다.
+- codex가 있으면: 계속 진행한다.
+
+### 2c. 기존 설정 표시
+
+`.crew/config.json`이 있으면 현재 설정을 표시한다. 없으면 기본값을 표시한다.
+
+```
+현재 에이전트 설정:
+  - dev: claude / opus (기본값)
+  - code-reviewer: claude / opus (기본값)
+  - qa: claude / sonnet (기본값)
+```
+
+### 2d. 설정할 에이전트 선택
+
+사용자에게 설정을 변경할 에이전트를 선택하게 한다.
+
+```
+설정을 변경할 에이전트를 선택하세요 (쉼표 구분, 엔터 = 스킵):
+  dev, code-reviewer, qa
+```
+
+- 사용자가 엔터만 누르거나 "없음"/"스킵"을 입력하면 Step 2를 종료한다.
+- 예시 입력: `dev`, `dev, code-reviewer`
+
+### 2e. 선택된 에이전트별 설정
+
+선택된 각 에이전트에 대해 순차적으로:
+
+**Provider 선택:**
+```
+── {agent} ──
+Provider:
+  [1] claude
+  [2] codex
+```
+
+**Model 선택 (provider에 따라 목록이 다름):**
+
+카탈로그에서 해당 provider의 models 배열을 번호 목록으로 표시한다. 1번이 추천.
+
+claude 선택 시:
+```
+Model:
+  [1] Opus 4.6 — 최고 품질, 복잡한 구현 (추천)
+  [2] Sonnet 4.6 — 빠르고 저렴, Opus급 성능
+  [3] Haiku 4.5 — 최저 비용, 단순 태스크
+```
+
+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 — 최저 비용
+```
+
+### 2f. 설정 저장
+
+선택 결과를 `.crew/config.json`에 저장한다.
+
+**규칙:**
+- 기본값과 동일한 설정은 저장하지 않는다 (기본값은 `agent_defaults` 참조).
+- 기본값과 다른 설정만 `providers` 객체에 기록한다.
+- 기존 `.crew/config.json`이 있으면 `providers` 필드만 머지한다 (다른 필드 보존).
+- `.crew/` 디렉토리가 없으면 생성한다.
+
+**저장 형식:**
+
+```json
+{
+  "providers": {
+    "dev": { "provider": "codex", "model": "gpt-5.4", "reasoning": "xhigh" }
+  }
+}
+```
+
+- claude provider일 때: `reasoning` 필드 생략
+- codex provider일 때: 카탈로그의 `reasoning` 값 포함 (`null`이면 생략)
+
+### 2g. 확인 메시지
+
+```
+✓ Provider 설정 완료:
+  - dev: codex / gpt-5.4 xhigh
+  - code-reviewer: claude / opus (기본값)
+  - qa: claude / sonnet (기본값)
 
-- `settings.json`의 다른 필드는 절대 수정하지 않는다.
-- statusLine만 교체한다.
+설정 파일: .crew/config.json
+```