@walwal-harness/cli 4.0.0-alpha.15 → 4.0.0-alpha.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "4.0.0-alpha.15",
+  "version": "4.0.0-alpha.17",
   "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/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/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 세션 밖에서** (일반 터미널에서) 실행해야 합니다.