@walwal-harness/cli 4.0.0-alpha.9 → 4.0.0-beta.2

package/assets/templates/config.json

@@ -133,62 +133,15 @@
         ]
       }
     },
-    "generator-frontend-flutter": {
-      "role": "Flutter 앱 개발 — Riverpod, integrated_data_layer(Retrofit), i18n(ARB), build_runner",
-      "skill": "harness-generator-frontend-flutter",
-      "inputs": ["actions/plan.md", "actions/feature-list.json", "actions/api-contract.json", "actions/sprint-contract.md"],
-      "outputs": ["code:flutter", "actions/sprint-contract.md"],
-      "order": 2,
-      "fe_stack": "flutter",
-      "model": "sonnet",
-      "thinking_mode": null
-    },
-    "evaluator-functional-flutter": {
-      "role": "Flutter 앱 검증 — flutter analyze, flutter test, build_runner 일관성, 안티패턴 정적 검증",
-      "skill": "harness-evaluator-functional-flutter",
-      "tools": ["bash:flutter", "bash:dart"],
-      "inputs": ["actions/sprint-contract.md"],
-      "outputs": ["actions/evaluation-functional.md"],
-      "fe_stack": "flutter",
-      "model": "opus",
-      "thinking_mode": "ultrathink"
-    }
   },
   "flow": {
     "sequence": ["dispatcher", "planner", "generator-backend", "generator-frontend", "evaluator-functional", "evaluator-visual"],
     "pipeline_selection": {
-      "comment": "Dispatcher가 pipeline.json으로 활성 에이전트를 결정. fe_stack 필드로 React/Flutter를 구분. harness-next.sh가 pipeline.json.fe_stack 을 읽어 generator-frontend/evaluator-functional 을 Flutter 변형으로 치환한다.",
+      "comment": "Dispatcher가 pipeline.json으로 활성 에이전트를 결정.",
       "pipelines": {
         "FULLSTACK": ["planner", "generator-backend", "generator-frontend", "evaluator-functional", "evaluator-visual"],
         "FE-ONLY": ["planner:light", "generator-frontend", "evaluator-functional", "evaluator-visual"],
         "BE-ONLY": ["planner", "generator-backend", "evaluator-functional:api-only"]
-      },
-      "fe_stack_substitution": {
-        "comment": "pipeline.json.fe_stack + fe_target 에 따라 FE 에이전트 치환. Flutter Web 은 React 와 동일한 Playwright 기반 evaluator 를 사용한다.",
-        "flutter": {
-          "_doc": "fe_target = web | mobile | desktop. by_target 으로 분기.",
-          "by_target": {
-            "web": {
-              "_doc": "Flutter Web — 컴파일 결과가 HTML+JS+CSS 이므로 Playwright evaluator 사용 가능",
-              "generator-frontend": "generator-frontend-flutter",
-              "evaluator-functional": "evaluator-functional",
-              "evaluator-visual": "evaluator-visual"
-            },
-            "mobile": {
-              "_doc": "Flutter Mobile (Android/iOS) — 브라우저 없음, 정적 분석 evaluator 사용",
-              "generator-frontend": "generator-frontend-flutter",
-              "evaluator-functional": "evaluator-functional-flutter",
-              "evaluator-visual": "__skip__"
-            },
-            "desktop": {
-              "_doc": "Flutter Desktop (macOS/Windows/Linux) — 브라우저 없음, 정적 분석 evaluator 사용",
-              "generator-frontend": "generator-frontend-flutter",
-              "evaluator-functional": "evaluator-functional-flutter",
-              "evaluator-visual": "__skip__"
-            }
-          },
-          "_default_target": "mobile"
-        }
       }
     },
     "sprint_execution": {

package/assets/templates/gitignore-append.txt

@@ -0,0 +1 @@
+# For consumer projects, add .worktrees/ to .gitignore

package/bin/init.js

@@ -226,11 +226,8 @@ function installScripts() {
     'harness-eval-watcher.sh',
     'harness-tmux.sh',
     'harness-control.sh',
-    'harness-studio-v4.sh',
     'harness-dashboard-v4.sh',
-    'harness-control-v4.sh',
     'harness-queue-manager.sh',
-    'harness-team-worker.sh',
   ]);
 
   if (fs.existsSync(scriptsSrc)) {
@@ -575,7 +572,7 @@ Usage:
   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          Launch Studio v4 (3 Parallel Agent Teams)
+  npx walwal-harness v4          Enable Agent Teams (set env var + init queue)
   npx walwal-harness --help     Show this help
 
 What it does:
@@ -626,24 +623,51 @@ function runStudio() {
 }
 
 function runStudioV4() {
-  const scriptsDir = path.join(PKG_ROOT, 'scripts');
-  const tmuxScript = path.join(scriptsDir, 'harness-studio-v4.sh');
-
-  if (!fs.existsSync(tmuxScript)) {
-    log('ERROR: harness-studio-v4.sh not found. Update @walwal-harness/cli to >= 4.0.0');
-    process.exit(1);
+  // 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) {}
   }
 
-  try {
-    execSync('which tmux', { stdio: 'ignore' });
-  } catch {
-    log('ERROR: tmux is required. Install with: brew install tmux');
-    process.exit(1);
+  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) {}
+    }
   }
 
-  const cmd = `bash "${tmuxScript}" "${PROJECT_ROOT}"`.trim();
-  log('Launching Harness Studio v4 (Parallel Agent Teams)...');
-  execSync(cmd, { stdio: 'inherit' });
+  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('');
 }
 
 function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "4.0.0-alpha.9",
+  "version": "4.0.0-beta.2",
   "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

@@ -1,6 +1,6 @@
 #!/bin/bash
-# harness-dashboard-v4.sh — v4 Dashboard: Feature Queue + Team Status
-# Auto-refresh 3초 간격. feature-queue.json + feature-list.json 시각화.
+# harness-dashboard-v4.sh — v4 Dashboard 상단: Planner Progress
+# Queue + Teams + Features 를 auto-refresh. 고정 영역, 스크롤 없음.
 
 set -uo pipefail
 
@@ -30,42 +30,34 @@ render_header() {
   now=$(date +"%H:%M:%S")
   project_name=$(jq -r '.project_name // "Unknown"' "$PROGRESS" 2>/dev/null)
 
-  echo -e "${BOLD}╔════════════════════════════════════════════════╗${RESET}"
-  echo -e "${BOLD}║  HARNESS v4 — Parallel Agent Teams             ║${RESET}"
-  echo -e "${BOLD}╚════════════════════════════════════════════════╝${RESET}"
-  echo -e "  ${DIM}${project_name}  |  ${now}${RESET}"
-  echo ""
+  echo -e "${BOLD}HARNESS v4${RESET} ${DIM}${project_name} | ${now}${RESET}"
 }
 
 render_queue_summary() {
   if [ ! -f "$QUEUE" ]; then
-    echo -e "  ${DIM}(queue not initialized — run 'init' in Control)${RESET}"
+    echo -e "  ${DIM}(queue not initialized)${RESET}"
     return
   fi
 
-  local ready blocked in_prog passed failed total concurrency
+  local ready blocked in_prog passed failed total
   ready=$(jq '.queue.ready | length' "$QUEUE" 2>/dev/null || echo 0)
   blocked=$(jq '.queue.blocked | length' "$QUEUE" 2>/dev/null || echo 0)
   in_prog=$(jq '.queue.in_progress | length' "$QUEUE" 2>/dev/null || echo 0)
   passed=$(jq '.queue.passed | length' "$QUEUE" 2>/dev/null || echo 0)
   failed=$(jq '.queue.failed | length' "$QUEUE" 2>/dev/null || echo 0)
-  concurrency=$(jq '.concurrency // 3' "$QUEUE" 2>/dev/null || echo 3)
   ready=${ready:-0}; blocked=${blocked:-0}; in_prog=${in_prog:-0}; passed=${passed:-0}; failed=${failed:-0}
   total=$((ready + blocked + in_prog + passed + failed))
 
-  # Progress bar
   local pct=0
   if [ "$total" -gt 0 ]; then pct=$(( passed * 100 / total )); fi
-  local bar_w=20
+  local bar_w=16
   local filled=$(( pct * bar_w / 100 ))
   local empty=$(( bar_w - filled ))
   local bar=""
   for ((i=0; i<filled; i++)); do bar+="█"; done
   for ((i=0; i<empty; i++)); do bar+="░"; done
 
-  echo -e "  ${BOLD}Queue${RESET}  ${bar}  ${passed}/${total} (${pct}%)  ${DIM}concurrency=${concurrency}${RESET}"
-  echo -e "  Ready:${GREEN}${ready}${RESET}  Blocked:${YELLOW}${blocked}${RESET}  Progress:${CYAN}${in_prog}${RESET}  Pass:${GREEN}${passed}${RESET}  Fail:${RED}${failed}${RESET}"
-  echo ""
+  echo -e "  ${bar} ${passed}/${total} (${pct}%)  R:${GREEN}${ready}${RESET} B:${YELLOW}${blocked}${RESET} P:${CYAN}${in_prog}${RESET} ${GREEN}✓${passed}${RESET} ${RED}✗${failed}${RESET}"
 }
 
 render_teams() {
@@ -75,49 +67,44 @@ render_teams() {
   team_count=$(jq '.teams | length' "$QUEUE" 2>/dev/null)
   if [ "${team_count:-0}" -eq 0 ]; then return; fi
 
-  echo -e "  ${BOLD}Teams${RESET}"
-
   for i in $(seq 1 "$team_count"); do
     local t_status t_feature t_phase t_attempt
     t_status=$(jq -r ".teams[\"$i\"].status // \"idle\"" "$QUEUE" 2>/dev/null)
     t_feature=$(jq -r ".teams[\"$i\"].feature // \"—\"" "$QUEUE" 2>/dev/null)
 
-    # Get phase from in_progress
     if [ "$t_feature" != "—" ] && [ "$t_feature" != "null" ]; then
       t_phase=$(jq -r --arg f "$t_feature" '.queue.in_progress[$f].phase // "?"' "$QUEUE" 2>/dev/null)
       t_attempt=$(jq -r --arg f "$t_feature" '.queue.in_progress[$f].attempt // 1' "$QUEUE" 2>/dev/null)
     else
-      t_phase="—"
-      t_attempt="—"
+      t_phase="—"; t_attempt=""
     fi
 
     local icon color
     case "$t_status" in
-      busy)   icon="▶" ; color="$GREEN" ;;
-      idle)   icon="○" ; color="$DIM" ;;
-      paused) icon="⏸" ; color="$YELLOW" ;;
-      *)      icon="?" ; color="$RESET" ;;
+      busy)   icon="▶"; color="$GREEN" ;;
+      idle)   icon="○"; color="$DIM" ;;
+      *)      icon="?"; color="$RESET" ;;
     esac
 
-    local phase_display=""
+    local phase_short=""
     case "$t_phase" in
-      gen)  phase_display="${CYAN}GEN${RESET}" ;;
-      gate) phase_display="${YELLOW}GATE${RESET}" ;;
-      eval) phase_display="${MAGENTA}EVAL${RESET}" ;;
-      *)    phase_display="${DIM}${t_phase}${RESET}" ;;
+      gen)  phase_short="${CYAN}G${RESET}" ;;
+      gate) phase_short="${YELLOW}K${RESET}" ;;
+      eval) phase_short="${MAGENTA}E${RESET}" ;;
+      *)    phase_short="${DIM}-${RESET}" ;;
     esac
 
-    printf "  %b %b Team %d  %-8s %b  attempt %s\n" "$color" "$icon" "$i" "$t_feature" "$phase_display" "$t_attempt"
+    printf "  %b%b T%d %-7s %b" "$color" "$icon" "$i" "$t_feature" "$phase_short"
+    if [ -n "$t_attempt" ] && [ "$t_attempt" != "—" ]; then
+      printf " #%s" "$t_attempt"
+    fi
+    echo ""
   done
-  echo ""
 }
 
-render_feature_list() {
+render_features() {
   if [ ! -f "$QUEUE" ] || [ ! -f "$FEATURES" ]; then return; fi
 
-  echo -e "  ${BOLD}Features${RESET}"
-
-  # Single jq call: merge feature-list + queue state → pre-formatted lines
   jq -r --slurpfile q "$QUEUE" '
     ($q[0].queue.passed // []) as $passed |
     ($q[0].queue.failed // []) as $failed |
@@ -125,7 +112,7 @@ render_feature_list() {
     ($q[0].queue.in_progress // {}) as $prog |
     .features[] |
     .id as $fid |
-    (.name // .description // "?" | if length > 22 then .[0:20] + ".." else . end) as $fname |
+    (.name // .description // "?" | if length > 18 then .[0:16] + ".." else . end) as $fname |
     (if ($fid | IN($passed[])) then "P"
      elif $prog[$fid] then "I|\($prog[$fid].team)|\($prog[$fid].phase)"
      elif ($fid | IN($failed[])) then "F"
@@ -138,73 +125,25 @@ render_feature_list() {
       F)    printf "  ${RED}✗${RESET} %-6s %s\n" "$fid" "$fname" ;;
       R)    printf "  ${YELLOW}○${RESET} %-6s %s\n" "$fid" "$fname" ;;
       B)    printf "  ${DIM}◌${RESET} %-6s %s\n" "$fid" "$fname" ;;
-      I\|*) # in_progress: extract team and phase
-            team=$(echo "$st" | cut -d'|' -f2)
+      I\|*) team=$(echo "$st" | cut -d'|' -f2)
             phase=$(echo "$st" | cut -d'|' -f3)
-            printf "  ${CYAN}◐${RESET} %-6s %-18s T%s:%s\n" "$fid" "$fname" "$team" "$phase" ;;
+            printf "  ${CYAN}◐${RESET} %-6s %-14s T%s:%s\n" "$fid" "$fname" "$team" "$phase" ;;
       *)    printf "  ? %-6s %s\n" "$fid" "$fname" ;;
     esac
   done
-
-  echo ""
-}
-
-render_prompt_history() {
-  local log_file="$PROJECT_ROOT/.harness/progress.log"
-  if [ ! -f "$log_file" ]; then return; fi
-
-  # Get terminal height to limit display
-  local term_h
-  term_h=$(tput lines 2>/dev/null || echo 50)
-  local max_lines=10  # show latest 10 entries
-
-  echo -e "  ${BOLD}Prompt History${RESET} ${DIM}(newest first)${RESET}"
-
-  # Read non-comment lines, reverse (newest first), take max_lines
-  grep -v '^#' "$log_file" 2>/dev/null | grep -v '^$' | tail -r 2>/dev/null | head -"$max_lines" | \
-  while IFS= read -r line; do
-    # Parse: date | agent | action | detail
-    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" | sed 's/^[0-9]*-//')
-
-    case "$agent" in
-      dispatcher*|dispatch) icon="▸"; color="$MAGENTA" ;;
-      team-*)               icon="⚡"; color="$CYAN" ;;
-      manual|user)          icon="★"; color="$BOLD" ;;
-      planner*)             icon="□"; color="$YELLOW" ;;
-      generator*|gen*)      icon="▶"; color="$GREEN" ;;
-      eval*)                icon="✦"; color="$RED" ;;
-      system)               icon="⚙"; color="$DIM" ;;
-      *)                    icon="·"; color="$DIM" ;;
-    esac
-
-    if [ ${#detail} -gt 45 ]; then detail="${detail:0:43}.."; fi
-
-    echo -e "  ${color}${icon}${RESET} ${DIM}${short_ts}${RESET} ${agent} ${DIM}${action}${RESET} ${detail}"
-  done
-
-  echo ""
 }
 
 render_all() {
   render_header
   render_queue_summary
   render_teams
-  render_prompt_history
-  render_feature_list
-  echo -e "  ${DIM}Refreshing every 3s${RESET}"
+  echo ""
+  render_features
 }
 
 # ── Main loop ──
 tput civis 2>/dev/null
 trap 'tput cnorm 2>/dev/null; exit 0' EXIT INT TERM
-
 clear
 
 while true; do

package/scripts/harness-next.sh

@@ -59,21 +59,10 @@ if [ -f "$PIPELINE_JSON" ]; then
 fi
 
 # ─────────────────────────────────────────
-# fe_stack + fe_target 치환 헬퍼
-#   pipeline_selection.pipelines 에서 읽은 에이전트명을 fe_stack/fe_target 에 따라 치환
-#   - react: 그대로
-#   - flutter+web: generator-frontend → generator-frontend-flutter 만 치환, eval 은 그대로 (Playwright 사용 가능)
-#   - flutter+mobile/desktop: eval 도 정적 분석용으로 치환, evaluator-visual 은 __skip__
+# fe_stack 치환 (no-op — Flutter 지원 제거됨, 하위 호환용 stub)
 # ─────────────────────────────────────────
 substitute_fe_stack() {
-  local agent="$1"
-  if [ "$fe_stack" != "flutter" ]; then
-    echo "$agent"
-    return
-  fi
-  local sub
-  sub=$(jq -r ".flow.pipeline_selection.fe_stack_substitution.${fe_stack}.by_target[\"${fe_target}\"][\"${agent}\"] // \"${agent}\"" "$CONFIG" 2>/dev/null)
-  echo "$sub"
+  echo "$1"
 }
 
 # ─────────────────────────────────────────
@@ -105,7 +94,7 @@ run_pre_eval_gate() {
   # current_agent가 generator가 아닌 경우 (예: dispatcher로 리라우팅된 상태),
   # completed_agents에서 마지막 generator를 찾는다
   case "$source_agent" in
-    generator-frontend|generator-frontend-flutter)
+    generator-frontend)
       location="frontend"
       checks_key="frontend_checks"
       ;;
@@ -118,7 +107,7 @@ run_pre_eval_gate() {
       local last_gen
       last_gen=$(jq -r '.completed_agents // [] | map(select(startswith("generator-"))) | last // empty' "$PROGRESS" 2>/dev/null)
       case "$last_gen" in
-        generator-frontend|generator-frontend-flutter)
+        generator-frontend)
           location="frontend"
           checks_key="frontend_checks"
           ;;

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

@@ -58,6 +58,16 @@ 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/dispatcher/SKILL.md

@@ -25,8 +25,13 @@ disable-model-invocation: false
    - `pipeline` → 선택된 파이프라인 (FULLSTACK/FE-ONLY/BE-ONLY)
    - `sprint.number` → `1`, `sprint.status` → `"in_progress"` (신규 파이프라인인 경우에만)
 2. `.harness/progress.log`에 요약 한 줄 추가
-3. **STOP. 다음 에이전트를 직접 호출하지 않는다.**
-4. 출력: `"✓ Dispatcher 완료. bash scripts/harness-next.sh 실행하여 다음 단계 확인."`
+3. **v4 모드 감지**: `.harness/actions/feature-queue.json` 파일이 존재하는지 확인
+   - **존재**: v4 Parallel Agent Teams 활성 상태. 별도 안내 없이 즉시 STOP.
+     출력: `"✓ Dispatcher 완료. Agent Teams가 자율 실행 중입니다."`
+   - **미존재**: v3 Classic 모드.
+     출력: `"✓ Dispatcher 완료. bash scripts/harness-next.sh 실행하여 다음 단계 확인."`
+4. **STOP. 다음 에이전트를 직접 호출하지 않는다.**
+   - v4 모드에서는 `/harness-team 실행하시겠습니까?` 같은 **질문을 하지 않는다**. Teams는 이미 실행 중이거나 사용자가 별도로 시작한다.
 
 ## Auto-Routing (UserPromptSubmit Hook)
 

package/skills/team-action/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: harness-team-action
+description: "v4 Agent Teams 가동. feature-queue를 초기화하고 3개 Teammate를 생성하여 Feature 병렬 실행. 트리거: '/harness-team-action', 'team 시작', '팀 가동'"
+disable-model-invocation: false
+---
+
+# /harness-team-action — Agent Teams 가동
+
+## 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 생성
+
+Queue의 `ready` 배열에서 Feature를 읽고, **3명의 Teammate를 즉시 생성**하세요.
+
+각 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에게 결과 보고
+
+**Teammate 이름**: team-1, team-2, team-3

package/skills/team-stop/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: harness-team-stop
+description: "v4 Agent Teams 중지. 실행 중인 Teammate를 모두 해산한다. 트리거: '/harness-team-stop', 'team 중지', 'agent team 멈춰', '팀 멈춰', '팀 중지'"
+disable-model-invocation: false
+---
+
+# /harness-team-stop — Agent Teams 중지
+
+## 실행
+
+모든 Teammate에게 현재 작업을 마무리하고 종료하라고 메시지를 보내세요.
+
+Queue 상태는 보존되므로, `/harness-team-action`으로 다시 시작할 수 있습니다.
+
+## 재시작
+
+```
+❯ /harness-team-action
+```

package/scripts/harness-control-v4.sh

@@ -1,97 +0,0 @@
-#!/bin/bash
-# harness-control-v4.sh — v4 Control Center
-#
-# Commands:
-#   init              Initialize feature queue
-#   start             Launch all idle team workers
-#   pause <team>      Pause team worker
-#   resume <team>     Resume team worker
-#   assign <fid> <t>  Force-assign feature to team
-#   requeue <fid>     Move failed feature back to ready
-#   concurrency <N>   Change parallel team count
-#   status / s        Show queue status
-#   log <message>     Add manual note
-#   help / h          Show help
-#   quit / q          Exit
-
-set -uo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-
-PROJECT_ROOT="${1:-}"
-if [ -z "$PROJECT_ROOT" ]; then
-  source "$SCRIPT_DIR/lib/harness-render-progress.sh"
-  PROJECT_ROOT="$(resolve_harness_root ".")" || { echo "[control] .harness/ not found."; exit 1; }
-fi
-
-QUEUE="$PROJECT_ROOT/.harness/actions/feature-queue.json"
-PROGRESS_LOG="$PROJECT_ROOT/.harness/progress.log"
-QUEUE_MGR="$SCRIPT_DIR/harness-queue-manager.sh"
-
-BOLD="\033[1m"
-DIM="\033[2m"
-GREEN="\033[32m"
-YELLOW="\033[33m"
-RED="\033[31m"
-CYAN="\033[36m"
-RESET="\033[0m"
-
-cmd_init() {
-  bash "$QUEUE_MGR" init "$PROJECT_ROOT"
-}
-
-cmd_status() {
-  bash "$QUEUE_MGR" status "$PROJECT_ROOT"
-}
-
-cmd_requeue() {
-  local fid="${1:-}"
-  if [ -z "$fid" ]; then echo -e "  ${RED}Usage: requeue <feature_id>${RESET}"; return; fi
-  bash "$QUEUE_MGR" requeue "$fid" "$PROJECT_ROOT"
-}
-
-cmd_log() {
-  local msg="$1"
-  if [ -z "$msg" ]; then echo -e "  ${RED}Usage: log <message>${RESET}"; return; fi
-  local ts
-  ts=$(date +"%Y-%m-%d")
-  echo "${ts} | manual | note | ${msg}" >> "$PROGRESS_LOG"
-  echo -e "  ${GREEN}Logged:${RESET} ${msg}"
-}
-
-show_help() {
-  echo ""
-  echo -e "  ${BOLD}Harness v4 Control${RESET}"
-  echo -e "  ${CYAN}init${RESET}                Initialize feature queue from feature-list.json"
-  echo -e "  ${CYAN}status${RESET}  / ${CYAN}s${RESET}         Show queue + team status"
-  echo -e "  ${CYAN}requeue${RESET} <fid>       Move failed feature back to ready"
-  echo -e "  ${CYAN}log${RESET} <message>       Add manual note to progress.log"
-  echo -e "  ${CYAN}help${RESET}   / ${CYAN}h${RESET}         Show this help"
-  echo -e "  ${CYAN}quit${RESET}   / ${CYAN}q${RESET}         Exit control"
-  echo ""
-  echo -e "  ${DIM}Teams auto-start when studio launches.${RESET}"
-  echo -e "  ${DIM}Workers auto-dequeue from the ready queue.${RESET}"
-  echo ""
-}
-
-# ── Main ──
-echo ""
-echo -e "  ${BOLD}Harness v4 Control${RESET}  ${DIM}(type 'help' for commands)${RESET}"
-echo ""
-
-while true; do
-  echo -ne "  ${BOLD}v4>${RESET} "
-  read -r input || exit 0
-  input=$(echo "$input" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
-
-  case "$input" in
-    init)           cmd_init ;;
-    status|s)       cmd_status ;;
-    requeue\ *)     cmd_requeue "${input#requeue }" ;;
-    log\ *)         cmd_log "${input#log }" ;;
-    help|h)         show_help ;;
-    quit|q)         echo -e "  ${DIM}Goodbye.${RESET}"; exit 0 ;;
-    "")             ;; # empty
-    *)              echo -e "  ${DIM}Unknown command. Type 'help'.${RESET}" ;;
-  esac
-done