@walwal-harness/cli 4.0.0 → 5.0.1

package/bin/init.js

@@ -16,6 +16,7 @@ const { execSync } = require('child_process');
 const PKG_ROOT = path.resolve(__dirname, '..');
 const args = process.argv.slice(2);
 const subcommand = args.find(a => !a.startsWith('-')) || null;
+const subcommandArgs = args.filter(a => !a.startsWith('-') && a !== subcommand);
 const isAuto = args.includes('--auto');
 const isForce = args.includes('--force');
 const isHelp = args.includes('--help') || args.includes('-h');
@@ -100,14 +101,26 @@ function scaffoldHarness() {
   ensureDir(path.join(HARNESS_DIR, 'archive'));
   ensureDir(path.join(HARNESS_DIR, 'gotchas'));
 
-  // Copy gotchas initial files
+  // Copy gotchas — ALWAYS overwrite system templates, preserve user custom entries
   const gotchasSrc = path.join(PKG_ROOT, 'gotchas');
   if (fs.existsSync(gotchasSrc)) {
+    const CUSTOM_MARKER = '## Custom Gotchas';
     const files = fs.readdirSync(gotchasSrc);
     for (const file of files) {
-      const dest = path.join(HARNESS_DIR, 'gotchas', file);
-      if (!fileExists(dest) || isForce) {
-        copyFile(path.join(gotchasSrc, file), dest);
+      const destPath = path.join(HARNESS_DIR, 'gotchas', file);
+      const srcPath = path.join(gotchasSrc, file);
+      if (fileExists(destPath) && file.endsWith('.md')) {
+        // Preserve user-added custom section
+        const existing = fs.readFileSync(destPath, 'utf8');
+        const customIdx = existing.indexOf(CUSTOM_MARKER);
+        const userCustom = customIdx !== -1 ? existing.substring(customIdx) : '';
+        let newContent = fs.readFileSync(srcPath, 'utf8');
+        if (userCustom) {
+          newContent = newContent.trimEnd() + '\n\n' + userCustom;
+        }
+        fs.writeFileSync(destPath, newContent);
+      } else {
+        copyFile(srcPath, destPath);
       }
     }
   }
@@ -129,6 +142,25 @@ function scaffoldHarness() {
     }
   }
 
+  // Migrate progress.json v1 → v2 (add mode + team_state fields)
+  const progressPath = path.join(HARNESS_DIR, 'progress.json');
+  if (fileExists(progressPath)) {
+    try {
+      const progress = JSON.parse(fs.readFileSync(progressPath, 'utf8'));
+      if (!progress.version || progress.version < 2) {
+        progress.version = 2;
+        progress.mode = progress.mode || 'solo';
+        if (!progress.team_state) {
+          progress.team_state = { active_teams: 0, paused_at: null, resume_from: null };
+        }
+        fs.writeFileSync(progressPath, JSON.stringify(progress, null, 2) + '\n');
+        log('progress.json migrated to v2 (mode + team_state added)');
+      }
+    } catch (e) {
+      log('WARNING: Could not migrate progress.json');
+    }
+  }
+
   // config.json — ALWAYS update (harness system file, not user data)
   // But preserve user's custom settings (pre_eval_gate.frontend_cwd, behavior, etc.)
   const configSrc = path.join(PKG_ROOT, 'assets', 'templates', 'config.json');
@@ -286,6 +318,42 @@ function installScripts() {
   log('Scripts installation complete');
 }
 
+// ─────────────────────────────────────────
+// 3a. Commands → .claude/commands/
+// ─────────────────────────────────────────
+function installCommands() {
+  log('Installing commands to .claude/commands/...');
+
+  const commandsSrc = path.join(PKG_ROOT, 'commands');
+  if (!fs.existsSync(commandsSrc)) {
+    log('WARNING: commands/ directory not found in package');
+    return;
+  }
+
+  const commandsDest = path.join(PROJECT_ROOT, '.claude', 'commands');
+  ensureDir(commandsDest);
+
+  // Remove existing harness-* commands to prevent stale files
+  if (fs.existsSync(commandsDest)) {
+    const existing = fs.readdirSync(commandsDest);
+    for (const f of existing) {
+      if (f.startsWith('harness-')) {
+        fs.unlinkSync(path.join(commandsDest, f));
+      }
+    }
+    log('  Cleared existing harness-* commands');
+  }
+
+  // Copy all command files
+  const files = fs.readdirSync(commandsSrc).filter(f => f.endsWith('.md'));
+  for (const file of files) {
+    copyFile(path.join(commandsSrc, file), path.join(commandsDest, file));
+    log(`  Installed: /${file.replace('.md', '')}`);
+  }
+
+  log('Commands installation complete');
+}
+
 // ─────────────────────────────────────────
 // 3b. SessionStart hook
 // ─────────────────────────────────────────
@@ -615,45 +683,43 @@ function showHelp() {
 ╚══════════════════════════════════════╝
 
 Usage:
-  npx walwal-harness            Initialize project for harness engineering
-  npx walwal-harness --force    Re-initialize (overwrites existing files)
-  npx walwal-harness studio     Launch Harness Studio v3 (tmux 5-pane)
-  npx walwal-harness studio --ai  Studio v3 + AI eval summary
-  npx walwal-harness v4          Enable Agent Teams (set env var + init queue)
-  npx walwal-harness --help     Show this help
+  npx walwal-harness              Initialize project for harness engineering
+  npx walwal-harness --force      Re-initialize (overwrites existing files)
+  npx walwal-harness team         Launch Team Mode (tmux studio + auto teams)
+  npx walwal-harness team --kill  Kill Team Mode tmux session
+  npx walwal-harness --help       Show this help
+
+Modes (use inside claude/codex session):
+  /harness-solo       Solo mode — prompting-based sequential pipeline
+  /harness-team       Team mode — auto parallel Gen-Eval loop (3 teams)
+  /harness-stop       Stop Team mode (preserves queue state)
 
 What it does:
   1. Scaffolds .harness/ directory (actions, archive, gotchas, config)
   2. Installs skills to .claude/skills/ (dispatcher, planner, generators, evaluators)
-  3. Copies helper scripts to scripts/
-  4. Registers SessionStart hook (compact boot-time status)
-  5. Installs statusline (persistent 1-line status bar at terminal bottom)
-  6. Registers UserPromptSubmit hook (auto-route every prompt through harness-dispatcher)
+  3. Installs commands to .claude/commands/ (solo, team, stop)
+  4. Copies helper scripts to scripts/
+  5. Registers SessionStart + UserPromptSubmit hooks
+  6. Installs statusline (persistent 1-line status bar)
   7. Creates AGENTS.md + CLAUDE.md symlink
-  8. Checks Playwright MCP configuration
-  9. Checks recommended external skills (Vercel, design skills)
-
-Auto routing:
-  Every user prompt is routed through harness-dispatcher.
-  Per-message opt-out: say "harness skip" or "harness 없이".
-  Global disable: edit .harness/config.json → behavior.auto_route_dispatcher = false
 
 After init:
-  1. Restart Claude Code session (exit and re-enter) for skills to load
-  2. Say "하네스 엔지니어링 시작" or invoke /harness-dispatcher
+  1. Restart Claude Code session (/exit → re-enter directory)
+  2. Say "하네스 엔지니어링 시작" or /harness-dispatcher
+  3. After Planner completes: /harness-team (team) or continue prompting (solo)
 `);
 }
 
 // ─────────────────────────────────────────
 // Main
 // ─────────────────────────────────────────
-function runStudio() {
-  const useAi = args.includes('--ai') ? '--ai' : '';
+function runTeamStudio() {
+  const killMode = args.includes('--kill');
   const scriptsDir = path.join(PKG_ROOT, 'scripts');
   const tmuxScript = path.join(scriptsDir, 'harness-tmux.sh');
 
   if (!fs.existsSync(tmuxScript)) {
-    log('ERROR: harness-tmux.sh not found. Update @walwal-harness/cli to >= 3.6.0');
+    log('ERROR: harness-tmux.sh not found.');
     process.exit(1);
   }
 
@@ -664,57 +730,18 @@ function runStudio() {
     process.exit(1);
   }
 
-  const cmd = `bash "${tmuxScript}" "${PROJECT_ROOT}" ${useAi}`.trim();
-  log(`Launching Harness Studio...`);
-  execSync(cmd, { stdio: 'inherit' });
-}
-
-function runStudioV4() {
-  // Enable Agent Teams in project settings
-  const settingsPath = path.join(PROJECT_ROOT, '.claude', 'settings.json');
-  let settings = {};
-  if (fileExists(settingsPath)) {
-    try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8')); } catch (e) {}
+  if (killMode) {
+    const cmd = `bash "${tmuxScript}" --kill`;
+    execSync(cmd, { stdio: 'inherit' });
+    return;
   }
 
-  if (!settings.env) settings.env = {};
-  settings.env['CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS'] = '1';
-  ensureDir(path.dirname(settingsPath));
-  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
-
-  // Initialize feature queue if feature-list.json exists
-  const featureList = path.join(PROJECT_ROOT, '.harness', 'actions', 'feature-list.json');
-  const featureQueue = path.join(PROJECT_ROOT, '.harness', 'actions', 'feature-queue.json');
-  const queueMgr = path.join(PKG_ROOT, 'scripts', 'harness-queue-manager.sh');
-
-  if (fs.existsSync(featureList) && fs.existsSync(queueMgr)) {
-    if (!fs.existsSync(featureQueue)) {
-      log('Initializing feature queue...');
-      try { execSync(`bash "${queueMgr}" init "${PROJECT_ROOT}"`, { stdio: 'inherit' }); } catch (e) {}
-    } else {
-      log('Recovering feature queue...');
-      try { execSync(`bash "${queueMgr}" recover "${PROJECT_ROOT}"`, { stdio: 'inherit' }); } catch (e) {}
-    }
-  }
+  // Enable Agent Teams in project settings
+  installAgentTeamsEnv();
 
-  console.log('');
-  log('╔═══════════════════════════════════════════════════════════╗');
-  log('║  Agent Teams v4 ENABLED                                  ║');
-  log('╠═══════════════════════════════════════════════════════════╣');
-  log('║                                                          ║');
-  log('║  CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 set in           ║');
-  log('║  .claude/settings.json                                   ║');
-  log('║                                                          ║');
-  log('║  Next steps:                                             ║');
-  log('║  1. Restart Claude Code (/exit → re-enter)               ║');
-  log('║  2. Run Planner: "하네스 엔지니어링 시작"                 ║');
-  log('║  3. Start Teams: /harness-team-action                    ║');
-  log('║                                                          ║');
-  log('║  Or use --teammate-mode tmux for split panes:            ║');
-  log('║  $ claude --teammate-mode tmux                           ║');
-  log('║                                                          ║');
-  log('╚═══════════════════════════════════════════════════════════╝');
-  console.log('');
+  const cmd = `bash "${tmuxScript}" "${PROJECT_ROOT}" --team`;
+  log('Launching Team Mode Studio...');
+  execSync(cmd, { stdio: 'inherit' });
 }
 
 function main() {
@@ -723,13 +750,15 @@ function main() {
     return;
   }
 
-  if (subcommand === 'studio') {
-    runStudio();
+  if (subcommand === 'team') {
+    runTeamStudio();
     return;
   }
 
-  if (subcommand === 'studio-v4' || subcommand === 'v4') {
-    runStudioV4();
+  // Legacy subcommands — redirect to new equivalents
+  if (subcommand === 'studio' || subcommand === 'studio-v4' || subcommand === 'v4') {
+    log('NOTE: "studio" and "v4" subcommands are replaced by "team".');
+    runTeamStudio();
     return;
   }
 
@@ -747,6 +776,7 @@ function main() {
   scaffoldHarness();
   installSkills();
   installScripts();
+  installCommands();
   installSessionHook();
   installStatusline();
   installUserPromptSubmitHook();
@@ -760,20 +790,21 @@ function main() {
   log('');
 
   if (isAuto) {
-    // postinstall context — Claude Code is likely already running
     log('╔═══════════════════════════════════════════════════════════╗');
-    log('║  IMPORTANT: Restart Claude Code for skills to activate!  ║');
-    log('║                                                          ║');
-    log('║  Claude Code discovers skills at session startup.        ║');
-    log('║  Type /exit, then re-enter this directory to begin.      ║');
+    log('║  Restart Claude Code for skills & commands to activate!  ║');
     log('║                                                          ║');
     log('║  Then say: "하네스 엔지니어링 시작"                        ║');
     log('║  Or invoke: /harness-dispatcher                          ║');
+    log('║                                                          ║');
+    log('║  After Planner completes:                                ║');
+    log('║    /harness-team  → Team mode (auto parallel)            ║');
+    log('║    /harness-solo  → Solo mode (prompting sequential)     ║');
     log('╚═══════════════════════════════════════════════════════════╝');
   } else {
     log('Next steps:');
     log('  1. Restart Claude Code session (/exit → re-enter directory)');
-    log('  2. Say "하네스 엔지니어링 시작" or invoke /harness-dispatcher');
+    log('  2. Say "하네스 엔지니어링 시작" or /harness-dispatcher');
+    log('  3. After Planner: /harness-team (team) or keep prompting (solo)');
   }
   console.log('');
 }

package/commands/harness-solo.md

@@ -0,0 +1,68 @@
+# /harness-solo — Solo Mode 시작/전환
+
+프롬프트 기반으로 하네스 파이프라인을 순차 진행합니다.
+Team 모드에서 전환 시, 진행 중이던 피처의 상태를 보존하고 Solo로 이어갑니다.
+
+## 실행 절차
+
+### Step 1: 현재 모드 확인 + 전환
+
+```bash
+# 현재 mode 읽기
+MODE=$(jq -r '.mode // "solo"' .harness/progress.json 2>/dev/null)
+echo "현재 모드: $MODE"
+```
+
+**team → solo 전환 시:**
+```bash
+# in_progress features를 ready로 복구
+bash scripts/harness-queue-manager.sh recover .
+
+# mode를 solo로 설정
+jq '.mode = "solo" | .team_state.active_teams = 0 | .team_state.paused_at = (now | todate)' .harness/progress.json > /tmp/progress_tmp.json && mv /tmp/progress_tmp.json .harness/progress.json
+```
+
+**paused → solo 전환 시:**
+```bash
+jq '.mode = "solo"' .harness/progress.json > /tmp/progress_tmp.json && mv /tmp/progress_tmp.json .harness/progress.json
+```
+
+### Step 2: 현재 진행 상태 표시
+
+```bash
+# progress.json 상태 확인
+cat .harness/progress.json | jq '{mode, sprint, current_agent, agent_status, next_agent}'
+
+# feature-queue.json이 있으면 남은 피처 표시
+if [ -f .harness/actions/feature-queue.json ]; then
+  echo "=== Feature Queue ==="
+  bash scripts/harness-queue-manager.sh status .
+fi
+```
+
+### Step 3: 다음 에이전트 안내
+
+progress.json의 `next_agent` 필드를 확인하여 다음 단계를 안내합니다:
+
+- **next_agent = "dispatcher"** → "프롬프트로 요구사항을 입력하면 자동으로 dispatcher가 분석합니다."
+- **next_agent = "planner"** → "/harness-planner 를 호출하거나, 계획을 요청하세요."
+- **next_agent = "generator-backend"** → "/harness-generator-backend 를 호출하세요."
+- **next_agent = "generator-frontend"** → "/harness-generator-frontend 를 호출하세요."
+- **next_agent = "evaluator-functional"** → "/harness-evaluator-functional 를 호출하세요."
+- **next_agent = "evaluator-visual"** → "/harness-evaluator-visual 를 호출하세요."
+
+### Step 4: Solo 모드 진행
+
+사용자가 프롬프트로 각 에이전트 스킬을 호출하여 순차 진행합니다.
+각 에이전트 완료 시 harness-next.sh가 자동으로 다음 에이전트를 결정합니다.
+
+feature-queue.json이 존재하는 경우:
+- 피처 완료(evaluator PASS) 시 `bash scripts/harness-queue-manager.sh pass {FEATURE_ID} .`를 호출하여 공유 상태 업데이트
+- Team 모드로 전환해도 이미 완료된 피처는 skip됨
+
+## Solo 모드에서 가능한 작업
+
+- 프롬프트로 각 에이전트 순차 실행
+- 코드 직접 수정 및 디버깅
+- 피처 단위 작업 선택
+- Team 모드로 언제든 전환: `/harness-team`

package/commands/harness-stop.md

@@ -0,0 +1,53 @@
+# /harness-stop — Team Mode 중단
+
+실행 중인 Team 모드를 안전하게 중단합니다.
+진행 중인 피처는 ready 상태로 복구되어, 이후 Solo 또는 Team 모드에서 이어갈 수 있습니다.
+
+## 실행 절차
+
+### Step 1: 현재 모드 확인
+
+```bash
+MODE=$(jq -r '.mode // "solo"' .harness/progress.json 2>/dev/null)
+echo "현재 모드: $MODE"
+```
+
+- **solo** → "이미 Solo 모드입니다. Team을 시작하려면 /harness-team 을 사용하세요." 안내 후 중단.
+- **team** → Step 2로 진행.
+
+### Step 2: Queue 상태 보존
+
+```bash
+# in_progress features를 ready로 복구
+bash scripts/harness-queue-manager.sh recover .
+
+# 현재 큐 상태 출력
+bash scripts/harness-queue-manager.sh status .
+```
+
+### Step 3: 모드 전환
+
+```bash
+# mode를 paused로 설정 (team에서 명시적으로 중단)
+jq '.mode = "paused" | .team_state.active_teams = 0 | .team_state.paused_at = (now | todate)' .harness/progress.json > /tmp/progress_tmp.json && mv /tmp/progress_tmp.json .harness/progress.json
+```
+
+### Step 4: tmux 세션 정리 (선택)
+
+```bash
+# harness-studio tmux 세션이 있으면 정리
+tmux kill-session -t harness-studio 2>/dev/null && echo "tmux 세션 정리 완료" || echo "활성 tmux 세션 없음"
+```
+
+### Step 5: 재개 안내
+
+다음 안내를 사용자에게 전달합니다:
+
+```
+Team 모드가 안전하게 중단되었습니다.
+진행 중이던 피처는 ready 상태로 복구되었습니다.
+
+재개 방법:
+  /harness-team    → Team 모드 재개 (남은 피처 자동 할당)
+  /harness-solo    → Solo 모드로 전환 (프롬프트 기반 순차 진행)
+```

package/{skills/team-action/SKILL.md → commands/harness-team.md}

@@ -1,35 +1,51 @@
----
-name: harness-team-action
-description: "v4 Agent Teams 가동. Studio 레이아웃 구축 → Queue 초기화 → Gen↔Eval 분리 사이클 팀 병렬 실행. 트리거: '/harness-team-action', 'team 시작', '팀 가동'"
-disable-model-invocation: false
----
+# /harness-team — Team Mode 시작/재개
 
-# /harness-team-action — Agent Teams 가동
+Planner가 완료한 feature-list.json의 피처들을 3개 팀이 병렬로 Gen→Eval 사이클을 수행합니다.
 
-## Step 0: Studio 레이아웃 자동 구축
+## 실행 절차
 
-3-column 대시보드 레이아웃을 자동 구축합니다:
+### Step 0: 선행 조건 확인
 
 ```bash
-bash scripts/harness-studio-setup.sh .
+# Planner 아티팩트 확인
+[ -f .harness/actions/feature-list.json ] && [ -f .harness/actions/api-contract.json ] && echo "READY" || echo "NOT_READY"
 ```
 
-스크립트 출력을 확인합니다:
+- **NOT_READY** → "Planner가 먼저 완료되어야 합니다. /harness-dispatcher 또는 프롬프트로 진행하세요." 안내 후 중단.
+- **READY** → Step 1로 진행.
+
+### Step 1: 모드 전환 + Queue 초기화
 
-- **`Layout ready`** → tmux 안에서 split 완료. 바로 Step 1로.
-- **`OPENED_TERMINAL=true`** → 새 Terminal.app 창에 Studio가 자동으로 열림. 바로 Step 1로.
-- **`already set up`** → 이미 구축됨. 바로 Step 1로.
+```bash
+# progress.json에 mode=team 설정
+jq '.mode = "team" | .team_state.active_teams = 3 | .team_state.paused_at = null' .harness/progress.json > /tmp/progress_tmp.json && mv /tmp/progress_tmp.json .harness/progress.json
+
+# Queue 초기화 또는 복구
+if [ ! -f .harness/actions/feature-queue.json ]; then
+  bash scripts/harness-queue-manager.sh init .
+else
+  bash scripts/harness-queue-manager.sh recover .
+fi
+
+# Queue 상태 확인
+bash scripts/harness-queue-manager.sh status .
+```
 
-## Step 1: Queue 초기화
+### Step 2: tmux Studio 레이아웃 구축
 
 ```bash
-if [ ! -f .harness/actions/feature-queue.json ]; then bash scripts/harness-queue-manager.sh init .; else bash scripts/harness-queue-manager.sh recover .; fi && bash scripts/harness-queue-manager.sh status .
+bash scripts/harness-tmux.sh --team
 ```
 
-## Step 2: Feature 할당 (dequeue)
+스크립트 출력을 확인합니다:
+- **`Layout ready`** → tmux 레이아웃 구축 완료. Step 3로.
+- **`OPENED_TERMINAL=true`** → 새 Terminal.app 창에 Studio 레이아웃이 자동 구축됨. Step 3로.
+- **`already set up`** → 이미 구축됨. Step 3로.
+
+### Step 3: Feature 할당 (dequeue)
 
 Queue status 결과를 확인하여 `ready` 큐에 feature가 있는지 확인합니다.
-ready feature 수와 설정된 concurrency 중 작은 값만큼 팀을 생성합니다 (최대 3).
+ready feature 수와 설정된 concurrency(기본 3) 중 작은 값만큼 팀을 생성합니다.
 
 **각 팀마다** dequeue 명령으로 feature를 원자적으로 할당합니다:
 
@@ -39,7 +55,7 @@ bash scripts/harness-queue-manager.sh dequeue {TEAM_NUMBER} .
 
 dequeue 결과로 feature ID가 반환됩니다. 빈 결과면 해당 팀은 생성하지 않습니다.
 
-## Step 3: Agent 도구로 팀 생성 (Gen↔Eval 분리 사이클)
+### Step 4: Agent 도구로 팀 생성 (Gen↔Eval 분리 사이클)
 
 dequeue로 할당받은 feature마다 **Agent 도구**를 호출합니다.
 **반드시 `isolation: "worktree"`를 사용**하여 각 팀이 독립된 코드 복사본에서 작업합니다.
@@ -58,6 +74,7 @@ Agent({
 
 ```
 당신은 Harness Team-{N} 워커입니다. 하나의 Feature에 대해 Gen→Eval 사이클을 수행합니다.
+완료 후 자동으로 다음 Feature를 dequeue하여 연속 작업합니다.
 
 ## 할당된 Feature
 - Feature ID: {FEATURE_ID}
@@ -87,6 +104,7 @@ progress.log에 한 줄씩 남기세요. 대시보드는 3초마다 tail합니
 | `eval-done`  | Eval 결과 수신 | `verdict=PASS score=2.95` |
 | `result` / `pass` | PASS 확정 | `F-001 PASS — queue.pass` |
 | `fail`       | FAIL 확정(재시도/최종) | `FAIL #1 — AC-2 missing` |
+| `escalate`   | 5회 초과 실패 | `F-001 ESCALATED — user intervention required` |
 
 **progress.log 기록** (하네스 루트의 progress.log에 append):
 ```bash
@@ -145,14 +163,10 @@ logev gen-done "{FEATURE_ID} done — {변경파일수} files, {LOC} LOC"
 
 ## Phase 2: Evaluator (독립 평가 — Agent 도구 사용)
 
-**Eval 시작 로깅 (하위 단계 포함):**
+**Eval 시작 로깅:**
 ```bash
 logev eval-start "{FEATURE_ID} spawning evaluator"
 bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" update_phase {FEATURE_ID} eval "$HARNESS_ROOT"
-# Evaluator가 AC를 하나씩 검증할 때마다:
-# logev eval-check "AC-3 — POST /users returns 201"
-# 최종:
-# logev eval-done "verdict=PASS score=2.95"
 ```
 
 코드 생성이 완료되면 **별도 Agent를 생성하여 평가**합니다.
@@ -199,7 +213,7 @@ FEEDBACK: (FAIL인 경우만) 구체적 수정 지시
 
 Evaluator Agent 결과를 확인합니다:
 
-### PASS인 경우 (VERDICT: PASS, SCORE ≥ 2.80):
+### PASS인 경우 (VERDICT: PASS, SCORE >= 2.80):
 ```bash
 logev result "{FEATURE_ID} PASS score={SCORE} — merging"
 bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" pass {FEATURE_ID} "$HARNESS_ROOT"
@@ -212,20 +226,31 @@ logev fail "{FEATURE_ID} FAIL #{ATTEMPT} — {사유요약}"
 ```
 1. Evaluator의 FEEDBACK을 읽고 코드를 수정 (Phase 1로 돌아감)
 2. 수정 후 다시 Phase 2 (새 Evaluator Agent 생성 — 이전 Eval 컨텍스트 없음)
-3. 최대 3회 시도. 3회 모두 FAIL이면:
+3. 최대 **5회** 시도. 5회 모두 FAIL이면:
    ```bash
-   logev fail "{FEATURE_ID} FINAL FAIL after 3 attempts"
+   logev escalate "{FEATURE_ID} ESCALATED after 5 attempts — user intervention required"
    bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" fail {FEATURE_ID} "$HARNESS_ROOT"
    ```
-   실패 사유와 마지막 Eval 결과를 Lead에게 반환.
+   실패 사유와 마지막 Eval 결과를 Lead에게 반환. **사용자 개입을 요청**합니다.
+
+## Phase 4: 자동 업무 획득
+
+피처 PASS 또는 최종 FAIL 처리 후:
+1. Queue 상태 확인: `bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" status "$HARNESS_ROOT"`
+2. `ready` 큐에 피처가 있으면 → dequeue → **새 Gen-Eval 루프 시작** (Phase 1부터 반복)
+   ```bash
+   NEW_FEATURE=$(bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" dequeue {N} "$HARNESS_ROOT")
+   logev gen-start "$NEW_FEATURE auto-acquired"
+   ```
+3. `ready=0`이면 → "Team-{N} 대기 중 — 모든 할당 피처 완료" 반환
 ```
 
-## Step 4: 결과 수집 및 다음 라운드
+### Step 5: 결과 수집 및 다음 라운드
 
 모든 Team Agent가 완료되면:
 1. 각 Agent 반환 메시지에서 PASS/FAIL 확인
 2. Queue 상태 재확인: `bash scripts/harness-queue-manager.sh status .`
-3. ready 큐에 새로 unblock된 feature가 있으면 → **Step 2로 돌아가서** 추가 팀 생성
+3. ready 큐에 새로 unblock된 feature가 있으면 → **Step 3으로 돌아가서** 추가 팀 생성
 4. ready=0, in_progress=0이면 → 최종 결과 보고
 
 ## 핵심 원칙
@@ -242,3 +267,8 @@ logev fail "{FEATURE_ID} FAIL #{ATTEMPT} — {사유요약}"
 ### 격리
 - 각 팀은 `isolation: "worktree"`로 독립 코드 복사본에서 작업
 - 팀 간 코드 충돌 없음
+
+### 에스컬레이션 (5회 초과)
+- 5회 연속 FAIL 시 사용자 개입 요청
+- escalate 로그 기록 → Dashboard에 즉시 표시
+- 해당 팀은 다음 피처로 이동하지 않고 대기

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "4.0.0",
-  "description": "Production harness for AI agent engineering — Planner, Generator(BE/FE), Evaluator(Func/Visual), optional Brainstormer (requirements refinement). Supports React and Flutter FE stacks.",
+  "version": "5.0.1",
+  "description": "Production harness for AI agent engineering — Solo/Team mode, Planner, Generator(BE/FE), Evaluator(Func/Visual), optional Brainstormer. Supports React, Next.js, and Flutter FE stacks.",
   "bin": {
     "walwal-harness": "bin/init.js"
   },
@@ -9,15 +9,17 @@
     "postinstall": "node bin/init.js --auto",
     "init": "node bin/init.js",
     "scan": "bash scripts/scan-project.sh .",
-    "reset": "node bin/init.js --force",
-    "studio": "bash scripts/harness-studio.sh",
-    "studio:kill": "bash scripts/harness-studio.sh --kill"
+    "reset": "node bin/init.js --force"
   },
   "keywords": [
     "harness-engineering",
     "ai-agent",
     "claude-code",
+    "codex",
     "skill",
+    "command",
+    "solo-mode",
+    "team-mode",
     "brainstorming",
     "planner",
     "generator",
@@ -25,7 +27,6 @@
     "nestjs",
     "react",
     "flutter",
-    "riverpod",
     "playwright"
   ],
   "author": "",
@@ -34,10 +35,8 @@
     "bin/",
     "skills/",
     "scripts/",
+    "commands/",
     "assets/",
     "gotchas/"
-  ],
-  "dependencies": {
-    "@walwal-harness/cli": "^3.3.0"
-  }
+  ]
 }