@walwal-harness/cli 4.0.0-alpha.16 → 4.0.0-alpha.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "4.0.0-alpha.16",
+  "version": "4.0.0-alpha.18",
   "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-studio-v4.sh

@@ -1,12 +1,10 @@
 #!/bin/bash
-# harness-studio-v4.sh — Harness Studio v4: 3-Column + Dashboard Split
+# harness-studio-v4.sh — Harness Studio v4
 #
 # ┌──────────────┬──────────────┬──────────────┐
 # │              │  Progress    │  Team 1      │
-# │              │  (fixed)     ├──────────────┤
 # │  Main        ├──────────────┤  Team 2      │
-# │  (claude)    │  Prompts     ├──────────────┤
-# │              │  (scroll)    │  Team 3      │
+# │  (claude)    │  Prompts     │  Team 3      │
 # └──────────────┴──────────────┴──────────────┘
 
 set -euo pipefail
@@ -15,16 +13,10 @@ SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 SESSION_NAME="harness-v4"
 
 PROJECT_ROOT=""
-
 for arg in "$@"; do
   case "$arg" in
-    --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
-      ;;
+    --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
 
@@ -37,14 +29,14 @@ if [ -z "$PROJECT_ROOT" ]; then
 fi
 
 if [ -z "$PROJECT_ROOT" ] || [ ! -d "$PROJECT_ROOT/.harness" ]; then
-  echo "Error: .harness/ not found."
-  exit 1
+  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
+sleep 0.5
 
 # ── Init/recover queue ──
 QUEUE="$PROJECT_ROOT/.harness/actions/feature-queue.json"
@@ -57,90 +49,119 @@ else
 fi
 
 # ══════════════════════════════════════════
-# Layout: 3 columns first, then split middle column
-#
-# Step 1: [Main]
-# Step 2: [Main | Right]          — h split 66%
-# Step 3: [Main | Mid | Right]    — h split Mid from Right at 50%
-# Step 4: [Main | Progress / Prompts | Right]  — v split Mid
-# Step 5: [Main | Progress / Prompts | T1 / T2 / T3]  — v split Right
+# Build layout — all panes use direct command execution
+# Panes that exit will show "Pane is dead" instead of closing
 # ══════════════════════════════════════════
 
-# 1. Main
+tmux set-option -g remain-on-exit on 2>/dev/null || true
+
+# 1. Main (left, 34%)
 PANE_MAIN=$(tmux new-session -d -s "$SESSION_NAME" -c "$PROJECT_ROOT" -x 220 -y 55 \
   -P -F '#{pane_id}')
 
-# 2. Right column (will become Team area)
+# 2. Right area (66%) — will become Teams
 PANE_RIGHT=$(tmux split-window -h -p 66 -t "$PANE_MAIN" -c "$PROJECT_ROOT" \
-  -P -F '#{pane_id}')
+  -P -F '#{pane_id}' \
+  "bash '${SCRIPT_DIR}/harness-team-worker.sh' 1 '${PROJECT_ROOT}'")
 
-# 3. Middle column (split from Right, 50% = Mid gets left half, Right keeps right half)
+# 3. Middle column — split from Right (50/50)
 PANE_MID=$(tmux split-window -h -p 50 -t "$PANE_RIGHT" -c "$PROJECT_ROOT" \
-  -P -F '#{pane_id}')
-# Now: PANE_MID is the NEW pane (right side of split), PANE_RIGHT stays left
-# Wait — tmux split-window -h on PANE_RIGHT creates new pane to the RIGHT of PANE_RIGHT
-# So PANE_MID ends up on the right, and PANE_RIGHT is in the middle
-# We need to swap: split PANE_MAIN's right, then the rightmost becomes teams
-
-# Actually let me reconsider. After step 2:
-#   [Main 33%] [Right 66%]
-# After step 3 (split Right horizontally at 50%):
-#   [Main 33%] [Right_left 33%] [Right_right 33%]
-# Right_left = PANE_RIGHT (original), Right_right = PANE_MID (new)
-# We want: Right_left = Dashboard area, Right_right = Team area
-# So PANE_RIGHT becomes Dashboard, PANE_MID becomes Teams. But pane IDs...
-# Actually: split-window creates the NEW pane. -h splits horizontally.
-# The new pane goes to the right. So:
-#   PANE_RIGHT (original) = middle column (Dashboard)
-#   PANE_MID (new) = right column (Teams)
-# Perfect!
-
-# 4. Split middle column (PANE_RIGHT = Dashboard area) into Progress + Prompts
-#    Kill the shell in PANE_RIGHT first, replace with Progress
-tmux send-keys -t "$PANE_RIGHT" "exec bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-dashboard-v4.sh\" \"${PROJECT_ROOT}\"'" Enter
-
-PANE_PROMPTS=$(tmux split-window -v -p 40 -t "$PANE_RIGHT" -c "$PROJECT_ROOT" \
   -P -F '#{pane_id}' \
-  "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-prompts-v4.sh\" \"${PROJECT_ROOT}\"'")
+  "bash '${SCRIPT_DIR}/harness-team-worker.sh' 2 '${PROJECT_ROOT}'")
 
-# 5. Split right column (PANE_MID = Team area) into Team 1/2/3
-tmux send-keys -t "$PANE_MID" "exec bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-team-worker.sh\" 1 \"${PROJECT_ROOT}\"'" Enter
+# Now layout: [Main 34%] [Right 33%] [Mid 33%]
+# Right = Team 1, Mid = Team 2
+# But we need: [Main] [Dashboard area] [Teams area]
+# Swap: Right should be dashboard, Mid should stay as teams
+# Actually after split: PANE_RIGHT stays left (=Team1), PANE_MID is new right (=Team2)
+# We need to rethink...
 
-PANE_T2=$(tmux split-window -v -p 66 -t "$PANE_MID" -c "$PROJECT_ROOT" \
-  -P -F '#{pane_id}' \
-  "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-team-worker.sh\" 2 \"${PROJECT_ROOT}\"'")
+# Let me use a cleaner approach: create all columns first with placeholder shells
 
-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-team-worker.sh\" 3 \"${PROJECT_ROOT}\"'")
+tmux kill-session -t "$SESSION_NAME" 2>/dev/null || true
+sleep 0.3
+
+# === Clean rebuild ===
+
+# Pane 0: Main
+tmux new-session -d -s "$SESSION_NAME" -c "$PROJECT_ROOT" -x 220 -y 55
 
-# ── Launch Claude in Main ──
-tmux send-keys -t "$PANE_MAIN" "unset npm_config_prefix 2>/dev/null; clear && claude --dangerously-skip-permissions" Enter
+# Split: [Main 34% | Rest 66%]
+tmux split-window -h -p 66 -t "${SESSION_NAME}:0.0" -c "$PROJECT_ROOT"
 
-# ── Pane titles ──
-tmux select-pane -t "$PANE_MAIN"    -T "Main"
-tmux select-pane -t "$PANE_RIGHT"   -T "Progress"
-tmux select-pane -t "$PANE_PROMPTS" -T "Prompts"
-tmux select-pane -t "$PANE_MID"     -T "Team 1"
-tmux select-pane -t "$PANE_T2"      -T "Team 2"
-tmux select-pane -t "$PANE_T3"      -T "Team 3"
+# Split Rest: [Main 34% | Mid 50% | Right 50%]  (of the 66%)
+tmux split-window -h -p 50 -t "${SESSION_NAME}:0.1" -c "$PROJECT_ROOT"
+
+# Now: pane 0 = Main (left), pane 1 = Mid, pane 2 = Right
+# Split Mid vertically: Progress (60%) / Prompts (40%)
+tmux split-window -v -p 40 -t "${SESSION_NAME}:0.1" -c "$PROJECT_ROOT"
+
+# Now: pane 0=Main, pane 1=Mid-top(Progress), pane 2=Right, pane 3=Mid-bottom(Prompts)
+# Split Right into 3 Teams
+tmux split-window -v -p 66 -t "${SESSION_NAME}:0.2" -c "$PROJECT_ROOT"
+tmux split-window -v -p 50 -t "${SESSION_NAME}:0.3" -c "$PROJECT_ROOT"
+
+# Now 6 panes. Let's identify them by listing:
+# pane 0 = Main (left)
+# pane 1 = Progress (mid-top)
+# pane 2 = Team area top
+# pane 3 = Prompts (mid-bottom)
+# pane 4 = Team area mid (split from pane 2's bottom sibling? — tmux numbering is tricky)
+
+# Instead of guessing pane numbers, send commands to each pane by index after creation
+# First set remain-on-exit for this session
+tmux set-option -t "$SESSION_NAME" remain-on-exit on 2>/dev/null || true
+
+# Get all pane IDs in order
+PANES=($(tmux list-panes -t "$SESSION_NAME" -F '#{pane_id}'))
+
+# Should be 6 panes. Assign by position:
+# Visual order (left-to-right, top-to-bottom):
+# [0] Main  [1] Progress  [2] Team-top
+#           [3] Prompts   [4] Team-mid
+#                         [5] Team-bottom
+
+if [ ${#PANES[@]} -ne 6 ]; then
+  echo "ERROR: Expected 6 panes, got ${#PANES[@]}"
+  echo "Panes: ${PANES[*]}"
+  tmux attach -t "$SESSION_NAME"
+  exit 1
+fi
+
+P_MAIN="${PANES[0]}"
+P_PROGRESS="${PANES[1]}"
+P_TEAM1="${PANES[2]}"
+P_PROMPTS="${PANES[3]}"
+P_TEAM2="${PANES[4]}"
+P_TEAM3="${PANES[5]}"
+
+# Send commands to each pane
+tmux send-keys -t "$P_MAIN" "unset npm_config_prefix 2>/dev/null; clear && claude --dangerously-skip-permissions" Enter
+tmux send-keys -t "$P_PROGRESS" "bash '${SCRIPT_DIR}/harness-dashboard-v4.sh' '${PROJECT_ROOT}'" Enter
+tmux send-keys -t "$P_PROMPTS" "bash '${SCRIPT_DIR}/harness-prompts-v4.sh' '${PROJECT_ROOT}'" Enter
+tmux send-keys -t "$P_TEAM1" "bash '${SCRIPT_DIR}/harness-team-worker.sh' 1 '${PROJECT_ROOT}'" Enter
+tmux send-keys -t "$P_TEAM2" "bash '${SCRIPT_DIR}/harness-team-worker.sh' 2 '${PROJECT_ROOT}'" Enter
+tmux send-keys -t "$P_TEAM3" "bash '${SCRIPT_DIR}/harness-team-worker.sh' 3 '${PROJECT_ROOT}'" Enter
+
+# Titles
+tmux select-pane -t "$P_MAIN"     -T "Main"
+tmux select-pane -t "$P_PROGRESS" -T "Progress"
+tmux select-pane -t "$P_PROMPTS"  -T "Prompts"
+tmux select-pane -t "$P_TEAM1"    -T "Team 1"
+tmux select-pane -t "$P_TEAM2"    -T "Team 2"
+tmux select-pane -t "$P_TEAM3"    -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
 
-# ── Focus Main ──
-tmux select-pane -t "$PANE_MAIN"
+# Focus Main
+tmux select-pane -t "$P_MAIN"
 
-# ── Attach ──
+# Attach
 if [ -n "${TMUX:-}" ]; then
   tmux switch-client -t "$SESSION_NAME"
 else
   echo ""
   echo "Launching Harness Studio v4..."
-  echo "  Main (left)       : Claude interactive"
-  echo "  Progress (mid↑)   : Queue + Teams + Features"
-  echo "  Prompts (mid↓)    : Manual prompts + activity"
-  echo "  Team 1-3 (right)  : Parallel workers"
-  echo ""
   tmux attach -t "$SESSION_NAME"
 fi

package/skills/team/SKILL.md

@@ -1,27 +1,77 @@
 ---
 name: harness-team
-description: "v4 Parallel Agent Teams 모드 실행. 3개 Team이 Feature 단위 Gen→Eval 루프를 병렬 실행하는 tmux Studio를 띄운다."
+description: "v4 Parallel Agent Teams 모드 활성화. feature-queue 초기화 후 3개 Team worker를 백그라운드 실행한다. 트리거: '/harness-team', 'agent team 시작', 'team 모드'"
+disable-model-invocation: false
 ---
 
-# /harness-team — Parallel Agent Teams
+# /harness-team — Parallel Agent Teams 활성화
 
-이 스킬이 호출되면 **즉시** tmux Studio v4를 실행합니다.
+## 이 스킬이 호출되면
+
+1. **feature-queue.json 확인/초기화** — 없으면 feature-list.json에서 생성, 있으면 stale 복구
+2. **3개 Team Worker를 백그라운드로 시작** — 각각 claude -p로 Gen→Eval 루프 자율 실행
+3. **현재 세션은 유지** — 사용자는 오케스트레이터 역할 (모니터링, 실패 대응, 수동 개입)
 
 ## 실행 절차
 
-1. `npx walwal-harness v4` 를 Bash로 실행
-2. 현재 Claude 세션은 종료됨 (tmux가 터미널을 인수)
-3. tmux Studio v4 레이아웃이 활성화:
-   - Main (left): Claude --dangerously-skip-permissions 자동 실행
-   - Dashboard (mid): Feature Queue + Team 상태 실시간 갱신
-   - Team 1~3 (right): claude -p headless worker 자동 실행
+아래 명령을 순서대로 실행하세요:
+
+### Step 1: Queue 초기화/복구
+
+```bash
+bash scripts/harness-queue-manager.sh init .
+```
+
+이미 queue가 있으면:
+
+```bash
+bash scripts/harness-queue-manager.sh recover .
+```
+
+### Step 2: Team Worker 백그라운드 실행
+
+```bash
+nohup bash scripts/harness-team-worker.sh 1 . > /tmp/harness-team-1.log 2>&1 &
+nohup bash scripts/harness-team-worker.sh 2 . > /tmp/harness-team-2.log 2>&1 &
+nohup bash scripts/harness-team-worker.sh 3 . > /tmp/harness-team-3.log 2>&1 &
+```
+
+### Step 3: 상태 확인
+
+```bash
+bash scripts/harness-queue-manager.sh status .
+```
+
+## 실행 후 역할
+
+이 세션은 **오케스트레이터**입니다:
+- `/harness-generator-*`, `/harness-evaluator-*` 스킬 호출 금지 (Teams가 처리)
+- 할 수 있는 것: 큐 상태 확인, 실패 분석, 코드 리뷰, gotcha 등록, requeue
+
+### 유용한 명령
+
+```bash
+# 큐 상태
+bash scripts/harness-queue-manager.sh status .
+
+# 실패한 feature 재큐
+bash scripts/harness-queue-manager.sh requeue F-XXX .
+
+# Team 로그 실시간 확인
+tail -f /tmp/harness-team-1.log
+tail -f /tmp/harness-team-2.log
+tail -f /tmp/harness-team-3.log
+
+# 모든 Team 중지
+pkill -f harness-team-worker || true
+```
 
-## 실행
+## tmux Studio (선택사항)
 
-아래 명령을 **반드시 실행**하세요. 설명이나 확인 없이 바로 실행합니다:
+별도 터미널에서 tmux 레이아웃을 원하면:
 
 ```bash
-exec npx walwal-harness v4
+npx walwal-harness v4
 ```
 
-위 명령은 `exec`로 현재 셸을 대체하므로, Claude 세션이 tmux Studio로 전환됩니다.
+이 명령은 **Claude 세션 밖에서** (일반 터미널에서) 실행해야 합니다.