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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@walwal-harness/cli",
3
- "version": "4.0.0-alpha.16",
3
+ "version": "4.0.0-alpha.17",
4
4
  "description": "Production harness for AI agent engineering — Planner, Generator(BE/FE), Evaluator(Func/Visual), optional Brainstormer (requirements refinement). Supports React and Flutter FE stacks.",
5
5
  "bin": {
6
6
  "walwal-harness": "bin/init.js"
@@ -1,27 +1,77 @@
1
1
  ---
2
2
  name: harness-team
3
- description: "v4 Parallel Agent Teams 모드 실행. 3개 Team Feature 단위 Gen→Eval 루프를 병렬 실행하는 tmux Studio를 띄운다."
3
+ description: "v4 Parallel Agent Teams 모드 활성화. feature-queue 초기화 후 3개 Team worker를 백그라운드 실행한다. 트리거: '/harness-team', 'agent team 시작', 'team 모드'"
4
+ disable-model-invocation: false
4
5
  ---
5
6
 
6
- # /harness-team — Parallel Agent Teams
7
+ # /harness-team — Parallel Agent Teams 활성화
7
8
 
8
- 이 스킬이 호출되면 **즉시** tmux Studio v4를 실행합니다.
9
+ ## 이 스킬이 호출되면
10
+
11
+ 1. **feature-queue.json 확인/초기화** — 없으면 feature-list.json에서 생성, 있으면 stale 복구
12
+ 2. **3개 Team Worker를 백그라운드로 시작** — 각각 claude -p로 Gen→Eval 루프 자율 실행
13
+ 3. **현재 세션은 유지** — 사용자는 오케스트레이터 역할 (모니터링, 실패 대응, 수동 개입)
9
14
 
10
15
  ## 실행 절차
11
16
 
12
- 1. `npx walwal-harness v4` 를 Bash로 실행
13
- 2. 현재 Claude 세션은 종료됨 (tmux가 터미널을 인수)
14
- 3. tmux Studio v4 레이아웃이 활성화:
15
- - Main (left): Claude --dangerously-skip-permissions 자동 실행
16
- - Dashboard (mid): Feature Queue + Team 상태 실시간 갱신
17
- - Team 1~3 (right): claude -p headless worker 자동 실행
17
+ 아래 명령을 순서대로 실행하세요:
18
+
19
+ ### Step 1: Queue 초기화/복구
20
+
21
+ ```bash
22
+ bash scripts/harness-queue-manager.sh init .
23
+ ```
24
+
25
+ 이미 queue가 있으면:
26
+
27
+ ```bash
28
+ bash scripts/harness-queue-manager.sh recover .
29
+ ```
30
+
31
+ ### Step 2: Team Worker 백그라운드 실행
32
+
33
+ ```bash
34
+ nohup bash scripts/harness-team-worker.sh 1 . > /tmp/harness-team-1.log 2>&1 &
35
+ nohup bash scripts/harness-team-worker.sh 2 . > /tmp/harness-team-2.log 2>&1 &
36
+ nohup bash scripts/harness-team-worker.sh 3 . > /tmp/harness-team-3.log 2>&1 &
37
+ ```
38
+
39
+ ### Step 3: 상태 확인
40
+
41
+ ```bash
42
+ bash scripts/harness-queue-manager.sh status .
43
+ ```
44
+
45
+ ## 실행 후 역할
46
+
47
+ 이 세션은 **오케스트레이터**입니다:
48
+ - `/harness-generator-*`, `/harness-evaluator-*` 스킬 호출 금지 (Teams가 처리)
49
+ - 할 수 있는 것: 큐 상태 확인, 실패 분석, 코드 리뷰, gotcha 등록, requeue
50
+
51
+ ### 유용한 명령
52
+
53
+ ```bash
54
+ # 큐 상태
55
+ bash scripts/harness-queue-manager.sh status .
56
+
57
+ # 실패한 feature 재큐
58
+ bash scripts/harness-queue-manager.sh requeue F-XXX .
59
+
60
+ # Team 로그 실시간 확인
61
+ tail -f /tmp/harness-team-1.log
62
+ tail -f /tmp/harness-team-2.log
63
+ tail -f /tmp/harness-team-3.log
64
+
65
+ # 모든 Team 중지
66
+ pkill -f harness-team-worker || true
67
+ ```
18
68
 
19
- ## 실행
69
+ ## tmux Studio (선택사항)
20
70
 
21
- 아래 명령을 **반드시 실행**하세요. 설명이나 확인 없이 바로 실행합니다:
71
+ 별도 터미널에서 tmux 레이아웃을 원하면:
22
72
 
23
73
  ```bash
24
- exec npx walwal-harness v4
74
+ npx walwal-harness v4
25
75
  ```
26
76
 
27
- 명령은 `exec`로 현재 셸을 대체하므로, Claude 세션이 tmux Studio로 전환됩니다.
77
+ 명령은 **Claude 세션 밖에서** (일반 터미널에서) 실행해야 합니다.