@walwal-harness/cli 4.0.0-beta.8 → 4.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "4.0.0-beta.8",
+  "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.",
   "bin": {
     "walwal-harness": "bin/init.js"

package/scripts/harness-dashboard-v4.sh

@@ -133,10 +133,55 @@ render_features() {
   done
 }
 
+render_bottleneck_alert() {
+  if [ ! -f "$QUEUE" ] || [ ! -f "$FEATURES" ]; then return; fi
+
+  local failed_list blocked_count idle_teams in_prog
+  failed_list=$(jq -r '.queue.failed[]' "$QUEUE" 2>/dev/null)
+  blocked_count=$(jq '.queue.blocked | length' "$QUEUE" 2>/dev/null || echo 0)
+  in_prog=$(jq '.queue.in_progress | length' "$QUEUE" 2>/dev/null || echo 0)
+  idle_teams=0
+
+  # Count idle teams
+  local team_count
+  team_count=$(jq '.teams | length' "$QUEUE" 2>/dev/null || echo 0)
+  for i in $(seq 1 "$team_count"); do
+    local ts
+    ts=$(jq -r ".teams[\"$i\"].status // \"idle\"" "$QUEUE" 2>/dev/null)
+    if [ "$ts" = "idle" ]; then idle_teams=$((idle_teams + 1)); fi
+  done
+
+  if [ -z "$failed_list" ]; then return; fi
+
+  # Check each failed feature for blocking impact
+  while IFS= read -r fid; do
+    [ -z "$fid" ] && continue
+    # Count how many blocked features depend on this fid
+    local deps_on_this
+    deps_on_this=$(jq --arg fid "$fid" '[.queue.blocked | to_entries[] | select(.value | index($fid))] | length' "$QUEUE" 2>/dev/null || echo 0)
+
+    if [ "$deps_on_this" -gt 0 ]; then
+      echo ""
+      echo -e "  ${RED}${BOLD}⚠ BOTTLENECK${RESET} ${RED}${fid}${RESET} failed → ${YELLOW}${deps_on_this} features blocked${RESET}"
+      if [ "$idle_teams" -gt 0 ]; then
+        echo -e "  ${BOLD}→ requeue:${RESET} bash scripts/harness-queue-manager.sh requeue ${fid} ."
+      fi
+    fi
+  done <<< "$failed_list"
+
+  # All teams idle + nothing in progress = stalled
+  if [ "$idle_teams" -eq "$team_count" ] && [ "$in_prog" -eq 0 ] && [ "$blocked_count" -gt 0 ]; then
+    echo ""
+    echo -e "  ${RED}${BOLD}!! STALLED${RESET} — All teams idle, ${blocked_count} features blocked"
+    echo -e "  ${BOLD}→ requeue failed features or check dependency graph${RESET}"
+  fi
+}
+
 render_all() {
   render_header
   render_queue_summary
   render_teams
+  render_bottleneck_alert
   echo ""
   render_features
 }

package/scripts/harness-monitor.sh

@@ -10,7 +10,19 @@ set -uo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 
-PROJECT_ROOT="${1:-}"
+# ── Args ──
+# Usage: harness-monitor.sh [project-root] [--team N]
+#   --team N  → 단일 팀만 렌더 (tmux per-team pane 용도)
+PROJECT_ROOT=""
+TEAM_FILTER=""
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --team) TEAM_FILTER="$2"; shift 2 ;;
+    --team=*) TEAM_FILTER="${1#--team=}"; shift ;;
+    *) [ -z "$PROJECT_ROOT" ] && PROJECT_ROOT="$1"; shift ;;
+  esac
+done
+
 if [ -z "$PROJECT_ROOT" ]; then
   source "$SCRIPT_DIR/lib/harness-render-progress.sh"
   PROJECT_ROOT="$(resolve_harness_root ".")" || {
@@ -58,8 +70,18 @@ render_v4_header() {
   echo ""
 }
 
+# 고정폭 배너 구분선 (터미널 너비에 맞춰 채움)
+banner_line() {
+  local cols
+  cols=$(tput cols 2>/dev/null || echo 78)
+  local line=""
+  for ((i=0; i<cols; i++)); do line+="━"; done
+  echo "$line"
+}
+
 render_team_section() {
   local team_num="$1"
+  local log_lines="${2:-10}"
   local color
   color=$(team_color "$team_num")
 
@@ -90,89 +112,115 @@ render_team_section() {
     *)    phase_str="" ;;
   esac
 
-  # 헤더 라인
-  printf "%b%b T%s%b " "$color" "$icon" "$team_num" "$RESET"
+  # ── 큰 배너 ──
+  local bar
+  bar=$(banner_line)
+  printf "%b%s%b\n" "$color" "$bar" "$RESET"
+
+  printf "%b%b TEAM %s%b" "$color$BOLD" "$icon" "$team_num" "$RESET"
   if [ "$t_feature" != "—" ] && [ "$t_feature" != "null" ]; then
-    printf "%s " "$t_feature"
+    printf "  %b%s%b" "$BOLD" "$t_feature" "$RESET"
     if [ -n "$phase_str" ]; then
-      printf "%b%s%b" "$color" "$phase_str" "$RESET"
+      printf "  %b[%s]%b" "$color" "$phase_str" "$RESET"
     fi
     if [ -n "$t_attempt" ] && [ "$t_attempt" != "—" ] && [ "$t_attempt" != "1" ]; then
-      printf " %b#%s%b" "$DIM" "$t_attempt" "$RESET"
+      printf " %battempt #%s%b" "$YELLOW" "$t_attempt" "$RESET"
     fi
   else
-    printf "%bidle%b" "$DIM" "$RESET"
+    printf "  %bidle%b" "$DIM" "$RESET"
   fi
   echo ""
+  printf "%b%s%b\n" "$color" "$bar" "$RESET"
 
-  # 팀 로그 (progress.log에서 team-N 엔트리만 추출)
+  # ── 팀 로그 ──
+  local have_logs=0
   if [ -f "$PROGRESS_LOG" ]; then
-    grep -i "team-${team_num}\|team_${team_num}" "$PROGRESS_LOG" 2>/dev/null | tail -5 | while IFS= read -r line; do
-      local ts action detail
-      ts=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$1); print $1}')
-      action=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$3); print $3}')
-      detail=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$4); print $4}')
-
-      local short_ts
-      short_ts=$(echo "$ts" | grep -oE '[0-9]{2}:[0-9]{2}' | tail -1 || echo "$ts")
-
-      if [ ${#detail} -gt 35 ]; then detail="${detail:0:33}.."; fi
-
-      # 액션별 아이콘
-      local a_icon="·" a_color="$DIM"
-      case "$action" in
-        gen)      a_icon="▶"; a_color="$GREEN" ;;
-        eval)     a_icon="✦"; a_color="$BLUE" ;;
-        pass)     a_icon="✓"; a_color="$GREEN" ;;
-        fail)     a_icon="✗"; a_color="$RED" ;;
-        dequeue)  a_icon="→"; a_color="$CYAN" ;;
-        gate)     a_icon="◆"; a_color="$YELLOW" ;;
-        *)        a_icon="·"; a_color="$DIM" ;;
-      esac
-
-      printf "  %b%s%b %b%s%b %b%s%b\n" \
-        "$DIM" "$short_ts" "$RESET" \
-        "$a_color" "$a_icon" "$RESET" \
-        "$DIM" "$detail" "$RESET"
-    done
+    local matched
+    matched=$(grep -E "team-${team_num}\b|team_${team_num}\b" "$PROGRESS_LOG" 2>/dev/null | tail -"$log_lines")
+    if [ -n "$matched" ]; then
+      have_logs=1
+      local cols
+      cols=$(tput cols 2>/dev/null || echo 78)
+      # 포맷: [ts] [icon agent] detail (너무 길면 터미널 너비에서 줄바꿈)
+      local prefix_w=18  # "  HH:MM  ✦ eval  "
+      local detail_w=$(( cols - prefix_w ))
+      [ "$detail_w" -lt 20 ] && detail_w=20
+
+      echo "$matched" | while IFS= read -r line; do
+        local ts action detail
+        ts=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$1); print $1}')
+        action=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$3); print $3}')
+        detail=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$4); print $4}')
+
+        local short_ts
+        short_ts=$(echo "$ts" | grep -oE '[0-9]{2}:[0-9]{2}' | tail -1 || echo "$ts")
+
+        local a_icon="·" a_color="$DIM" a_label="$action"
+        case "$action" in
+          gen|gen-start|gen-read|gen-write|gen-test|gen-done)
+            a_icon="▶"; a_color="$GREEN"; a_label="Gen" ;;
+          eval|eval-start|eval-check|eval-done)
+            a_icon="✦"; a_color="$BLUE"; a_label="Eval" ;;
+          result|pass)
+            a_icon="✓"; a_color="$GREEN"; a_label="Result" ;;
+          fail)
+            a_icon="✗"; a_color="$RED"; a_label="Result" ;;
+          dequeue)  a_icon="→"; a_color="$CYAN"; a_label="Queue" ;;
+          gate)     a_icon="◆"; a_color="$YELLOW"; a_label="Gate" ;;
+          *)        a_icon="·"; a_color="$DIM"; a_label="$action" ;;
+        esac
+
+        # 첫 줄
+        local first="${detail:0:$detail_w}"
+        printf "  %b%s%b %b%s%b %-6s %s\n" \
+          "$DIM" "$short_ts" "$RESET" \
+          "$a_color" "$a_icon" "$RESET" \
+          "$a_label" "$first"
+        # 이어질 줄 (긴 detail 은 접지 않고 들여쓰기로 이어서 출력)
+        local rest="${detail:$detail_w}"
+        while [ -n "$rest" ]; do
+          local chunk="${rest:0:$detail_w}"
+          rest="${rest:$detail_w}"
+          printf "  %*s%s\n" "$prefix_w" "" "$chunk"
+        done
+      done
+    fi
+  fi
+  if [ "$have_logs" -eq 0 ]; then
+    printf "  %b(no activity)%b\n" "$DIM" "$RESET"
   fi
 }
 
 render_v4() {
+  # 단일 팀 모드 (tmux per-team pane)
+  if [ -n "$TEAM_FILTER" ]; then
+    local rows log_lines
+    rows=$(tput lines 2>/dev/null || echo 20)
+    log_lines=$(( rows - 5 ))
+    [ "$log_lines" -lt 3 ] && log_lines=3
+    render_team_section "$TEAM_FILTER" "$log_lines"
+    return
+  fi
+
   render_v4_header
 
-  # 팀 수 확인
   local team_count=3
   if [ -f "$QUEUE" ]; then
     team_count=$(jq '.teams | length' "$QUEUE" 2>/dev/null || echo 3)
   fi
+  [ "$team_count" -lt 1 ] && team_count=3
+
+  local rows per_team log_lines
+  rows=$(tput lines 2>/dev/null || echo 40)
+  per_team=$(( (rows - 2) / team_count ))
+  log_lines=$(( per_team - 5 ))
+  if [ "$log_lines" -lt 3 ]; then log_lines=3; fi
+  if [ "$log_lines" -gt 15 ]; then log_lines=15; fi
 
   for i in $(seq 1 "$team_count"); do
-    render_team_section "$i"
+    render_team_section "$i" "$log_lines"
     echo ""
   done
-
-  # Lead/시스템 이벤트 (team이 아닌 엔트리)
-  echo -e "${BOLD}SYSTEM${RESET}"
-  if [ -f "$PROGRESS_LOG" ]; then
-    grep -v 'team-[0-9]' "$PROGRESS_LOG" 2>/dev/null | grep -v '^#' | grep -v '^$' | tail -5 | 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
-      short_ts=$(echo "$ts" | grep -oE '[0-9]{2}:[0-9]{2}' | tail -1 || echo "$ts")
-
-      if [ ${#detail} -gt 35 ]; then detail="${detail:0:33}.."; fi
-
-      printf "  %b%s%b %s %b%s%b\n" \
-        "$DIM" "$short_ts" "$RESET" \
-        "$agent" \
-        "$DIM" "$detail" "$RESET"
-    done
-  fi
 }
 
 # ══════════════════════════════════════════
@@ -292,8 +340,8 @@ clear
 CURRENT_MODE=""
 
 while true; do
-  # 동적 모드 감지
-  if [ -f "$QUEUE" ]; then
+  # 동적 모드 감지 (--team 지정 시 항상 v4)
+  if [ -n "$TEAM_FILTER" ] || [ -f "$QUEUE" ]; then
     NEW_MODE="v4"
   else
     NEW_MODE="v3"

package/scripts/harness-studio-setup.sh

@@ -92,52 +92,48 @@ if [ -n "${TMUX:-}" ]; then
 fi
 
 # ══════════════════════════════════════════
-# Case B: tmux 밖에 있음 → 새 세션 생성
+# Case B: tmux 밖에 있음 → 새 세션 생성 + Terminal.app에서 자동 attach
 # ══════════════════════════════════════════
 
-# 이미 세션이 있으면 attach만
+# 이미 세션이 있으면 Terminal.app에서 attach만
 if tmux has-session -t "$SESSION_NAME" 2>/dev/null; then
-  echo "[studio] Session '$SESSION_NAME' already exists. Attaching..."
-  echo "[studio] ATTACH_TMUX=$SESSION_NAME"
+  echo "[studio] Session '$SESSION_NAME' already exists. Opening Terminal..."
+  osascript -e "tell application \"Terminal\" to do script \"tmux attach -t $SESSION_NAME\"" 2>/dev/null \
+    || echo "[studio] ATTACH_TMUX=$SESSION_NAME"
+  echo "[studio] OPENED_TERMINAL=true"
   exit 0
 fi
 
 echo "[studio] Creating new tmux session with 3-column layout..."
 
-# 1. 새 세션 → Left pane (Claude 실행)
-PANE_MAIN=$(tmux new-session -d -s "$SESSION_NAME" -c "$PROJECT_ROOT" -x 220 -y 55 \
-  -P -F '#{pane_id}')
-
-# 2. Left 35% | Right 65%
-PANE_MID=$(tmux split-window -h -p 65 -t "$PANE_MAIN" -c "$PROJECT_ROOT" \
+# 1. 새 세션 → Left pane (Dashboard 전용 — Claude는 현재 세션에서 계속)
+PANE_DASH=$(tmux new-session -d -s "$SESSION_NAME" -c "$PROJECT_ROOT" -x 220 -y 55 \
   -P -F '#{pane_id}' \
   "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-dashboard-v4.sh\" \"${PROJECT_ROOT}\"'")
 
-# 3. Middle 45% | Right 55%
-PANE_RIGHT=$(tmux split-window -h -p 55 -t "$PANE_MID" -c "$PROJECT_ROOT" \
+# 2. Split: Dashboard | Monitor
+PANE_RIGHT=$(tmux split-window -h -p 50 -t "$PANE_DASH" -c "$PROJECT_ROOT" \
   -P -F '#{pane_id}' \
   "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-monitor.sh\" \"${PROJECT_ROOT}\"'")
 
-# 4. Dashboard top 45% | History bottom 55%
-PANE_HISTORY=$(tmux split-window -v -p 55 -t "$PANE_MID" -c "$PROJECT_ROOT" \
+# 3. Split Dashboard vertically: Dashboard top | History bottom
+PANE_HISTORY=$(tmux split-window -v -p 55 -t "$PANE_DASH" -c "$PROJECT_ROOT" \
   -P -F '#{pane_id}' \
   "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-prompt-history.sh\" \"${PROJECT_ROOT}\"'")
 
-# 5. Left pane에서 Claude 자동 실행
-tmux send-keys -t "$PANE_MAIN" "unset npm_config_prefix 2>/dev/null" Enter
-tmux send-keys -t "$PANE_MAIN" "clear && $CLAUDE_CMD" Enter
-
 # Pane titles
-tmux select-pane -t "$PANE_MAIN"    -T "Lead (Claude)"
-tmux select-pane -t "$PANE_MID"     -T "Dashboard"
+tmux select-pane -t "$PANE_DASH"    -T "Dashboard"
 tmux select-pane -t "$PANE_HISTORY" -T "Command 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 Claude pane
-tmux select-pane -t "$PANE_MAIN"
+# Terminal.app에서 자동으로 tmux attach
+osascript -e "tell application \"Terminal\"
+  activate
+  do script \"tmux attach -t $SESSION_NAME\"
+end tell" 2>/dev/null
 
 echo "[studio] Session '$SESSION_NAME' created."
-echo "[studio] ATTACH_TMUX=$SESSION_NAME"
+echo "[studio] OPENED_TERMINAL=true"

package/scripts/harness-tmux-v4.sh

@@ -2,11 +2,11 @@
 # harness-tmux-v4.sh — v4 Agent Teams: 원커맨드 실행
 #
 # ┌──────────────┬──────────────┬──────────────┐
-# │              │  Dashboard   │              │
-# │  Main Claude │  (v4 queue)  │  Team Monitor│
-# │  (Lead)      ├──────────────┤  (lifecycle) │
-# │              │  Prompt      │              │
-# │              │  History     │              │
+# │              │  Dashboard   │   TEAM 1     │
+# │  Main Claude │  (v4 queue)  ├──────────────┤
+# │  (Lead)      ├──────────────┤   TEAM 2     │
+# │              │  Prompt      ├──────────────┤
+# │              │  History     │   TEAM 3     │
 # └──────────────┴──────────────┴──────────────┘
 #
 # Usage:
@@ -80,10 +80,20 @@ PANE_MAIN=$(tmux new-session -d -s "$SESSION_NAME" -c "$PROJECT_ROOT" -x 220 -y
 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" \
+# 3. Split right section: Middle 45% | Right 55% — Right는 TEAM 1 으로 시작
+PANE_T1=$(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}\"'")
+  "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-monitor.sh\" \"${PROJECT_ROOT}\" --team 1'")
+
+# 3b. Split TEAM 1 세로로 → TEAM 2 (하단 66%)
+PANE_T2=$(tmux split-window -v -p 66 -t "$PANE_T1" -c "$PROJECT_ROOT" \
+  -P -F '#{pane_id}' \
+  "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-monitor.sh\" \"${PROJECT_ROOT}\" --team 2'")
+
+# 3c. Split TEAM 2 세로로 → TEAM 3 (하단 50%)
+PANE_T3=$(tmux split-window -v -p 50 -t "$PANE_T2" -c "$PROJECT_ROOT" \
+  -P -F '#{pane_id}' \
+  "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-monitor.sh\" \"${PROJECT_ROOT}\" --team 3'")
 
 # 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" \
@@ -109,7 +119,9 @@ fi
 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 select-pane -t "$PANE_T1"      -T "TEAM 1"
+tmux select-pane -t "$PANE_T2"      -T "TEAM 2"
+tmux select-pane -t "$PANE_T3"      -T "TEAM 3"
 
 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

package/skills/team-action/SKILL.md

@@ -16,19 +16,8 @@ bash scripts/harness-studio-setup.sh .
 
 스크립트 출력을 확인합니다:
 
-- **`Layout ready`** → 현재 터미널에 split 완료. 바로 Step 1로.
-- **`ATTACH_TMUX=harness-studio`** → 새 tmux 세션이 생성됨 (tmux 밖에서 실행한 경우).
-  사용자에게 아래 안내를 출력하고 **STOP**합니다:
-
-  ```
-  Studio 레이아웃이 준비되었습니다!
-  다른 터미널에서 아래 명령을 실행하세요:
-
-    tmux attach -t harness-studio
-
-  새 창에서 Claude가 자동 실행됩니다. 거기서 "팀 가동"을 입력하면 Teams가 시작됩니다.
-  ```
-
+- **`Layout ready`** → tmux 안에서 split 완료. 바로 Step 1로.
+- **`OPENED_TERMINAL=true`** → 새 Terminal.app 창에 Studio가 자동으로 열림. 바로 Step 1로.
 - **`already set up`** → 이미 구축됨. 바로 Step 1로.
 
 ## Step 1: Queue 초기화
@@ -73,25 +62,99 @@ Agent({
 ## 할당된 Feature
 - Feature ID: {FEATURE_ID}
 - 프로젝트 루트: 현재 디렉토리 (worktree 복사본)
+- 하네스 루트: 메인 프로젝트 루트 (worktree가 아닌 원본)
+
+## 실시간 로깅 (필수)
+
+Monitor 패널에서 **각 에이전트(Gen / Eval / Result)가 지금 무엇을 하고 있는지**가 보여야 합니다.
+Phase 전환뿐 아니라 **내부 하위 단계**(파일 읽기, 파일 쓰기, 테스트 실행, AC 검증 등)까지
+progress.log에 한 줄씩 남기세요. 대시보드는 3초마다 tail합니다.
+
+**로깅 원칙**
+- 의미 있는 동작마다 **한 줄씩** 즉시 기록 (파일 단위가 아니라 행위 단위)
+- ACTION 토큰은 아래 표에서 선택 (Monitor가 아이콘/색을 매핑)
+- DETAIL은 구체적으로 — 파일명, AC 번호, 에러 메시지 요약, 결정 사유
+
+| ACTION | 사용 시점 | DETAIL 예시 |
+|--------|-----------|-------------|
+| `gen-start`  | Gen Phase 시작 | `F-001 start — 6 AC` |
+| `gen-read`   | 소스/계약 읽기 | `read api-contract.json (POST /users)` |
+| `gen-write`  | 파일 생성/수정 | `write apps/service-user/src/user.controller.ts` |
+| `gen-test`   | 자체 게이트(tsc/eslint/jest) | `tsc OK · eslint 0 · jest 12/12` |
+| `gen-done`   | Gen Phase 종료 | `F-001 done — 5 files, 142 LOC` |
+| `eval-start` | Evaluator Agent 호출 시작 | `F-001 spawning evaluator` |
+| `eval-check` | AC 개별 검증 진행 | `AC-3 — verify POST /users returns 201` |
+| `eval-done`  | Eval 결과 수신 | `verdict=PASS score=2.95` |
+| `result` / `pass` | PASS 확정 | `F-001 PASS — queue.pass` |
+| `fail`       | FAIL 확정(재시도/최종) | `FAIL #1 — AC-2 missing` |
+
+**progress.log 기록** (하네스 루트의 progress.log에 append):
+```bash
+echo "$(date +'%Y-%m-%d %H:%M') | team-{N} | {ACTION} | {DETAIL}" >> {HARNESS_ROOT}/.harness/progress.log
+```
+
+**queue phase 업데이트** (feature-queue.json의 팀 상태 갱신):
+```bash
+bash {HARNESS_ROOT}/scripts/harness-queue-manager.sh update_phase {FEATURE_ID} {PHASE} .
+```
+
+> {HARNESS_ROOT}는 worktree의 원본 프로젝트 경로입니다. `git worktree list` 첫 줄에서 확인 가능합니다.
+> 워커 시작 시 먼저 실행: `HARNESS_ROOT=$(git worktree list | head -1 | awk '{print $1}')`
 
 ## Phase 1: Generator (코드 생성)
 
-1. Feature 정보 확인:
+**시작 시 로깅:**
+```bash
+HARNESS_ROOT=$(git worktree list | head -1 | awk '{print $1}')
+LOG="$HARNESS_ROOT/.harness/progress.log"
+logev() { echo "$(date +'%Y-%m-%d %H:%M') | team-{N} | $1 | $2" >> "$LOG"; }
+
+logev gen-start "{FEATURE_ID} start"
+bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" update_phase {FEATURE_ID} gen "$HARNESS_ROOT"
+```
+
+1. Feature 정보 확인 — **각 읽기마다 로그**:
+   ```bash
+   logev gen-read "feature-list.json → {FEATURE_ID}"
+   logev gen-read "api-contract.json → {관련 엔드포인트}"
+   ```
    - `jq '.features[] | select(.id == "{FEATURE_ID}")' .harness/actions/feature-list.json`
    - `.harness/actions/api-contract.json`에서 관련 엔드포인트 확인
    - AC(Acceptance Criteria) 목록을 정확히 파악
 
-2. 코드 생성:
+2. 코드 생성 — **파일 쓰기마다 로그**:
+   ```bash
+   logev gen-write "apps/service-user/src/user.controller.ts"
+   logev gen-write "libs/shared-dto/src/user.dto.ts"
+   ```
    - AGENTS.md의 IA-MAP에 따라 올바른 디렉토리에 코드 작성
    - AC의 모든 항목을 충족하도록 구현
 
-3. Pre-eval 게이트 (자체):
+3. Pre-eval 게이트 (자체) — **결과 로그**:
+   ```bash
+   logev gen-test "tsc OK · eslint 0w 0e · jest 12/12"
+   ```
    - tsc (타입 체크) 실행
    - eslint (린트) 실행
    - 컴파일 에러가 있으면 직접 수정 (Eval에 넘기지 않음)
 
+**Gen 완료 로깅:**
+```bash
+logev gen-done "{FEATURE_ID} done — {변경파일수} files, {LOC} LOC"
+```
+
 ## Phase 2: Evaluator (독립 평가 — Agent 도구 사용)
 
+**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를 생성하여 평가**합니다.
 이 Evaluator Agent는 당신(Generator)의 추론 과정을 모릅니다.
 오직 코드와 AC만 보고 판단합니다.
@@ -137,15 +200,24 @@ FEEDBACK: (FAIL인 경우만) 구체적 수정 지시
 Evaluator Agent 결과를 확인합니다:
 
 ### PASS인 경우 (VERDICT: PASS, SCORE ≥ 2.80):
-1. `bash scripts/harness-queue-manager.sh pass {FEATURE_ID} .` 실행
-2. 변경 파일 목록과 AC 충족 요약을 Lead에게 반환
+```bash
+logev result "{FEATURE_ID} PASS score={SCORE} — merging"
+bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" pass {FEATURE_ID} "$HARNESS_ROOT"
+```
+변경 파일 목록과 AC 충족 요약을 Lead에게 반환.
 
 ### FAIL인 경우:
+```bash
+logev fail "{FEATURE_ID} FAIL #{ATTEMPT} — {사유요약}"
+```
 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에게 반환
+   ```bash
+   logev fail "{FEATURE_ID} FINAL FAIL after 3 attempts"
+   bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" fail {FEATURE_ID} "$HARNESS_ROOT"
+   ```
+   실패 사유와 마지막 Eval 결과를 Lead에게 반환.
 ```
 
 ## Step 4: 결과 수집 및 다음 라운드

package/skills/team-stop/SKILL.md

@@ -1,19 +1,30 @@
 ---
 name: harness-team-stop
-description: "v4 Agent Teams 중지. 실행 중인 Teammate를 모두 해산한다. 트리거: '/harness-team-stop', 'team 중지', 'agent team 멈춰', '팀 멈춰', '팀 중지'"
+description: "v4 Agent Teams 중지 + Studio 정리. 실행 중인 Teammate 해산, tmux 세션 종료. 트리거: '/harness-team-stop', 'team 중지', 'agent team 멈춰', '팀 멈춰', '팀 중지'"
 disable-model-invocation: false
 ---
 
 # /harness-team-stop — Agent Teams 중지
 
-## 실행
+## Step 1: Queue 상태 저장
 
-모든 Teammate에게 현재 작업을 마무리하고 종료하라고 메시지를 보내세요.
+현재 in_progress feature를 ready로 복구합니다 (재시작 시 이어서 가능):
 
-Queue 상태는 보존되므로, `/harness-team-action`으로 다시 시작할 수 있습니다.
+```bash
+bash scripts/harness-queue-manager.sh recover .
+bash scripts/harness-queue-manager.sh status .
+```
+
+## Step 2: tmux Studio 세션 정리
+
+```bash
+tmux kill-session -t harness-studio 2>/dev/null && echo "Studio session killed." || echo "No studio session."
+```
 
-## 재시작
+## Step 3: 완료 안내
 
 ```
-❯ /harness-team-action
+Teams 중지 완료.
+- Queue 상태 보존됨 (in_progress → ready로 복구)
+- 재시작: /harness-team-action
 ```