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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "4.0.0-beta.4",
+  "version": "4.0.0-beta.5",
   "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-setup.sh

@@ -1,19 +1,19 @@
 #!/bin/bash
-# harness-studio-setup.sh — Claude 세션 내부에서 실행하여 3-column 레이아웃 자동 구축
-#
-# Claude가 이미 실행 중인 tmux pane에서 호출됨.
-# 현재 pane(Claude가 있는 곳)을 Left로 유지하고,
-# Center(Dashboard + History)와 Right(Monitor)를 split으로 생성.
+# harness-studio-setup.sh — Claude 세션에서 3-column 레이아웃 자동 구축
 #
 # ┌──────────────┬──────────────┬──────────────┐
 # │              │  Dashboard   │              │
-# │  여기서      │  (v4 queue)  │  Team Monitor│
-# │  Claude 실행중├──────────────┤  (lifecycle) │
+# │  Claude      │  (v4 queue)  │  Team Monitor│
+# │  (Lead)      ├──────────────┤  (lifecycle) │
 # │              │  Command     │              │
 # │              │  History     │              │
 # └──────────────┴──────────────┴──────────────┘
 #
-# Usage (Claude가 bash 도구로 호출):
+# 두 가지 상황을 모두 처리:
+#   A) tmux 안에서 실행 → 현재 pane을 split하여 레이아웃 구축
+#   B) tmux 밖에서 실행 → 새 tmux 세션 생성, Claude를 좌측 pane에서 재실행
+#
+# Usage:
 #   bash scripts/harness-studio-setup.sh [project-root]
 #
 # 이미 구축됐으면 skip (멱등성 보장)
@@ -21,6 +21,7 @@
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+SESSION_NAME="harness-studio"
 
 PROJECT_ROOT="${1:-}"
 if [ -z "$PROJECT_ROOT" ]; then
@@ -36,53 +37,107 @@ if [ -z "$PROJECT_ROOT" ] || [ ! -d "$PROJECT_ROOT/.harness" ]; then
   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
+# ── Resolve Claude command ──
+CLAUDE_CMD="claude --dangerously-skip-permissions"
+if [ -f "$PROJECT_ROOT/.harness/handoff.json" ]; then
+  _model=$(jq -r '.model // empty' "$PROJECT_ROOT/.harness/handoff.json" 2>/dev/null)
+  if [ -n "$_model" ] && [ "$_model" != "null" ]; then
+    CLAUDE_CMD="$CLAUDE_CMD --model $_model"
+  fi
+fi
+
+# ══════════════════════════════════════════
+# Case A: 이미 tmux 안에 있음 → pane split
+# ══════════════════════════════════════════
+if [ -n "${TMUX:-}" ]; then
+  # 멱등성: 이미 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=$(tmux display-message -p '#{pane_id}')
+  echo "[studio] Setting up 3-column layout (in-place 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}\"'")
+
+  # 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}\"'")
+
+  # 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 (in-place)."
+  exit 0
 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."
+# ══════════════════════════════════════════
+# Case B: tmux 밖에 있음 → 새 세션 생성
+# ══════════════════════════════════════════
+
+# 이미 세션이 있으면 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"
   exit 0
 fi
 
-# ── 현재 pane = Claude (Left) ──
-PANE_CLAUDE=$(tmux display-message -p '#{pane_id}')
+echo "[studio] Creating new tmux session with 3-column layout..."
 
-echo "[studio] Setting up 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}')
 
-# ── Split: Left 35% | Right 65% ──
-PANE_MID=$(tmux split-window -h -p 65 -t "$PANE_CLAUDE" -c "$PROJECT_ROOT" \
+# 2. Left 35% | Right 65%
+PANE_MID=$(tmux split-window -h -p 65 -t "$PANE_MAIN" -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% ──
+# 3. 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%) ──
+# 4. 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)"
+# 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_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
+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
 
-# ── 포커스를 Claude pane으로 돌림 ──
-tmux select-pane -t "$PANE_CLAUDE"
+# Focus on Claude pane
+tmux select-pane -t "$PANE_MAIN"
 
-echo "[studio] Layout ready."
-echo "[studio]   Left   : Lead (Claude) — you are here"
-echo "[studio]   Center : Dashboard + Command History"
-echo "[studio]   Right  : Team Monitor"
+echo "[studio] Session '$SESSION_NAME' created."
+echo "[studio] ATTACH_TMUX=$SESSION_NAME"

package/skills/team-action/SKILL.md

@@ -8,14 +8,28 @@ disable-model-invocation: false
 
 ## Step 0: Studio 레이아웃 자동 구축
 
-tmux 내부에서 실행 중이면, 3-column 레이아웃을 자동 구축합니다:
+3-column 대시보드 레이아웃을 자동 구축합니다:
 
 ```bash
 bash scripts/harness-studio-setup.sh .
 ```
 
-> 이미 구축됐으면 자동 skip (멱등).
-> tmux 밖이면 경고만 출력하고 계속 진행 (필수는 아님).
+스크립트 출력을 확인합니다:
+
+- **`Layout ready`** → 현재 터미널에 split 완료. 바로 Step 1로.
+- **`ATTACH_TMUX=harness-studio`** → 새 tmux 세션이 생성됨 (tmux 밖에서 실행한 경우).
+  사용자에게 아래 안내를 출력하고 **STOP**합니다:
+
+  ```
+  Studio 레이아웃이 준비되었습니다!
+  다른 터미널에서 아래 명령을 실행하세요:
+
+    tmux attach -t harness-studio
+
+  새 창에서 Claude가 자동 실행됩니다. 거기서 "팀 가동"을 입력하면 Teams가 시작됩니다.
+  ```
+
+- **`already set up`** → 이미 구축됨. 바로 Step 1로.
 
 ## Step 1: Queue 초기화