@walwal-harness/cli 4.0.0-beta.2 → 4.0.0-beta.4

package/bin/init.js

@@ -129,17 +129,56 @@ function scaffoldHarness() {
     }
   }
 
-  // Copy config.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');
   const configDest = path.join(HARNESS_DIR, 'config.json');
-  if (fs.existsSync(configSrc) && (!fileExists(configDest) || isForce)) {
-    copyFile(configSrc, configDest);
+  if (fs.existsSync(configSrc)) {
+    if (fileExists(configDest) && !isForce) {
+      // Merge: keep user's customizations, update harness structure
+      try {
+        const existing = JSON.parse(fs.readFileSync(configDest, 'utf8'));
+        const template = JSON.parse(fs.readFileSync(configSrc, 'utf8'));
+        // Preserve user customizations
+        const userPreserve = {
+          behavior: existing.behavior,
+          'flow.pre_eval_gate.frontend_cwd': existing?.flow?.pre_eval_gate?.frontend_cwd,
+          'flow.pre_eval_gate.backend_cwd': existing?.flow?.pre_eval_gate?.backend_cwd,
+          'flow.pre_eval_gate.frontend_checks': existing?.flow?.pre_eval_gate?.frontend_checks,
+          'flow.pre_eval_gate.backend_checks': existing?.flow?.pre_eval_gate?.backend_checks,
+        };
+        // Write template, then re-apply user settings
+        fs.writeFileSync(configDest, JSON.stringify(template, null, 2) + '\n');
+        // Re-apply preserved user settings
+        const merged = JSON.parse(fs.readFileSync(configDest, 'utf8'));
+        if (userPreserve.behavior) merged.behavior = userPreserve.behavior;
+        if (userPreserve['flow.pre_eval_gate.frontend_cwd']) {
+          merged.flow.pre_eval_gate.frontend_cwd = userPreserve['flow.pre_eval_gate.frontend_cwd'];
+        }
+        if (userPreserve['flow.pre_eval_gate.backend_cwd']) {
+          merged.flow.pre_eval_gate.backend_cwd = userPreserve['flow.pre_eval_gate.backend_cwd'];
+        }
+        if (userPreserve['flow.pre_eval_gate.frontend_checks']) {
+          merged.flow.pre_eval_gate.frontend_checks = userPreserve['flow.pre_eval_gate.frontend_checks'];
+        }
+        if (userPreserve['flow.pre_eval_gate.backend_checks']) {
+          merged.flow.pre_eval_gate.backend_checks = userPreserve['flow.pre_eval_gate.backend_checks'];
+        }
+        fs.writeFileSync(configDest, JSON.stringify(merged, null, 2) + '\n');
+        log('config.json updated (user settings preserved)');
+      } catch (e) {
+        copyFile(configSrc, configDest);
+        log('config.json replaced (merge failed)');
+      }
+    } else {
+      copyFile(configSrc, configDest);
+    }
   }
 
-  // Copy HARNESS.md
+  // HARNESS.md — ALWAYS update
   const harnessMdSrc = path.join(PKG_ROOT, 'assets', 'templates', 'HARNESS.md');
   const harnessMdDest = path.join(HARNESS_DIR, 'HARNESS.md');
-  if (fs.existsSync(harnessMdSrc) && (!fileExists(harnessMdDest) || isForce)) {
+  if (fs.existsSync(harnessMdSrc)) {
     copyFile(harnessMdSrc, harnessMdDest);
   }
 
@@ -190,16 +229,23 @@ function installSkills() {
     .filter(d => d.isDirectory())
     .map(d => d.name);
 
+  // Remove obsolete skills (cleaned up in v4)
+  const obsoleteSkills = ['harness-generator-frontend-flutter', 'harness-evaluator-functional-flutter', 'harness-team'];
+  for (const obs of obsoleteSkills) {
+    const obsPath = path.join(CLAUDE_SKILLS_DIR, obs);
+    if (fs.existsSync(obsPath)) {
+      fs.rmSync(obsPath, { recursive: true, force: true });
+      log(`  Removed obsolete: ${obs}`);
+    }
+  }
+
   for (const skill of skills) {
     const src = path.join(skillsSrc, skill);
     const dest = path.join(CLAUDE_SKILLS_DIR, `harness-${skill}`);
 
-    if (!fileExists(dest) || isForce) {
-      copyDir(src, dest);
-      log(`  Installed: harness-${skill}`);
-    } else {
-      log(`  Skipped (exists): harness-${skill}`);
-    }
+    // Skills are ALWAYS overwritten — they are harness-managed, not user-editable
+    copyDir(src, dest);
+    log(`  Installed: harness-${skill}`);
   }
 
   log('Skills installation complete');
@@ -214,6 +260,21 @@ function installScripts() {
   const scriptsSrc = path.join(PKG_ROOT, 'scripts');
   const scriptsDest = path.join(PROJECT_ROOT, 'scripts');
 
+  // Remove obsolete scripts from previous versions
+  const obsoleteScripts = [
+    'harness-studio-v4.sh',
+    'harness-control-v4.sh',
+    'harness-prompts-v4.sh',
+    'harness-team-worker.sh',
+  ];
+  for (const obs of obsoleteScripts) {
+    const obsPath = path.join(scriptsDest, obs);
+    if (fs.existsSync(obsPath)) {
+      fs.unlinkSync(obsPath);
+      log(`  Removed obsolete: ${obs}`);
+    }
+  }
+
   // Core scripts are ALWAYS overwritten on update (not user-editable)
   // These contain harness logic that must stay in sync with the CLI version
   const coreScripts = new Set([
@@ -421,6 +482,28 @@ function installUserPromptSubmitHook() {
 // ─────────────────────────────────────────
 // 4. AGENTS.md + CLAUDE.md
 // ─────────────────────────────────────────
+// ─────────────────────────────────────────
+// 3d. Agent Teams env var
+// ─────────────────────────────────────────
+function installAgentTeamsEnv() {
+  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 (!settings.env) settings.env = {};
+
+  if (settings.env['CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS'] !== '1') {
+    settings.env['CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS'] = '1';
+    ensureDir(path.dirname(settingsPath));
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+    log('Agent Teams enabled (CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1)');
+  } else {
+    log('Agent Teams already enabled');
+  }
+}
+
 function setupAgentsMd() {
   const agentsMd = path.join(PROJECT_ROOT, 'AGENTS.md');
   const claudeMd = path.join(PROJECT_ROOT, 'CLAUDE.md');
@@ -703,6 +786,7 @@ function main() {
   installSessionHook();
   installStatusline();
   installUserPromptSubmitHook();
+  installAgentTeamsEnv();
   setupAgentsMd();
   checkPlaywrightMcp();
   checkRecommendedSkills();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "4.0.0-beta.2",
+  "version": "4.0.0-beta.4",
   "description": "Production harness for AI agent engineering — Planner, Generator(BE/FE), Evaluator(Func/Visual), optional Brainstormer (requirements refinement). Supports React and Flutter FE stacks.",
   "bin": {
     "walwal-harness": "bin/init.js"
@@ -9,7 +9,9 @@
     "postinstall": "node bin/init.js --auto",
     "init": "node bin/init.js",
     "scan": "bash scripts/scan-project.sh .",
-    "reset": "node bin/init.js --force"
+    "reset": "node bin/init.js --force",
+    "studio": "bash scripts/harness-studio.sh",
+    "studio:kill": "bash scripts/harness-studio.sh --kill"
   },
   "keywords": [
     "harness-engineering",

package/scripts/harness-prompt-history.sh

@@ -0,0 +1,126 @@
+#!/bin/bash
+# harness-prompt-history.sh — Prompt History pane for v4 tmux layout
+# progress.log + audit.log에서 유저 프롬프트/에이전트 활동 히스토리를 표시
+# Usage: bash scripts/harness-prompt-history.sh [project-root]
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/lib/harness-render-progress.sh"
+
+PROJECT_ROOT="${1:-}"
+if [ -z "$PROJECT_ROOT" ]; then
+  PROJECT_ROOT="$(resolve_harness_root ".")" || { echo "[history] .harness/ not found."; exit 1; }
+fi
+
+PROGRESS_LOG="$PROJECT_ROOT/.harness/progress.log"
+AUDIT_LOG="$PROJECT_ROOT/.harness/actions/audit.log"
+
+BOLD="\033[1m"
+DIM="\033[2m"
+GREEN="\033[32m"
+YELLOW="\033[33m"
+RED="\033[31m"
+CYAN="\033[36m"
+MAGENTA="\033[35m"
+RESET="\033[0m"
+
+render_header() {
+  echo -e "${BOLD}PROMPT HISTORY${RESET}  ${DIM}$(date +%H:%M:%S)${RESET}"
+  echo ""
+}
+
+render_progress_log() {
+  if [ ! -f "$PROGRESS_LOG" ]; then
+    echo -e "  ${DIM}(no progress.log yet)${RESET}"
+    return
+  fi
+
+  grep -v '^#' "$PROGRESS_LOG" 2>/dev/null | grep -v '^$' | tail -20 | while IFS= read -r line; do
+    local ts agent action detail
+    ts=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$1); print $1}')
+    agent=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$2); print $2}')
+    action=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$3); print $3}')
+    detail=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$4); print $4}')
+
+    local short_ts icon color
+    short_ts=$(echo "$ts" | grep -oE '[0-9]{2}:[0-9]{2}:[0-9]{2}' || echo "$ts")
+
+    case "$agent" in
+      dispatcher*)  icon="▸" ; color="$MAGENTA" ;;
+      brainstormer) icon="◇" ; color="$CYAN" ;;
+      planner*)     icon="□" ; color="$YELLOW" ;;
+      generator*)   icon="▶" ; color="$GREEN" ;;
+      eval*)        icon="✦" ; color="$RED" ;;
+      user|manual)  icon="★" ; color="$BOLD" ;;
+      team*)        icon="⊕" ; color="$CYAN" ;;
+      *)            icon="·" ; color="$DIM" ;;
+    esac
+
+    if [ ${#detail} -gt 40 ]; then detail="${detail:0:38}.."; fi
+
+    printf "  %b%b%b %b%-8s%b %b%s%b %b%s%b\n" \
+      "$color" "$icon" "$RESET" \
+      "$DIM" "$short_ts" "$RESET" \
+      "$RESET" "$agent" "$RESET" \
+      "$DIM" "$action" "$RESET"
+    if [ -n "$detail" ] && [ "$detail" != " " ]; then
+      echo -e "    ${DIM}${detail}${RESET}"
+    fi
+  done
+}
+
+render_audit_tail() {
+  if [ ! -f "$AUDIT_LOG" ]; then return; fi
+
+  echo ""
+  echo -e "${BOLD}AUDIT${RESET}"
+
+  grep -v '^#' "$AUDIT_LOG" 2>/dev/null | grep -v '^$' | tail -10 | while IFS= read -r line; do
+    local ts agent action status target
+    ts=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$1); print $1}')
+    agent=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$2); print $2}')
+    action=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$3); print $3}')
+    status=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$4); print $4}')
+    target=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$5); print $5}')
+
+    local color="$RESET" icon="·"
+    case "$status" in
+      start)    color="$CYAN";  icon="▶" ;;
+      complete) color="$GREEN"; icon="✓" ;;
+      fail)     color="$RED";   icon="✗" ;;
+      pass)     color="$GREEN"; icon="✓" ;;
+      skip)     color="$DIM";   icon="–" ;;
+    esac
+
+    local short_ts
+    short_ts=$(echo "$ts" | grep -oE '[0-9]{2}:[0-9]{2}:[0-9]{2}' || echo "$ts")
+
+    if [ ${#target} -gt 25 ]; then target="${target:0:23}.."; fi
+
+    printf "  %b%b%b %b%s%b %-10s %b%s%b\n" \
+      "$color" "$icon" "$RESET" \
+      "$DIM" "$short_ts" "$RESET" \
+      "$agent" \
+      "$DIM" "$target" "$RESET"
+  done
+}
+
+render_all() {
+  render_header
+  render_progress_log
+  render_audit_tail
+}
+
+# ── Main loop ──
+tput civis 2>/dev/null
+trap 'tput cnorm 2>/dev/null; exit 0' EXIT INT TERM
+clear
+
+while true; do
+  buf=$(render_all 2>&1)
+  tput cup 0 0 2>/dev/null
+  echo "$buf"
+  tput ed 2>/dev/null
+  sleep 3
+done

package/scripts/harness-studio-setup.sh

@@ -0,0 +1,88 @@
+#!/bin/bash
+# harness-studio-setup.sh — Claude 세션 내부에서 실행하여 3-column 레이아웃 자동 구축
+#
+# Claude가 이미 실행 중인 tmux pane에서 호출됨.
+# 현재 pane(Claude가 있는 곳)을 Left로 유지하고,
+# Center(Dashboard + History)와 Right(Monitor)를 split으로 생성.
+#
+# ┌──────────────┬──────────────┬──────────────┐
+# │              │  Dashboard   │              │
+# │  여기서      │  (v4 queue)  │  Team Monitor│
+# │  Claude 실행중├──────────────┤  (lifecycle) │
+# │              │  Command     │              │
+# │              │  History     │              │
+# └──────────────┴──────────────┴──────────────┘
+#
+# Usage (Claude가 bash 도구로 호출):
+#   bash scripts/harness-studio-setup.sh [project-root]
+#
+# 이미 구축됐으면 skip (멱등성 보장)
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+PROJECT_ROOT="${1:-}"
+if [ -z "$PROJECT_ROOT" ]; then
+  dir="$(pwd)"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/.harness" ]; then PROJECT_ROOT="$dir"; break; fi
+    dir="$(dirname "$dir")"
+  done
+fi
+
+if [ -z "$PROJECT_ROOT" ] || [ ! -d "$PROJECT_ROOT/.harness" ]; then
+  echo "[studio] .harness/ not found."
+  exit 1
+fi
+
+# ── tmux 내부인지 확인 ──
+if [ -z "${TMUX:-}" ]; then
+  echo "[studio] Not inside tmux. Layout requires tmux."
+  echo "[studio] Start with: tmux new-session -s harness"
+  exit 1
+fi
+
+# ── 멱등성: 이미 pane이 3개 이상이면 skip ──
+PANE_COUNT=$(tmux list-panes | wc -l | tr -d ' ')
+if [ "$PANE_COUNT" -ge 3 ]; then
+  echo "[studio] Layout already set up ($PANE_COUNT panes). Skipping."
+  exit 0
+fi
+
+# ── 현재 pane = Claude (Left) ──
+PANE_CLAUDE=$(tmux display-message -p '#{pane_id}')
+
+echo "[studio] Setting up 3-column layout..."
+
+# ── Split: Left 35% | Right 65% ──
+PANE_MID=$(tmux split-window -h -p 65 -t "$PANE_CLAUDE" -c "$PROJECT_ROOT" \
+  -P -F '#{pane_id}' \
+  "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-dashboard-v4.sh\" \"${PROJECT_ROOT}\"'")
+
+# ── Split right: Middle 45% | Right 55% ──
+PANE_RIGHT=$(tmux split-window -h -p 55 -t "$PANE_MID" -c "$PROJECT_ROOT" \
+  -P -F '#{pane_id}' \
+  "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-monitor.sh\" \"${PROJECT_ROOT}\"'")
+
+# ── Split middle vertically: Dashboard (top 45%) | History (bottom 55%) ──
+PANE_HISTORY=$(tmux split-window -v -p 55 -t "$PANE_MID" -c "$PROJECT_ROOT" \
+  -P -F '#{pane_id}' \
+  "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-prompt-history.sh\" \"${PROJECT_ROOT}\"'")
+
+# ── Pane titles ──
+tmux select-pane -t "$PANE_CLAUDE"  -T "Lead (Claude)"
+tmux select-pane -t "$PANE_MID"     -T "Dashboard"
+tmux select-pane -t "$PANE_HISTORY" -T "Command History"
+tmux select-pane -t "$PANE_RIGHT"   -T "Team Monitor"
+
+tmux set-option pane-border-status top 2>/dev/null || true
+tmux set-option pane-border-format " #{pane_title} " 2>/dev/null || true
+
+# ── 포커스를 Claude pane으로 돌림 ──
+tmux select-pane -t "$PANE_CLAUDE"
+
+echo "[studio] Layout ready."
+echo "[studio]   Left   : Lead (Claude) — you are here"
+echo "[studio]   Center : Dashboard + Command History"
+echo "[studio]   Right  : Team Monitor"

package/scripts/harness-studio.sh

@@ -0,0 +1,66 @@
+#!/bin/bash
+# harness-studio.sh — 하네스 통합 진입점
+#
+# 사용자가 기억할 명령: 이것 하나.
+#
+#   bash scripts/harness-studio.sh          # 자동 감지: v3 or v4
+#   bash scripts/harness-studio.sh --kill   # 세션 종료
+#   bash scripts/harness-studio.sh --v3     # v3 강제
+#   bash scripts/harness-studio.sh --v4     # v4 강제
+#
+# 자동 감지 기준:
+#   feature-queue.json 존재 → v4 (Agent Teams 병렬 모드)
+#   없으면 → v3 (순차 파이프라인 모드)
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+FORCE_MODE=""
+
+# ── Parse args (pass through to sub-script) ──
+PASSTHROUGH_ARGS=()
+for arg in "$@"; do
+  case "$arg" in
+    --v3)   FORCE_MODE="v3" ;;
+    --v4)   FORCE_MODE="v4" ;;
+    --kill)
+      tmux kill-session -t "harness-studio" 2>/dev/null && echo "v3 killed." || true
+      tmux kill-session -t "harness-v4" 2>/dev/null && echo "v4 killed." || true
+      exit 0
+      ;;
+    *)
+      PASSTHROUGH_ARGS+=("$arg")
+      ;;
+  esac
+done
+
+# ── Auto-detect mode ──
+detect_mode() {
+  local dir="${1:-.}"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/.harness" ]; then
+      if [ -f "$dir/.harness/actions/feature-queue.json" ]; then
+        echo "v4"
+      else
+        echo "v3"
+      fi
+      return
+    fi
+    dir="$(dirname "$dir")"
+  done
+  echo "v3"  # default
+}
+
+MODE="${FORCE_MODE:-$(detect_mode "$(pwd)")}"
+
+echo "Harness Studio — mode: $MODE"
+echo ""
+
+case "$MODE" in
+  v4)
+    exec bash "$SCRIPT_DIR/harness-tmux-v4.sh" "${PASSTHROUGH_ARGS[@]}"
+    ;;
+  v3)
+    exec bash "$SCRIPT_DIR/harness-tmux.sh" "${PASSTHROUGH_ARGS[@]}"
+    ;;
+esac

package/scripts/harness-tmux-v4.sh

@@ -0,0 +1,136 @@
+#!/bin/bash
+# harness-tmux-v4.sh — v4 Agent Teams: 원커맨드 실행
+#
+# ┌──────────────┬──────────────┬──────────────┐
+# │              │  Dashboard   │              │
+# │  Main Claude │  (v4 queue)  │  Team Monitor│
+# │  (Lead)      ├──────────────┤  (lifecycle) │
+# │              │  Prompt      │              │
+# │              │  History     │              │
+# └──────────────┴──────────────┴──────────────┘
+#
+# Usage:
+#   bash scripts/harness-tmux-v4.sh              # 레이아웃 + Claude 자동 실행 + team-action 자동 시작
+#   bash scripts/harness-tmux-v4.sh --no-auto    # 레이아웃만 (Claude 수동 실행)
+#   bash scripts/harness-tmux-v4.sh --kill       # 세션 종료
+#
+# 이것만 기억하세요:
+#   bash scripts/harness-tmux-v4.sh
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+SESSION_NAME="harness-v4"
+
+PROJECT_ROOT=""
+DETACH=false
+AUTO_START=true
+
+for arg in "$@"; do
+  case "$arg" in
+    --detach)   DETACH=true ;;
+    --no-auto)  AUTO_START=false ;;
+    --kill)
+      tmux kill-session -t "$SESSION_NAME" 2>/dev/null && echo "Killed." || echo "No session."
+      exit 0
+      ;;
+    *)
+      if [ -d "$arg" ]; then PROJECT_ROOT="$arg"; fi
+      ;;
+  esac
+done
+
+if [ -z "$PROJECT_ROOT" ]; then
+  dir="$(pwd)"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/.harness" ]; then PROJECT_ROOT="$dir"; break; fi
+    dir="$(dirname "$dir")"
+  done
+fi
+
+if [ -z "$PROJECT_ROOT" ] || [ ! -d "$PROJECT_ROOT/.harness" ]; then
+  echo "Error: .harness/ not found."
+  exit 1
+fi
+
+echo "Project: $PROJECT_ROOT"
+echo "Session: $SESSION_NAME"
+
+tmux kill-session -t "$SESSION_NAME" 2>/dev/null || true
+
+# ── Resolve Claude command ──
+HANDOFF="$PROJECT_ROOT/.harness/handoff.json"
+CLAUDE_CMD="claude --dangerously-skip-permissions"
+if [ -f "$HANDOFF" ]; then
+  _model=$(jq -r '.model // empty' "$HANDOFF" 2>/dev/null)
+  if [ -n "$_model" ] && [ "$_model" != "null" ]; then
+    CLAUDE_CMD="$CLAUDE_CMD --model $_model"
+  fi
+fi
+
+# ══════════════════════════════════════════
+# Build 3-column layout
+# ══════════════════════════════════════════
+
+# 1. Create session → Left pane (Main Claude Lead)
+PANE_MAIN=$(tmux new-session -d -s "$SESSION_NAME" -c "$PROJECT_ROOT" -x 220 -y 55 \
+  -P -F '#{pane_id}')
+
+# 2. Split horizontally: Left 35% | Right 65%
+PANE_MID=$(tmux split-window -h -p 65 -t "$PANE_MAIN" -c "$PROJECT_ROOT" \
+  -P -F '#{pane_id}')
+
+# 3. Split right section: Middle 45% | Right 55%
+PANE_RIGHT=$(tmux split-window -h -p 55 -t "$PANE_MID" -c "$PROJECT_ROOT" \
+  -P -F '#{pane_id}' \
+  "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-monitor.sh\" \"${PROJECT_ROOT}\"'")
+
+# 4. Split middle pane vertically: Dashboard (top 45%) | Prompt History (bottom 55%)
+PANE_HISTORY=$(tmux split-window -v -p 55 -t "$PANE_MID" -c "$PROJECT_ROOT" \
+  -P -F '#{pane_id}' \
+  "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-prompt-history.sh\" \"${PROJECT_ROOT}\"'")
+
+# 5. Start dashboard in the middle-top pane
+tmux send-keys -t "$PANE_MID" "bash \"${SCRIPT_DIR}/harness-dashboard-v4.sh\" \"${PROJECT_ROOT}\"" Enter
+
+# 6. Main pane — Claude 자동 실행
+tmux send-keys -t "$PANE_MAIN" "unset npm_config_prefix 2>/dev/null" Enter
+tmux send-keys -t "$PANE_MAIN" "clear" Enter
+
+if [ "$AUTO_START" = true ]; then
+  # Claude 실행 → 시작 후 자동으로 /harness-team-action 전송
+  tmux send-keys -t "$PANE_MAIN" "$CLAUDE_CMD" Enter
+  # Claude가 초기화될 시간을 준 뒤 team-action 명령 전송
+  sleep 3
+  tmux send-keys -t "$PANE_MAIN" "/harness-team-action" Enter
+fi
+
+# ── Pane titles ──
+tmux select-pane -t "$PANE_MAIN"    -T "Lead (Main Claude)"
+tmux select-pane -t "$PANE_MID"     -T "Dashboard"
+tmux select-pane -t "$PANE_HISTORY" -T "Prompt History"
+tmux select-pane -t "$PANE_RIGHT"   -T "Team Monitor"
+
+tmux set-option -t "$SESSION_NAME" pane-border-status top 2>/dev/null || true
+tmux set-option -t "$SESSION_NAME" pane-border-format " #{pane_title} " 2>/dev/null || true
+
+# ── Focus on Main pane ──
+tmux select-pane -t "$PANE_MAIN"
+
+# ── Attach ──
+if [ "$DETACH" = true ]; then
+  echo ""
+  echo "Session created. Attach: tmux attach -t $SESSION_NAME"
+else
+  if [ -n "${TMUX:-}" ]; then
+    tmux switch-client -t "$SESSION_NAME"
+  else
+    echo ""
+    echo "harness-v4 starting..."
+    echo ""
+    echo "  All automatic. Just watch."
+    echo "  Stop: bash scripts/harness-tmux-v4.sh --kill"
+    echo ""
+    tmux attach -t "$SESSION_NAME"
+  fi
+fi

package/scripts/harness-user-prompt-submit.sh

@@ -36,6 +36,19 @@ if [ -f "$CWD/.harness/progress.json" ] && command -v jq >/dev/null 2>&1; then
   AGENT_STATUS=$(jq -r '.agent_status // "pending"' "$CWD/.harness/progress.json" 2>/dev/null || echo "pending")
 fi
 
+# ── 명령 히스토리 기록 (모든 모드 공통) ──
+PROGRESS_LOG="$CWD/.harness/progress.log"
+if [ -n "$PROMPT" ] && [ -d "$CWD/.harness" ]; then
+  # progress.log가 없으면 생성
+  if [ ! -f "$PROGRESS_LOG" ]; then
+    echo "# Harness Command History — $(date +%Y-%m-%d)" > "$PROGRESS_LOG"
+  fi
+  PROMPT_SHORT=$(echo "$PROMPT" | tr '\n' ' ' | sed 's/  */ /g' | cut -c1-80)
+  if [ ${#PROMPT_SHORT} -gt 2 ]; then
+    echo "$(date +"%Y-%m-%d %H:%M") | user-prompt | input | ${PROMPT_SHORT}" >> "$PROGRESS_LOG"
+  fi
+fi
+
 # ── 컨텍스트 분리 가드레일 ──
 # 현재 에이전트가 활성인데 다른 에이전트 스킬을 호출하려는 경우 경고
 CONTEXT_WARNING=""
@@ -58,16 +71,6 @@ if [ -f "$FEATURE_QUEUE" ]; then
   V4_TOTAL=$(jq '[.queue.ready, (.queue.blocked | keys), (.queue.in_progress | keys), .queue.passed, .queue.failed] | flatten | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
   V4_FAILED=$(jq '.queue.failed | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
 
-  # Log user prompt to progress.log (truncated to 80 chars)
-  PROGRESS_LOG="$CWD/.harness/progress.log"
-  if [ -n "$PROMPT" ] && [ -f "$PROGRESS_LOG" ]; then
-    PROMPT_SHORT=$(echo "$PROMPT" | tr '\n' ' ' | sed 's/  */ /g' | cut -c1-80)
-    # Skip logging for empty or very short prompts
-    if [ ${#PROMPT_SHORT} -gt 2 ]; then
-      echo "$(date +"%Y-%m-%d %H:%M") | user-prompt | input | ${PROMPT_SHORT}" >> "$PROGRESS_LOG"
-    fi
-  fi
-
   cat <<EOF
 [harness-v4] ${V4_PASSED}/${V4_TOTAL} features passed | ${V4_FAILED} failed
 

package/skills/team-action/SKILL.md

@@ -1,26 +1,158 @@
 ---
 name: harness-team-action
-description: "v4 Agent Teams 가동. feature-queue를 초기화하고 3개 Teammate를 생성하여 Feature 병렬 실행. 트리거: '/harness-team-action', 'team 시작', '팀 가동'"
+description: "v4 Agent Teams 가동. Studio 레이아웃 구축 → Queue 초기화 → Gen↔Eval 분리 사이클 팀 병렬 실행. 트리거: '/harness-team-action', 'team 시작', '팀 가동'"
 disable-model-invocation: false
 ---
 
 # /harness-team-action — Agent Teams 가동
 
+## Step 0: Studio 레이아웃 자동 구축
+
+tmux 내부에서 실행 중이면, 3-column 레이아웃을 자동 구축합니다:
+
+```bash
+bash scripts/harness-studio-setup.sh .
+```
+
+> 이미 구축됐으면 자동 skip (멱등).
+> tmux 밖이면 경고만 출력하고 계속 진행 (필수는 아님).
+
 ## Step 1: Queue 초기화
 
 ```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 .
 ```
 
-## Step 2: Teammate 생성
+## Step 2: Feature 할당 (dequeue)
+
+Queue status 결과를 확인하여 `ready` 큐에 feature가 있는지 확인합니다.
+ready feature 수와 설정된 concurrency 중 작은 값만큼 팀을 생성합니다 (최대 3).
+
+**각 팀마다** dequeue 명령으로 feature를 원자적으로 할당합니다:
+
+```bash
+bash scripts/harness-queue-manager.sh dequeue {TEAM_NUMBER} .
+```
+
+dequeue 결과로 feature ID가 반환됩니다. 빈 결과면 해당 팀은 생성하지 않습니다.
+
+## Step 3: Agent 도구로 팀 생성 (Gen↔Eval 분리 사이클)
+
+dequeue로 할당받은 feature마다 **Agent 도구**를 호출합니다.
+**반드시 `isolation: "worktree"`를 사용**하여 각 팀이 독립된 코드 복사본에서 작업합니다.
+
+**독립적인 팀들은 단일 메시지에서 병렬로 호출**하세요 (한 번의 응답에 여러 Agent 도구 호출).
+
+```
+Agent({
+  description: "Team-{N}: {FEATURE_ID}",
+  isolation: "worktree",
+  prompt: "<아래 Team Worker 프롬프트>"
+})
+```
+
+### Team Worker 프롬프트
+
+```
+당신은 Harness Team-{N} 워커입니다. 하나의 Feature에 대해 Gen→Eval 사이클을 수행합니다.
+
+## 할당된 Feature
+- Feature ID: {FEATURE_ID}
+- 프로젝트 루트: 현재 디렉토리 (worktree 복사본)
+
+## Phase 1: Generator (코드 생성)
+
+1. Feature 정보 확인:
+   - `jq '.features[] | select(.id == "{FEATURE_ID}")' .harness/actions/feature-list.json`
+   - `.harness/actions/api-contract.json`에서 관련 엔드포인트 확인
+   - AC(Acceptance Criteria) 목록을 정확히 파악
+
+2. 코드 생성:
+   - AGENTS.md의 IA-MAP에 따라 올바른 디렉토리에 코드 작성
+   - AC의 모든 항목을 충족하도록 구현
+
+3. Pre-eval 게이트 (자체):
+   - tsc (타입 체크) 실행
+   - eslint (린트) 실행
+   - 컴파일 에러가 있으면 직접 수정 (Eval에 넘기지 않음)
+
+## Phase 2: Evaluator (독립 평가 — Agent 도구 사용)
+
+코드 생성이 완료되면 **별도 Agent를 생성하여 평가**합니다.
+이 Evaluator Agent는 당신(Generator)의 추론 과정을 모릅니다.
+오직 코드와 AC만 보고 판단합니다.
+
+```
+Agent({
+  description: "Eval: {FEATURE_ID}",
+  prompt: "<아래 Evaluator 프롬프트>"
+})
+```
+
+#### Evaluator 프롬프트
+
+```
+당신은 독립 Evaluator입니다. Generator가 작성한 코드를 AC 기준으로 냉정하게 평가합니다.
+Generator의 의도나 추론 과정은 알 수 없습니다. 오직 코드와 결과만 봅니다.
+
+## 평가 대상
+- Feature ID: {FEATURE_ID}
+- AC 확인: `jq '.features[] | select(.id == "{FEATURE_ID}").acceptance_criteria' .harness/actions/feature-list.json`
+
+## 평가 기준
+1. AC 100% 충족 여부 (부분 통과 = FAIL)
+2. api-contract.json과의 일치 여부 (엔드포인트, 요청/응답 스키마)
+3. tsc, eslint 통과 여부
+4. 보안 취약점 여부 (OWASP Top 10)
+5. 기존 코드와의 regression 여부
+
+## 출력 형식
+반드시 아래 형식으로 결과를 반환하세요:
+
+VERDICT: PASS 또는 FAIL
+SCORE: X.XX / 3.00
+EVIDENCE:
+- AC-1: [PASS/FAIL] 근거
+- AC-2: [PASS/FAIL] 근거
+- ...
+FEEDBACK: (FAIL인 경우만) 구체적 수정 지시
+```
+
+## Phase 3: 결과 처리
+
+Evaluator Agent 결과를 확인합니다:
+
+### PASS인 경우 (VERDICT: PASS, SCORE ≥ 2.80):
+1. `bash scripts/harness-queue-manager.sh pass {FEATURE_ID} .` 실행
+2. 변경 파일 목록과 AC 충족 요약을 Lead에게 반환
+
+### FAIL인 경우:
+1. Evaluator의 FEEDBACK을 읽고 코드를 수정 (Phase 1로 돌아감)
+2. 수정 후 다시 Phase 2 (새 Evaluator Agent 생성 — 이전 Eval 컨텍스트 없음)
+3. 최대 3회 시도. 3회 모두 FAIL이면:
+   - `bash scripts/harness-queue-manager.sh fail {FEATURE_ID} .` 실행
+   - 실패 사유와 마지막 Eval 결과를 Lead에게 반환
+```
+
+## Step 4: 결과 수집 및 다음 라운드
+
+모든 Team Agent가 완료되면:
+1. 각 Agent 반환 메시지에서 PASS/FAIL 확인
+2. Queue 상태 재확인: `bash scripts/harness-queue-manager.sh status .`
+3. ready 큐에 새로 unblock된 feature가 있으면 → **Step 2로 돌아가서** 추가 팀 생성
+4. ready=0, in_progress=0이면 → 최종 결과 보고
+
+## 핵심 원칙
 
-Queue의 `ready` 배열에서 Feature를 읽고, **3명의 Teammate를 즉시 생성**하세요.
+### 자기 의식 편향 차단
+- Generator가 자기 코드를 평가하지 않음
+- Evaluator는 항상 새 Agent (Generator의 추론 과정을 모름)
+- FAIL 후 재시도 시에도 새 Evaluator를 생성 (이전 Eval 기억 없음)
 
-각 Teammate에게 전달할 지시:
-- `.harness/actions/feature-queue.json`의 ready에서 Feature 1개를 담당
-- 해당 Feature의 코드를 생성하고, AC(Acceptance Criteria)를 기준으로 자체 검증
-- PASS 시: `bash scripts/harness-queue-manager.sh pass {FEATURE_ID} .` 실행
-- FAIL 시: 재시도 (최대 3회), 3회 실패 시 `bash scripts/harness-queue-manager.sh fail {FEATURE_ID} .`
-- 완료 후 Lead에게 결과 보고
+### 중복 방지
+- dequeue는 원자적 (lock 사용) — 같은 feature를 두 번 할당 불가
+- ready가 0이면 팀을 생성하지 않음
 
-**Teammate 이름**: team-1, team-2, team-3
+### 격리
+- 각 팀은 `isolation: "worktree"`로 독립 코드 복사본에서 작업
+- 팀 간 코드 충돌 없음