@walwal-harness/cli 4.0.0-alpha.20 → 4.0.0-alpha.21

package/README.md

@@ -136,19 +136,44 @@ v4에서도 Planner는 먼저 실행해야 합니다:
 # Dispatcher → Planner → feature-list.json 생성
 ```
 
-### 3. Agent Teams 실행
+### 3. Studio 실행
 
-```
-❯ /harness-team
-```
-
-또는:
+**터미널에서** (Claude 세션 밖에서):
 
 ```bash
 npx walwal-harness v4
 ```
 
-### 4. tmux 레이아웃
+### 4. Teams 가동/중지
+
+Studio가 열리면 Main pane의 Claude에서:
+
+```
+❯ /harness-team-action    # Queue 초기화 + 3 Teams 백그라운드 실행
+❯ /harness-team-stop      # 모든 Teams 중지
+```
+
+**흐름 요약:**
+```
+npx walwal-harness v4     ← 터미널에서 Studio 실행
+  Main에서:
+    ❯ 하네스 엔지니어링 시작  ← Planner가 feature-list.json 생성
+    ❯ /harness-team-action   ← Queue 생성 + Teams 가동 → 자율 실행 시작
+    (모니터링, 개입, gotcha 등록...)
+    ❯ /harness-team-stop     ← 필요 시 중지
+```
+
+### 5. Team 관리 명령어
+
+| 명령 | 동작 |
+|------|------|
+| `/harness-team-action` | Queue 초기화 + 3 Teams 가동 |
+| `/harness-team-stop` | 모든 Teams 중지 |
+| `bash scripts/harness-queue-manager.sh status .` | Queue 상태 확인 |
+| `bash scripts/harness-queue-manager.sh requeue F-XXX .` | 실패한 Feature 재큐 |
+| `tail -f /tmp/harness-team-1.log` | Team 1 로그 실시간 확인 |
+
+### 6. tmux 레이아웃
 
 ```
 ┌──────────────┬──────────────┬──────────────┐
@@ -186,15 +211,20 @@ Team 1: dequeue F-002 → worktree 생성 → Gen → Gate → Eval
 - Feature PASS 시 main으로 **auto-merge** + worktree 즉시 삭제
 - Merge conflict 시 auto-rebase 시도
 
-### 6. Main에서 할 수 있는 것
+### 9. Main에서 할 수 있는 것
 
 Main Claude는 **오케스트레이터**입니다:
-- 대시보드 상태 확인 요청
-- 실패한 Feature 분석/피드백
-- 코드 리뷰, 아키텍처 판단
-- Gotcha 등록 (실수 지적 → 이후 Team에 반영)
 
-Main에서는 `/harness-generator-*`, `/harness-evaluator-*` 를 **직접 호출하지 않습니다** — Team이 처리합니다.
+| 할 수 있는 것 | 예시 |
+|--------------|------|
+| Teams 가동/중지 | `/harness-team-action`, `/harness-team-stop` |
+| 상태 확인 | `bash scripts/harness-queue-manager.sh status .` |
+| 실패 Feature 분석 | "F-003이 왜 실패했는지 로그 확인해줘" |
+| Feature 재큐 | `bash scripts/harness-queue-manager.sh requeue F-003 .` |
+| 코드 리뷰 | "F-002의 Sidebar 컴포넌트 리뷰해줘" |
+| Gotcha 등록 | "API 응답에 created_at은 ISO 8601이어야 해" |
+
+**하지 말 것:** `/harness-generator-*`, `/harness-evaluator-*` 직접 호출 — Team이 처리합니다.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "4.0.0-alpha.20",
+  "version": "4.0.0-alpha.21",
   "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/team-action/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: harness-team-action
+description: "v4 Agent Teams 시작. feature-queue를 초기화하고 3개 Team worker를 가동한다. 트리거: '/harness-team-action', 'team 시작', 'agent team 가동', '팀 시작'"
+disable-model-invocation: false
+---
+
+# /harness-team-action — Agent Teams 가동
+
+## 이 스킬이 호출되면
+
+feature-list.json에서 feature-queue.json을 생성(또는 복구)하고, Team worker 3개를 백그라운드 실행합니다. 이미 실행 중인 worker가 있으면 중복 실행하지 않습니다.
+
+## 실행 절차
+
+**아래 명령을 순서대로 실행하세요. 설명 없이 바로 실행합니다.**
+
+### 1. 기존 worker 정리 (중복 방지)
+
+```bash
+pkill -f "harness-team-worker" 2>/dev/null || true
+sleep 1
+```
+
+### 2. Queue 초기화 또는 복구
+
+feature-queue.json이 없으면 feature-list.json에서 생성합니다:
+
+```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
+```
+
+### 3. 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 &
+echo "3 Teams started. Logs: /tmp/harness-team-{1,2,3}.log"
+```
+
+### 4. 상태 확인
+
+```bash
+bash scripts/harness-queue-manager.sh status .
+```
+
+## 실행 후
+
+이 세션은 **오케스트레이터**입니다. Teams가 자율적으로 Gen→Eval을 수행합니다.
+- `/harness-generator-*`, `/harness-evaluator-*` 호출 금지
+- 상태 확인: `bash scripts/harness-queue-manager.sh status .`
+- 실패 feature 재큐: `bash scripts/harness-queue-manager.sh requeue F-XXX .`
+- 로그 확인: `tail -f /tmp/harness-team-1.log`
+- 중지: `/harness-team-stop`

package/skills/team-stop/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: harness-team-stop
+description: "v4 Agent Teams 중지. 실행 중인 Team worker 프로세스를 종료한다. 트리거: '/harness-team-stop', 'team 중지', 'agent team 멈춰', '팀 멈춰'"
+disable-model-invocation: false
+---
+
+# /harness-team-stop — Agent Teams 중지
+
+## 이 스킬이 호출되면
+
+실행 중인 모든 Team worker 프로세스를 종료합니다. Queue 상태는 보존되므로, `/harness-team-action`으로 다시 시작할 수 있습니다.
+
+## 실행 절차
+
+**아래 명령을 실행하세요:**
+
+```bash
+pkill -f "harness-team-worker" 2>/dev/null && echo "All Teams stopped." || echo "No running Teams found."
+```
+
+### 상태 확인
+
+```bash
+bash scripts/harness-queue-manager.sh status .
+```
+
+## 재시작하려면
+
+```
+❯ /harness-team-action
+```