@walwal-harness/cli 6.0.2 → 6.0.4

package/CHANGELOG.md

@@ -29,6 +29,63 @@ docmeta:
 
 # Changelog
 
+## 6.0.4 — Sub-skill 협업 + Service-Ops 상시 + Team 병렬 spawn (2026-05-07)
+
+### Why
+moon_web 사용자 보고 — v6.0.3 이후에도 (a) CTO-Frontend 가 흡수된 agency-agents sub-skill (UX/UI/A11y/Perf) 을 호출하지 않고 단독 작업, (b) build/test 중 Service-Ops 자리 비움 → stderr 의 컴파일/테스트 에러 무감시, (c) `mode=team` 인데도 Conductor 가 직렬로 1개씩 spawn 하여 Team 자동 결정 룰 (ready≥3, features≥6, depth≤2) 만족이 무의미해짐. 세 가지는 형식상 v6 였지만 실효는 6.0 이전 수준.
+
+### Changes
+- **gotchas/generator-frontend.md [G-001]** — Sprint Workflow Step 2 에 5개 sub-skill 순차 호출 의무 (engineering-{react,flutter}-developer / design/ux-strategy / design/ui-component-spec / engineering-accessibility-reviewer / engineering-performance-engineer). 결과는 sprint-contract.md FE 섹션 `## Sub-skill Findings` 에 인용. 빈 블록 = Evaluator-Code-Quality FAIL.
+- **gotchas/service-ops.md [G-001]** (신규) — build/test/deploy spawn 직전 동일 tick 에서 monitor stream-mode 동반 활성. 정규식 `(error|exception|TestFailure|Cannot find|Failed to compile)` 매칭 시 즉시 red-alert.
+- **gotchas/conductor.md [G-005]** — Team mode 직렬 회귀 금지. 매 tick 시작 시 ready 목록 계산 → `min(ready, 3)` 동시 spawn + `team_state.team_<n>.assigned_feature/assigned_agent` 갱신 + `meetings.active=["t1-lead","t2-lead","t3-lead"]` standup 시각화.
+- **gotchas/conductor.md [G-006]** — Service-Ops monitor 동반 spawn 룰을 Conductor SKILL §5 spawn 결정 트리에 명시.
+- **skills/generator-frontend/SKILL.md** — Sprint Workflow §2.1 sub-skill 호출 시퀀스 표 + visibility partial update 패턴.
+- **skills/conductor/SKILL.md** — §5 spawn 결정 트리에 두 라인 추가 + §5.1 Team mode 병렬 알고리즘 + §5.2 Service-Ops 동반 spawn 의사코드.
+
+### Migration
+기존 사용자:
+```bash
+npm install @walwal-harness/cli@latest
+npx walwal-harness migrate     # gotchas/service-ops.md 자동 추가
+npx walwal-harness verify
+```
+sub-skill 호출은 generator-frontend SKILL.md 가 갱신되면 다음 sprint 부터 자동 적용. 진행 중 sprint 의 FE 섹션은 Eval-Code-Quality 가 빈 `## Sub-skill Findings` 를 잡아내며 retry 유도.
+
+## 6.0.3 — Visibility + Spawn 검증 + 사용자 슬래시 노출 제거 (2026-05-07)
+
+Owner 의 두 지적을 동시 해결:
+1. "Dispatcher 와 대화 중인데 CEO 가 자리에 없다 / 회의실에 모이지도 않는다" — visibility 의무 부재
+2. "회사인데 왜 자꾸 나에게 명령을 요구하는가" — 사용자 facing 슬래시 잔재
+
+### Added
+- `gotchas/dispatcher.md` [G-005] [G-006] — 사용자 슬래시 명령 요구 금지 + Owner 대화 중 dashboard 가시화 의무
+- `gotchas/conductor.md` (신규) — [G-001] inline fallback 금지 (M-001 의 Conductor 적용) / [G-002] spawn 핸드오프 시 회의실 활용 / [G-003] Visibility Checklist 4 시점 / [G-004] Owner 진행 동의 묻지 말 것
+- `skills/conductor/SKILL.md` §0.5 "Visibility Checklist (Inviolable)" 신설 — 매 tick 의 4 시점 progress.json partial update 의무 + spawn 사전 검증 (SKILL 존재 검사 → 없으면 escalate, inline fallback 금지)
+- 신규 명령 `walwal-harness verify` — 17 SKILL invariants + progress schema + config mode_selection + memory 시스템 entry + deprecated commands 검사. 한 줄로 통합 점검.
+- `apps/harness-dashboard` 의 `ActivityIndicator` 컴포넌트 — `last_activity` age 표시. 30 초 이상 정적 → "stale — 회사가 멈춰 보입니다" 빨간 표시.
+
+### Changed
+- `commands/harness-next.md` **삭제** — 사용자 슬래시 노출 제거. v6 자율 회사에서 Owner 가 입력할 일 없음. `scripts/harness-next.sh` 는 회사 내부 도구로 유지 (Conductor 자율 호출).
+- 9 개 SKILL 본문의 "/harness-next 자동 진행" 안내 → "자동 핸드오프 (Conductor 자율 시동)" 로 일괄 치환.
+- `bin/init.js` install 의 commands cleanup 로직이 자동으로 deprecated `harness-next.md` 를 사용자 환경에서 제거 (기존 동작이 모든 `harness-*` 를 갱신하므로).
+
+### Removed
+- `commands/harness-next.md` — 사용자 facing 슬래시 (자율 위반)
+
+### Migration (one-liner)
+```bash
+npm install @walwal-harness/cli@latest
+npx walwal-harness migrate    # 이전 버전 사용자
+npx walwal-harness verify     # 설치 무결성 점검
+```
+
+`verify` 가 점검하는 것:
+- 17 개 SKILL 의 frontmatter (name, description) + 파일 존재
+- progress.json schema (version ≥ 4, mode_decision, dispatch)
+- config.json mode_selection 존재
+- memory.md 시스템 entry (M-NEXUS-P3)
+- deprecated 사용자 슬래시 (`.claude/commands/harness-next.md`) 잔존 여부
+
 ## 6.0.2 — `migrate` 가 memory 시스템 entry 까지 자동 처리 (2026-05-07)
 
 v6.0.1 patch 적용을 위해 사용자가 memory.md 의 [M-NEXUS-P3] 를 수동 추가해야 했던 불편을 제거. `npx walwal-harness migrate` 한 줄로 모두 처리됩니다.

package/bin/init.js

@@ -1152,6 +1152,121 @@ function runMigrate(opts = {}) {
   console.log('');
 }
 
+// ─────────────────────────────────────────
+// Verify — 14 SKILL invariants + spawn whitelist + progress schema
+// ─────────────────────────────────────────
+function runVerify() {
+  const expectedSkills = [
+    'dispatcher', 'conductor', 'meeting-manager', 'planner',
+    'cto', 'cqo', 'service-ops',
+    'generator-backend', 'generator-frontend', 'generator-designer', 'generator-devops',
+    'evaluator-code-quality', 'evaluator-functional', 'evaluator-visual',
+    'evaluator-architecture', 'evaluator-security',
+    'brainstorming',
+  ];
+  const requiredFrontmatter = ['name', 'description'];
+
+  console.log('');
+  log('=== Verify: skill invariants + spawn whitelist + progress schema ===');
+  let pass = 0;
+  let fail = 0;
+  const issues = [];
+
+  // 1) skill files
+  for (const s of expectedSkills) {
+    const local = path.join(CLAUDE_SKILLS_DIR, `harness-${s}`, 'SKILL.md');
+    const exists = fs.existsSync(local);
+    if (!exists) {
+      issues.push(`  ✗ skills/harness-${s}/SKILL.md MISSING`);
+      fail++;
+      continue;
+    }
+    const body = fs.readFileSync(local, 'utf8');
+    const fmMatch = body.match(/^---\n([\s\S]*?)\n---/);
+    if (!fmMatch) {
+      issues.push(`  ✗ harness-${s}: frontmatter 누락`);
+      fail++;
+      continue;
+    }
+    const missing = requiredFrontmatter.filter((k) => !new RegExp(`^${k}:`, 'm').test(fmMatch[1]));
+    if (missing.length) {
+      issues.push(`  ✗ harness-${s}: frontmatter [${missing.join(',')}] 누락`);
+      fail++;
+      continue;
+    }
+    pass++;
+  }
+  log(`  skills: ${pass}/${expectedSkills.length} OK`);
+
+  // 2) progress.json schema (v6 = version 4 + mode_decision)
+  const progressPath = path.join(HARNESS_DIR, 'progress.json');
+  if (fs.existsSync(progressPath)) {
+    try {
+      const p = JSON.parse(fs.readFileSync(progressPath, 'utf8'));
+      const schemaIssues = [];
+      if ((p.version ?? 0) < 4) schemaIssues.push(`version=${p.version} (<4)`);
+      if (!p.mode_decision) schemaIssues.push('mode_decision 누락');
+      if (!p.dispatch) schemaIssues.push('dispatch 누락');
+      if (schemaIssues.length) {
+        issues.push(`  ✗ progress.json schema: ${schemaIssues.join(', ')} → npx walwal-harness migrate`);
+        fail++;
+      } else {
+        pass++;
+        log(`  progress.json: schema v${p.version} OK`);
+      }
+    } catch (e) {
+      issues.push(`  ✗ progress.json parse: ${e.message}`);
+      fail++;
+    }
+  }
+
+  // 3) config.json mode_selection
+  const configPath = path.join(HARNESS_DIR, 'config.json');
+  if (fs.existsSync(configPath)) {
+    try {
+      const c = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+      if (!c.mode_selection) {
+        issues.push('  ✗ config.json: mode_selection 누락 → npx walwal-harness migrate');
+        fail++;
+      } else {
+        pass++;
+        log(`  config.json: mode_selection.owner=${c.mode_selection.owner} OK`);
+      }
+    } catch {}
+  }
+
+  // 4) memory.md system entries
+  const memoryPath = path.join(HARNESS_DIR, 'memory.md');
+  if (fs.existsSync(memoryPath)) {
+    const userMem = fs.readFileSync(memoryPath, 'utf8');
+    const userIds = new Set(extractEntryIds(userMem));
+    const required = ['M-NEXUS-P3'];
+    const missing = required.filter((id) => !userIds.has(id));
+    if (missing.length) {
+      issues.push(`  ✗ memory.md: 시스템 entry [${missing.join(',')}] 누락 → npx walwal-harness migrate`);
+      fail++;
+    } else {
+      pass++;
+      log('  memory.md: 시스템 entry OK');
+    }
+  }
+
+  // 5) deprecated user-facing slash commands
+  const deprecated = path.join(PROJECT_ROOT, '.claude', 'commands', 'harness-next.md');
+  if (fs.existsSync(deprecated)) {
+    issues.push('  ⚠ .claude/commands/harness-next.md 존재 — v6.0.3 부터 회사 내부 도구로 전환됨. `npx walwal-harness --force` 또는 직접 삭제 권장');
+  }
+
+  console.log('');
+  if (fail === 0) {
+    log(`✓ Verify PASS — ${pass} 개 invariant 통과.`);
+  } else {
+    log(`✖ Verify FAIL — ${fail} 개 issue 발견:`);
+    for (const i of issues) console.log(i);
+  }
+  console.log('');
+}
+
 function main() {
   if (isHelp) {
     showHelp();
@@ -1168,6 +1283,11 @@ function main() {
     return;
   }
 
+  if (subcommand === 'verify') {
+    runVerify();
+    return;
+  }
+
   // Legacy subcommands — redirect to new equivalents
   if (subcommand === 'studio' || subcommand === 'studio-v4' || subcommand === 'v4') {
     log('NOTE: "studio" and "v4" subcommands are replaced by "team".');

package/gotchas/conductor.md

@@ -0,0 +1,92 @@
+---
+docmeta:
+  id: gotchas-conductor
+  title: Gotchas — Conductor (Autonomous Engine)
+  type: input
+  createdAt: 2026-05-07T00:00:00Z
+  updatedAt: 2026-05-07T00:00:00Z
+  source:
+    producer: agent
+    skillId: harness-dispatcher
+  inputs:
+    - documentId: user-feedback-v6.0.2
+      uri: (inline — Owner 의 "잘 워킹하고 있다는 느낌이 들지 않는다" 지적)
+      relation: output-from
+      sections:
+        - sourceRange: { startLine: 1, endLine: 1 }
+          targetRange: { startLine: 17, endLine: 60 }
+  tags: [gotchas, conductor, autonomy, visibility, ghost-spawn]
+---
+
+# Gotchas — Conductor (자율 실행 엔진)
+
+> Conductor 는 walwal-harness 의 손. Dispatcher (CEO) 가 GOAL 을 확정하면 손이 알아서 돌린다. 매 세션 시작 / 매 tick 시 이 파일을 읽고 같은 실수를 반복하지 않는다.
+
+### [G-001] 정의되지 않은 부서를 inline 으로 처리하지 말 것 (M-001 의 Conductor 적용)
+- **Date**: 2026-05-07
+- **Status**: verified
+- **Trigger**: v6.0.2 install 환경에서 Conductor 가 `evaluator-uiux` (정의 X) 를 spawn 하려다 "별도 SKILL 이 없으므로 Conductor 가 직접 검증" 식으로 inline 처리. Owner 가 "잘 워킹하고 있다는 느낌이 들지 않는다" 보고.
+- **Wrong**: spawn 대상이 `.claude/skills/harness-<name>/SKILL.md` 에 없을 때 (a) Conductor 가 inline 검증으로 우회 (b) 사용자 모르게 fallback 으로 진행.
+- **Right**: spawn 직전 SKILL 존재 검사. 없으면 즉시 escalate:
+  ```bash
+  bash scripts/harness-progress-set.sh . \
+    '.failure = {"agent":"conductor","location":"spawn","message":"unknown agent: evaluator-uiux","retry_target":null} |
+     .next_agent = "dispatcher" |
+     .agent_status = "blocked"'
+  ```
+  Dispatcher 가 받아 Owner 에게 "정의되지 않은 부서 호출 시도. 표준 chain (code-quality/functional/visual) 또는 신규 SKILL 등록 필요" 보고.
+- **Why**: M-001 ("선언만 된 유령 스킬") 의 Conductor 차원 적용. inline 우회는 (a) 사용자 신뢰 깨짐 (b) audit 흔적 부재 (c) verify 명령으로 catch 불가능.
+- **Scope**: 모든 spawn 결정. Tick Loop §5 spawn 결정 트리.
+
+### [G-002] Spawn 핸드오프 시 회의실 활용 (visibility)
+- **Date**: 2026-05-07
+- **Status**: verified
+- **Trigger**: Owner 발화 "CQO/COO/회의실 등에 모이지도 않고…"
+- **Wrong**: spawn 핸드오프 시 progress.json 만 갱신하고 `meetings.active` 미사용. dashboard 에서 회의실이 텅 빔.
+- **Right**: 핸드오프 직전 from→to 짧은 회의를 시각화:
+  ```bash
+  # 핸드오프 시작
+  bash scripts/harness-progress-set.sh . \
+    '.meetings.active = ["dispatcher","planner"] | .meetings.cadence = "handoff"'
+  sleep 1.5  # 시각적으로 회의실에 잠깐 모임
+  # 실제 spawn
+  bash scripts/harness-progress-set.sh . \
+    '.meetings.active = [] | .current_agent = "planner" | .agent_status = "running"'
+  ```
+- **Why**: NEXUS 메타포 — 핸드오프 = 짧은 회의. dashboard 에서 회의실로 두 미니피규어 텔레포트 → 회사가 진짜 일한다는 신뢰.
+- **Scope**: 모든 inter-agent 핸드오프.
+
+### [G-003] Visibility Checklist 4 시점 누락 금지 (Inviolable)
+- **Date**: 2026-05-07
+- **Status**: verified
+- **Trigger**: G-002 의 일반화. Conductor 가 매 tick 마다 progress.json 의 4 시점 partial update 를 누락하면 dashboard 가 stale.
+- **Wrong**: Conductor 가 spawn → 검증 → 결과 처리 사이에 progress.json 갱신을 잊거나 일부만 함.
+- **Right**: 매 tick 의 4 시점에 의무 update (skills/conductor/SKILL.md §0.5 참조):
+  1. **tick 시작**: `current_agent="conductor"`, `agent_status="running"`, `conductor.last_tick`, `tick_count++`
+  2. **spawn 직전**: `meetings.active=[from,to]`, `meetings.cadence="handoff"` (1~2초)
+  3. **spawn 직후**: `meetings.active=[]`, `current_agent="<spawned>"`, `agent_status="running"`
+  4. **tick 완료**: `current_agent` 그대로 (다음 에이전트 작업 중) 또는 `null` + `agent_status="completed"`
+- **Scope**: 모든 tick 사이클. 1~3 시점 누락 시 dashboard 의 회의실 텔레포트 / 미니피규어 활동 시각화 깨짐.
+
+### [G-005] Team mode 직렬 회귀 금지 — ready ≥ 2 면 병렬 spawn (status: verified)
+- **Date**: 2026-05-07
+- **Trigger**: Owner 보고 "솔로모드로 만 동작하는것처럼 다중 에이전트 상태가 아님" (moon_web 2026-05-07). progress.json.mode="team" 인데도 Conductor 가 한 번에 한 generator 만 spawn 하고 evaluator 핸드오프도 직렬.
+- **Wrong**: Tick 마다 ready 목록에서 1개만 골라 spawn. tmux 의 T1/T2/T3 패널이 비어있어도 무시.
+- **Right**: 매 tick 시작 시 ready 목록 (depends_on 충족 + agent_status≠running) 을 계산. mode="team" 이면 **min(ready, 3)** 만큼 동시 spawn — 각 팀 슬롯 (T1/T2/T3) 에 배정 + progress.json.team_state.team_<n>.assigned_feature, .assigned_agent 갱신. 동시 spawn 직전 meetings.active=["t1-lead","t2-lead","t3-lead"] 로 짧은 standup 시각화.
+- **Scope**: §4 Tick Loop, §5 Spawn 결정 트리. Solo 모드는 1개 spawn 유지.
+- **Why**: Team 자동 결정 룰 (ready≥3, features≥6, depth≤2) 을 만족시켜놓고 직렬로 돌리면 Team mode 가 형식상 활성이지만 실효 없음. 비용 + 시각적 신뢰 모두 낭비.
+
+### [G-006] Build/Deploy 실행 중 service-ops/monitor 동반 spawn (status: verified)
+- **Date**: 2026-05-07
+- **Trigger**: Owner 보고 "Service ops 는 build/배포 환경 로그 모니터링하면서 에러 캐치해야 하는데 공석". moon_web 빌드 중 `flutter test --platform chrome` 의 WebSocketChannelException 이 stderr 에 흘렀지만 service-ops 룸은 빈 채.
+- **Wrong**: generator-frontend / evaluator-functional 이 build·test 명령을 단독 실행. cron 사이 공백 동안 stderr 무감시.
+- **Right**: build/test/deploy 를 트리거하는 spawn 직전, 동일 tick 에 service-ops/monitor 를 stream-mode 로 함께 spawn (handoff-bridge). 자식 프로세스 종료 시까지 stream_active=true. 스트림 매칭 정규식 (error|exception|TestFailure|Cannot find|Failed to compile) 시 즉시 red-alert.
+- **Scope**: §5 Spawn 결정 트리에 "[generator-* or evaluator-functional spawn 직전] → service-ops/monitor stream-mode 동시 spawn" 라인 추가.
+
+### [G-004] Owner 에게 진행 동의 묻지 말 것 (Dispatcher [G-002] 의 Conductor 적용)
+- **Date**: 2026-05-07
+- **Status**: verified
+- **Trigger**: NEXUS P3 위반 패턴 재발 방지
+- **Wrong**: Conductor 가 Eval PASS 후 "다음 sprint 시작할까요?" 같은 질문을 Dispatcher 통해 전달.
+- **Right**: PASS → 다음 평가자 chain / sprint advance 자동. FAIL → retry_target 자동 라우팅. 3 회 연속 FAIL / 인시던트 / GOAL 위반 시에만 escalation.
+- **Scope**: Tick Loop §6 Escalation 트리거.

package/gotchas/dispatcher.md

@@ -63,6 +63,31 @@ docmeta:
 - **Why**: 명료화 인터럽트가 자율성 위반의 우회 통로가 되지 않도록.
 - **Scope**: dispatcher 의 GOAL 정립 단계.
 
+### [G-005] 사용자에게 슬래시 명령을 입력하라고 요구하지 말 것
+- **Date**: 2026-05-07
+- **Status**: verified
+- **Trigger**: Owner 발화 "회사인데 왜 자꾸 나에게 무언가 요청하는가? CEO 가 알아서 결정하면 될것을"
+- **Wrong**: 응답에 "/harness-next 입력하세요", "/harness-evaluator-functional 호출하세요", "다음은 /harness-planner 슬래시 명령" 식으로 Owner 에게 회사 내부 진행 도구를 노출/요구.
+- **Right**: 모든 슬래시 핸드오프 (`/harness-next`, `/harness-planner`, `/harness-evaluator-*` 등) 는 **회사 내부 자동화** 다. SKILL 의 On Complete 에서 직접 핸드오프하거나 `scripts/harness-next.sh` 를 호출. Owner 는 결과 보고와 escalation 만 본다.
+- **Why**: NEXUS 메타포 — Owner 는 회사가 어떤 도구로 일하는지 신경쓰지 않는다. 슬래시 노출은 (a) 자율 실행 깨짐 (b) 정체성 (Owner ≠ CEO) 흐림.
+- **Scope**: 모든 응답 문구. 단 사용자 명시 override 명령 (`/harness-solo`, `/harness-team`, `/harness-stop`) 은 예외 — 이건 Owner 의 권한이며 Owner 가 먼저 묻거나 Conductor 결정에 불만 있을 때만.
+
+### [G-006] Owner 와 대화하는 동안 dashboard 가시화 의무
+- **Date**: 2026-05-07
+- **Status**: verified
+- **Trigger**: Owner 발화 "dispatcher 로 대화 중일때도 CEO 는 자리에 없었고… 잘 워킹하고 있다는 느낌이 들지 않는다"
+- **Wrong**: Dispatcher 가 Owner 의 메시지를 받고 응답을 작성하는 동안 progress.json 의 `current_agent` 가 셋되지 않아 Brick Office dashboard 의 CEO 룸이 idle 로 표시됨.
+- **Right**: Owner 메시지 수신 즉시 첫 행동:
+  ```bash
+  bash scripts/harness-progress-set.sh . '.current_agent = "dispatcher" | .agent_status = "running" | .updated_at = "<iso>"'
+  ```
+  응답 송신 직전 마지막 행동:
+  ```bash
+  bash scripts/harness-progress-set.sh . '.agent_status = "completed" | .updated_at = "<iso>"'
+  ```
+  → CEO 미니피규어가 typing → idle 깜빡임. Owner 가 dashboard 에서 "회사가 일하고 있다" 신뢰 획득.
+- **Scope**: 모든 inbound owner message 처리.
+
 ### [G-004] Owner ↔ Conductor / Planner / Generator / Evaluator 직접 라우팅 금지
 - **Date**: 2026-05-07
 - **Status**: verified

package/gotchas/generator-frontend.md

@@ -1,5 +1,31 @@
+---
+docmeta:
+  id: generator-frontend
+  title: Gotchas — Generator-Frontend
+  type: intermediate
+  createdAt: 2026-05-07T00:00:00Z
+  updatedAt: 2026-05-07T00:00:00Z
+  source:
+    producer: agent
+    skillId: harness-dispatcher
+  inputs: []
+  tags: [gotcha, generator-frontend, sub-skill, agency-agents]
+---
+
 # Gotchas — Generator-Frontend
 
 > Dispatcher가 관리. Generator-Frontend는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
 
-<!-- 항목이 추가되면 아래에 기록됩니다 -->
+## [G-001] CTO-Frontend 단독 작업 금지 — 흡수된 agency-agents sub-skill 명시 호출 (status: verified)
+
+- **Why**: walwal-harness v6 는 agency-agents (MIT) 의 design/UX/A11y/perf 패턴을 부서별로 흡수했지만, generator-frontend SKILL 에는 sub-skill 호출 의무가 누락되어 CTO-Frontend 가 단독으로 컴포넌트를 찍어내고 끝나는 회귀가 있었다 (moon_web 2026-05-07).
+- **How to apply**:
+  - **Sprint Workflow Step 2 (구현)** 진입 시, 다음 sub-skill 결과를 **순차 호출 후 본 구현에 반영**한다 — 결과 미반영은 PASS 금지:
+    1. **engineering-react-developer** (또는 -flutter-developer) — 컴포넌트 골격 패턴 결정
+    2. **design/ux-strategy** (CTO-Designer 흡수) — 사용자 흐름 / 정보 구조 검증
+    3. **design/ui-component-spec** — 토큰 / variant / state 매핑
+    4. **engineering-accessibility-reviewer** — WCAG AA + 키보드 네비
+    5. **engineering-performance-engineer** — RSC 우선 / hydration 비용 / IntersectionObserver
+  - 호출 결과는 sprint-contract.md FE 섹션의 `## Sub-skill Findings` 블록에 요약 반영. 빈 블록 = FAIL.
+  - tmux/3D 대시보드에 visibility 보장: 각 sub-skill 호출 직전 `progress.json.meetings.active = ["generator-frontend", "<sub-skill>"]` partial update 후 1.5s, 호출 후 `[]` 로 복귀.
+- **References**: skills/cto/SKILL.md "agency-agents (MIT) 흡수" 섹션, skills/generator-designer/SKILL.md.

package/gotchas/service-ops.md

@@ -0,0 +1,27 @@
+---
+docmeta:
+  id: service-ops
+  title: Gotchas — Service-Ops
+  type: intermediate
+  createdAt: 2026-05-07T00:00:00Z
+  updatedAt: 2026-05-07T00:00:00Z
+  source:
+    producer: agent
+    skillId: harness-dispatcher
+  inputs: []
+  tags: [gotcha, service-ops, monitor, presence]
+---
+
+# Gotchas — Service-Ops
+
+> Dispatcher가 관리. Service-Ops 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
+
+## [G-001] Build/Deploy 진행 중 자리 비움 금지 — monitor 모듈 활성 의무 (status: verified)
+
+- **Why**: Service-Ops 의 monitor 는 cron + red-alert 이벤트로만 spawn 되도록 설계됐으나, generator/evaluator 가 build·flutter test·deploy 를 실행하는 동안에는 cron 주기 사이 공백이 길어 대시보드에서 "SERVICE-OPS 룸 빈 채" 가 관찰됨 (moon_web 2026-05-07). 빌드 stderr 의 WebSocketChannelException, 컴파일 에러, dart analyze warning 을 실시간으로 캐치하지 못하면 이후 evaluator-functional 단계에서야 발견 → 비용 증가.
+- **How to apply**:
+  - Conductor 가 generator-* 또는 evaluator-functional 을 spawn 하기 **직전**, 동일 tick 에 service-ops/monitor 를 **stream-mode 로 함께 spawn** (handoff-bridge). progress.json.service_ops.monitor.stream_active = true.
+  - Stream-mode monitor 의 책임: 자식 프로세스 stdout/stderr 를 tail → 정규식 (`error:|exception|TestFailure|Cannot find|Failed to compile`) 매칭 시 즉시 conductor 에 red-alert 발행.
+  - 자식 프로세스 종료 시 stream_active = false + ops-report 짧은 요약 append.
+  - Visibility: monitor 활성 동안 progress.json.agents 에 service-ops minifig 가 service-ops 룸 (또는 모니터링 대상 룸 인접) 에 위치하도록 partial update.
+- **References**: skills/service-ops/SKILL.md service_ops.monitor 섹션.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "6.0.2",
+  "version": "6.0.4",
   "description": "Production harness for AI agent engineering — NEXUS-adapted company metaphor (Dispatcher/CEO + Conductor + Meeting-Manager + COO/Planner + CTO + CQO + Service-Ops). Solo/Team mode, Brainstormer, Planner, Generator(BE/FE/Designer/DevOps), Evaluator chain (Code-Quality → Functional → Visual + Architecture/Security). Supports React, Next.js, and Flutter FE stacks.",
   "bin": {
     "walwal-harness": "bin/init.js"

package/skills/brainstorming/SKILL.md

@@ -69,8 +69,8 @@ jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/p
    - `completed_agents` 에 `"brainstormer"` 추가
    - `next_agent` → `"planner"`
 3. `.harness/progress.log` 에 요약 추가: `Brainstormer → Planner (spec: <경로>)`
-4. 출력: `"✓ Brainstormer 완료. brainstorm-spec.md 검토 후 승인 신호를 주세요. 승인 시 /harness-next 자동 진행 (Planner)."`
-5. **사용자 승인 게이트**: 사용자의 명시적 승인 ("이 디자인 승인한다", "ok", "다음", "Planner 가자" 등) 을 기다린 후, **`/harness-next` 슬래시 명령을 호출하여 Planner 로 자동 핸드오프**.
+4. 출력: `"✓ Brainstormer 완료. brainstorm-spec.md 검토 후 승인 신호를 주세요. 승인 시 자동 핸드오프 (Conductor 자율 시동) (Planner)."`
+5. **사용자 승인 게이트**: 사용자의 명시적 승인 ("이 디자인 승인한다", "ok", "다음", "Planner 가자" 등) 을 기다린 후, **내부 핸드오프 (scripts/harness-next.sh) 를 호출하여 Planner 로 자동 핸드오프**.
 6. 사용자가 피드백/수정 요청을 하면 brainstorm-spec.md 를 갱신하고 다시 승인 요청. 승인 없이는 `/harness-next` 호출 금지 (HARD-GATE 준수).
 
 ### On Fail / Abort

package/skills/conductor/SKILL.md

@@ -28,6 +28,51 @@ Conductor 는 다음 시점에 **자동 시동**한다. 사용자 펌프 없이.
 
 자세한 anti-pattern → `.harness/gotchas/dispatcher.md` 의 [G-002] 자율 실행 위반.
 
+## 0.5 Visibility Checklist (Inviolable, 매 tick 의무)
+
+Brick Office dashboard 가 회사의 활동을 정확히 비추려면 매 tick 의 4 시점에 progress.json partial update 가 누락 없이 발생해야 한다. Owner 의 "잘 워킹하고 있다는 느낌" 은 이 4 시점 update 의 누적이다.
+
+### 4 시점 의무
+
+```bash
+# ① tick 시작 시점 — Conductor 자신을 typing 으로 표시
+bash scripts/harness-progress-set.sh . \
+  ".current_agent = \"conductor\" | .agent_status = \"running\" |
+   .conductor.last_tick = \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\" |
+   .conductor.tick_count = ((.conductor.tick_count // 0) + 1)"
+
+# ② spawn 직전 — 회의실로 from/to 텔레포트 (~1.5s 시각화)
+bash scripts/harness-progress-set.sh . \
+  ".meetings.active = [\"conductor\",\"<spawn-target>\"] | .meetings.cadence = \"handoff\""
+sleep 1.5
+
+# ③ spawn 직후 — 회의 종료, spawned agent 가 현장 작업
+bash scripts/harness-progress-set.sh . \
+  ".meetings.active = [] | .current_agent = \"<spawn-target>\" | .agent_status = \"running\""
+
+# ④ tick 완료 — spawned agent 가 자체 SKILL 의 Session Boundary 따름
+#    Conductor 는 다음 tick 에서 ① 부터 다시 시작
+```
+
+### Spawn 사전 검증 (G-001)
+
+spawn 결정 트리 §5 직전에 SKILL 존재 검사를 수행한다:
+
+```bash
+TARGET="<spawn-candidate>"
+if [ ! -f ".claude/skills/harness-${TARGET}/SKILL.md" ]; then
+  bash scripts/harness-progress-set.sh . \
+    ".failure = {\"agent\":\"conductor\",\"location\":\"spawn\",\"message\":\"unknown agent: ${TARGET}\",\"retry_target\":null} |
+     .next_agent = \"dispatcher\" | .agent_status = \"blocked\""
+  # Dispatcher 가 받아 Owner 에게 escalation
+  exit 0
+fi
+```
+
+**금지** — inline fallback ("SKILL 이 없으므로 Conductor 가 직접 검증") 으로 우회. M-001 의 "유령 스킬" 패턴 재발.
+
+자세한 anti-pattern → `.harness/gotchas/conductor.md` [G-001] ~ [G-004].
+
 ## 1. 정체성
 
 - **위치**: Dispatcher(CEO) 직속, Planner와 평행
@@ -97,8 +142,36 @@ idle ─► running ─► (waiting_meeting | waiting_owner | running) ─► co
 [all features PASS]                → Phase Gate Meeting
 [Service-Ops cron due]             → spawn service-ops monitor
 [ops-report ready]                 → handoff to CTO (spawn cto-review)
+[generator-* / eval-functional spawn 직전] → 동시 spawn service-ops/monitor (stream-mode, G-006)
+[mode=team & ready ≥ 2]            → 동시 spawn min(ready,3) generator/evaluator (G-005)
+```
+
+### 5.1 Team mode 병렬 spawn (G-005)
+
+`progress.json.mode == "team"` 이면 매 tick 시작 시 ready 목록을 계산하여 **동시 다발 spawn**:
+
+```bash
+# ready = depends_on 충족 + agent_status != "running" 인 feature 의 다음 에이전트 목록
+ready_count=$(jq '[.features[] | select(.depends_on // [] | all(. as $d | (.[$d].passes // []) | length > 0))] | length' .harness/feature-list.json)
+slots=$(( ready_count < 3 ? ready_count : 3 ))
+# slots 만큼 team_state.team_<n>.assigned_feature/assigned_agent 갱신 후 동시 Agent 호출
 ```
 
+직렬 회귀 (1 spawn → 완료 대기 → 다음 spawn) 는 Solo 모드에서만 허용. Team 모드에서 1개씩 처리하면 GOTCHA G-005 위반.
+
+### 5.2 Service-Ops monitor 동반 spawn (G-006)
+
+generator-{backend,frontend,frontend-flutter,devops} 또는 evaluator-functional* 을 spawn 하기 직전, **동일 tick 에서** service-ops/monitor 를 stream-mode 로 함께 spawn:
+
+```bash
+bash scripts/harness-progress-set.sh . \
+  '.service_ops.monitor.stream_active = true |
+   .service_ops.monitor.stream_target = "generator-frontend" |
+   .agents += [{"id":"service-ops","room":"service-ops","minifigState":"watching"}]'
+```
+
+자식 프로세스 종료 시 stream_active=false + ops-report append. 빌드 stderr 의 (error|exception|TestFailure|Cannot find|Failed to compile) 매칭 → 즉시 red-alert.
+
 ## 6. Escalation 트리거 & 양식
 
 | 트리거 | 양식 | Owner 응답 옵션 |

package/skills/dispatcher/SKILL.md

@@ -73,8 +73,8 @@ jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/p
      ```
      아카이빙 후 `dispatch.id` 는 `null` 로 리셋되므로, 다음 dispatcher 실행 시 새 D-NNN 이 할당된다.
 2. `.harness/progress.log`에 요약 한 줄 추가
-3. 출력: `"✓ Dispatcher 완료. /harness-next 자동 진행."`
-4. **즉시 `/harness-next` 슬래시 명령을 호출하여 다음 에이전트로 자동 핸드오프** (Solo 모드. Team 모드는 Lead가 별도 오케스트레이션). Brainstorming/Planner 단계가 아니면 사용자 승인 게이트 없음.
+3. 출력: `"✓ Dispatcher 완료. 자동 핸드오프 (Conductor 자율 시동)."`
+4. **즉시 내부 핸드오프 (scripts/harness-next.sh) 를 호출하여 다음 에이전트로 자동 핸드오프** (Solo 모드. Team 모드는 Lead가 별도 오케스트레이션). Brainstorming/Planner 단계가 아니면 사용자 승인 게이트 없음.
 
 ## Auto-Routing (UserPromptSubmit Hook)
 

package/skills/evaluator-code-quality/SKILL.md

@@ -41,8 +41,8 @@ jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/p
    - `failure` 필드 초기화
 2. `feature-list.json`의 통과 feature `passes`에 `"evaluator-code-quality"` 추가
 3. `.harness/progress.log`에 PASS 요약 추가
-4. 출력: `"✓ Evaluator-Code-Quality PASS. /harness-next 자동 진행."`
-5. **즉시 `/harness-next` 슬래시 명령을 호출하여 다음 에이전트로 자동 핸드오프** (Solo 모드. Team 모드는 Lead가 별도 오케스트레이션).
+4. 출력: `"✓ Evaluator-Code-Quality PASS. 자동 핸드오프 (Conductor 자율 시동)."`
+5. **즉시 내부 핸드오프 (scripts/harness-next.sh) 를 호출하여 다음 에이전트로 자동 핸드오프** (Solo 모드. Team 모드는 Lead가 별도 오케스트레이션).
 
 ### On Fail
 1. progress.json 업데이트:
@@ -55,8 +55,8 @@ jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/p
    - `sprint.retry_count` 증가
 2. `sprint.retry_count >= 10`이면 `agent_status` → `"blocked"`, 사용자 개입 요청
 3. `.harness/progress.log`에 FAIL 요약 추가
-4. 출력: `"✖ Evaluator-Code-Quality FAIL. /harness-next 자동 진행 (재작업 대상으로 라우팅)."`
-5. **즉시 `/harness-next` 슬래시 명령을 호출하여 `failure.retry_target` 으로 자동 핸드오프** (Solo 모드).
+4. 출력: `"✖ Evaluator-Code-Quality FAIL. 자동 핸드오프 (Conductor 자율 시동) (재작업 대상으로 라우팅)."`
+5. **즉시 내부 핸드오프 (scripts/harness-next.sh) 를 호출하여 `failure.retry_target` 으로 자동 핸드오프** (Solo 모드).
 
 ## Critical Mindset
 

package/skills/evaluator-functional/SKILL.md

@@ -43,8 +43,8 @@ jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/p
    - `failure` 필드 초기화
 3. `feature-list.json`의 통과 feature `passes`에 `"evaluator-functional"` 추가
 4. `.harness/progress.log`에 PASS 요약 추가
-5. 출력: `"✓ Evaluator-Functional PASS. /harness-next 자동 진행."`
-6. **즉시 `/harness-next` 슬래시 명령을 호출하여 다음 에이전트로 자동 핸드오프** (Solo 모드. Team 모드는 Lead가 별도 오케스트레이션).
+5. 출력: `"✓ Evaluator-Functional PASS. 자동 핸드오프 (Conductor 자율 시동)."`
+6. **즉시 내부 핸드오프 (scripts/harness-next.sh) 를 호출하여 다음 에이전트로 자동 핸드오프** (Solo 모드. Team 모드는 Lead가 별도 오케스트레이션).
 
 ### On Fail
 1. **Screenshot Cleanup** — PASS 와 동일하게 스크린샷 파일 삭제 (FAIL 시에도 정리 필수).
@@ -58,8 +58,8 @@ jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/p
    - `sprint.retry_count` 증가
 3. `sprint.retry_count >= 10`이면 `agent_status` → `"blocked"`, 사용자 개입 요청
 4. `.harness/progress.log`에 FAIL 요약 추가
-5. 출력: `"✖ Evaluator-Functional FAIL. /harness-next 자동 진행 (재작업 대상으로 라우팅)."`
-6. **즉시 `/harness-next` 슬래시 명령을 호출하여 `failure.retry_target` 으로 자동 핸드오프** (Solo 모드).
+5. 출력: `"✖ Evaluator-Functional FAIL. 자동 핸드오프 (Conductor 자율 시동) (재작업 대상으로 라우팅)."`
+6. **즉시 내부 핸드오프 (scripts/harness-next.sh) 를 호출하여 `failure.retry_target` 으로 자동 핸드오프** (Solo 모드).
 
 ## Critical Mindset
 

package/skills/evaluator-visual/SKILL.md

@@ -43,8 +43,8 @@ jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/p
    - `failure` 필드 초기화
 3. `feature-list.json`의 통과 feature `passes`에 `"evaluator-visual"` 추가
 4. `.harness/progress.log`에 PASS 요약 추가
-5. 출력: `"✓ Evaluator-Visual PASS. /harness-next 자동 진행 (아카이브)."`
-6. **즉시 `/harness-next` 슬래시 명령을 호출하여 아카이브 단계로 자동 핸드오프** (Solo 모드. Team 모드는 Lead가 별도 오케스트레이션).
+5. 출력: `"✓ Evaluator-Visual PASS. 자동 핸드오프 (Conductor 자율 시동) (아카이브)."`
+6. **즉시 내부 핸드오프 (scripts/harness-next.sh) 를 호출하여 아카이브 단계로 자동 핸드오프** (Solo 모드. Team 모드는 Lead가 별도 오케스트레이션).
 
 ### On Fail
 1. **Screenshot Cleanup** — PASS 와 동일하게 스크린샷 파일 삭제 (FAIL 시에도 정리 필수).
@@ -58,8 +58,8 @@ jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/p
    - `sprint.retry_count` 증가
 3. `sprint.retry_count >= 10`이면 `agent_status` → `"blocked"`, 사용자 개입 요청
 4. `.harness/progress.log`에 FAIL 요약 추가
-5. 출력: `"✖ Evaluator-Visual FAIL. /harness-next 자동 진행 (재작업 대상으로 라우팅)."`
-6. **즉시 `/harness-next` 슬래시 명령을 호출하여 `failure.retry_target` 으로 자동 핸드오프** (Solo 모드).
+5. 출력: `"✖ Evaluator-Visual FAIL. 자동 핸드오프 (Conductor 자율 시동) (재작업 대상으로 라우팅)."`
+6. **즉시 내부 핸드오프 (scripts/harness-next.sh) 를 호출하여 `failure.retry_target` 으로 자동 핸드오프** (Solo 모드).
 
 ## FE Playwright Mandatory Rule (v5.4)
 

package/skills/generator-backend/SKILL.md

@@ -39,8 +39,8 @@ jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/p
    - `failure` 필드 초기화 (retry 성공 시)
 2. `feature-list.json` 의 해당 feature `passes` 에 `"generator-backend"` 추가
 3. `.harness/progress.log` 에 요약 추가
-4. 출력: `"✓ Generator-Backend 완료. /harness-next 자동 진행."`
-5. **즉시 `/harness-next` 슬래시 명령을 호출하여 다음 에이전트로 자동 핸드오프** (Solo 모드. Team 모드는 Lead가 별도 오케스트레이션).
+4. 출력: `"✓ Generator-Backend 완료. 자동 핸드오프 (Conductor 자율 시동)."`
+5. **즉시 내부 핸드오프 (scripts/harness-next.sh) 를 호출하여 다음 에이전트로 자동 핸드오프** (Solo 모드. Team 모드는 Lead가 별도 오케스트레이션).
 
 ## Startup (Adaptive Loading)
 

package/skills/generator-frontend/SKILL.md

@@ -39,8 +39,8 @@ jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/p
    - `failure` 필드 초기화 (retry 성공 시)
 2. `feature-list.json` 의 해당 feature `passes` 에 `"generator-frontend"` 추가
 3. `.harness/progress.log` 에 요약 추가
-4. 출력: `"✓ Generator-Frontend 완료. /harness-next 자동 진행."`
-5. **즉시 `/harness-next` 슬래시 명령을 호출하여 다음 에이전트로 자동 핸드오프** (Solo 모드. Team 모드는 Lead가 별도 오케스트레이션).
+4. 출력: `"✓ Generator-Frontend 완료. 자동 핸드오프 (Conductor 자율 시동)."`
+5. **즉시 내부 핸드오프 (scripts/harness-next.sh) 를 호출하여 다음 에이전트로 자동 핸드오프** (Solo 모드. Team 모드는 Lead가 별도 오케스트레이션).
 
 ## Startup (Adaptive Loading)
 
@@ -86,9 +86,29 @@ Team Mode 에서 Team Worker 가 호출할 때, 프롬프트에 `FEATURE_ID` 가
 ## Sprint Workflow
 
 1. **Sprint Contract FE 섹션 추가** — 컴포넌트 / API 연동 / 성공 기준
-2. **구현** — 아래 "스택 치환 규칙" 엄수
-3. **Self-Verification** — `ref.validation.pre_eval_gate` 에 나열된 명령 전부 실행
-4. **Handoff** → Evaluator-Functional
+2. **Sub-skill 협업 (Inviolable, gotcha G-001)** — 본 구현 전, 흡수된 agency-agents (MIT) sub-skill 결과를 순차 반영. 누락 시 Eval FAIL.
+3. **구현** — 아래 "스택 치환 규칙" 엄수, sub-skill findings 를 sprint-contract.md FE 섹션 `## Sub-skill Findings` 블록에 인용
+4. **Self-Verification** — `ref.validation.pre_eval_gate` 에 나열된 명령 전부 실행
+5. **Handoff** → Evaluator-Functional
+
+### 2.1 Sub-skill 호출 시퀀스 (필수)
+
+각 sub-skill 호출 직전 visibility partial update:
+```bash
+bash scripts/harness-progress-set.sh . \
+  '.meetings.active = ["generator-frontend","<sub-skill>"] | .meetings.cadence = "sub-skill"'
+```
+호출 후 `meetings.active = []` 복귀.
+
+| # | Sub-skill (agency-agents 흡수처) | 산출물 (FE 섹션 인용) |
+|---|----------------------------------|------------------------|
+| 1 | `engineering-{react,flutter}-developer` (CTO 흡수) | 컴포넌트 골격 + state 관리 결정 |
+| 2 | `design/ux-strategy` (Generator-Designer 흡수) | 사용자 흐름 / 정보 구조 검증 |
+| 3 | `design/ui-component-spec` (Generator-Designer 흡수) | 토큰 / variant / state 매핑 |
+| 4 | `engineering-accessibility-reviewer` (CTO 흡수) | WCAG AA + 키보드 네비 체크 |
+| 5 | `engineering-performance-engineer` (CTO 흡수) | RSC / hydration / observer 결정 |
+
+빈 `## Sub-skill Findings` = Eval FAIL 으로 처리됨 (Evaluator-Code-Quality 게이트).
 
 ## 스택 치환 규칙 (Adaptive Core)
 

package/skills/planner/SKILL.md

@@ -36,8 +36,8 @@ jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/p
    - `completed_agents`에 `"planner"` 추가
    - `next_agent` → 파이프라인에 따라 결정 (FULLSTACK/BE-ONLY: `"generator-backend"`, FE-ONLY: `"generator-frontend"`)
 2. `.harness/progress.log`에 요약 추가
-3. 출력: `"✓ Planner 완료. plan.md / api-contract.json 검토 후 승인 신호를 주세요. 승인 시 /harness-next 자동 진행."`
-4. **사용자 승인 게이트**: 사용자의 명시적 승인 ("승인", "ok", "다음", "진행", "go" 등) 을 기다린 후, **`/harness-next` 슬래시 명령을 호출하여 다음 에이전트로 자동 핸드오프**.
+3. 출력: `"✓ Planner 완료. plan.md / api-contract.json 검토 후 승인 신호를 주세요. 승인 시 자동 핸드오프 (Conductor 자율 시동)."`
+4. **사용자 승인 게이트**: 사용자의 명시적 승인 ("승인", "ok", "다음", "진행", "go" 등) 을 기다린 후, **내부 핸드오프 (scripts/harness-next.sh) 를 호출하여 다음 에이전트로 자동 핸드오프**.
 5. 사용자가 피드백/수정 요청을 하면 plan.md / feature-list.json / api-contract.json 을 갱신하고 다시 승인 요청. 승인 없이는 `/harness-next` 호출 금지.
 
 ## Startup

package/commands/harness-next.md

@@ -1,82 +0,0 @@
----
-docmeta:
-  id: harness-next
-  title: /harness-next — 다음 에이전트로 자동 진행
-  type: input
-  createdAt: 2026-04-27T00:00:00Z
-  updatedAt: 2026-04-27T00:00:00Z
-  source:
-    producer: user
-    skillId: harness
-  inputs: []
-  tags: [harness, solo-mode, orchestration, command]
----
-
-# /harness-next — 다음 에이전트로 자동 진행
-
-현재 에이전트의 완료 상태(`progress.json`)를 읽고 파이프라인 시퀀스에 따라 **다음 에이전트로 자동 진행**합니다. Solo 모드에서 매 단계마다 사용자가 직접 bash 명령을 칠 필요 없이 자동 핸드오프합니다.
-
-## 실행 절차
-
-### Step 1: harness-next.sh 실행
-
-```bash
-bash scripts/harness-next.sh .
-```
-
-스크립트가 수행하는 작업:
-- `progress.json` 읽기 → `current_agent`, `agent_status`, `next_agent` 확인
-- Pre-Eval Gate (lint/type/test) 실행 — Generator → Evaluator 전환 시
-- Artifact prerequisite 검증
-- `.harness/handoff.json` 생성 (다음 에이전트 컨텍스트)
-- 에스컬레이션 체크 (3회 실패 시 → Planner)
-- 마지막 에이전트면 자동 archive 실행
-
-### Step 2: handoff.json 읽고 다음 에이전트 **즉시 호출** (필수)
-
-> **중요**: Step 1 완료 후 사용자에게 "다음 단계를 실행하시겠습니까?" 같은 추가 확인을 받지 마세요. 사용자가 이미 `/harness-next`를 호출한 시점에 다음 단계 실행에 동의한 것으로 간주합니다. 곧바로 Skill 도구로 `to` 필드의 스킬을 호출하세요.
-
-```bash
-cat .harness/handoff.json | jq '{from, to, sprint, prompt, model, thinking_mode, failure_context}'
-```
-
-`to` 필드 값에 따라 자동으로 해당 스킬을 호출합니다:
-
-| `to` 값 | 호출할 스킬 |
-|---------|------------|
-| `dispatcher` | `harness-dispatcher` |
-| `brainstorming` | `harness-brainstorming` |
-| `planner` | `harness-planner` |
-| `generator-backend` | `harness-generator-backend` |
-| `generator-frontend` | `harness-generator-frontend` |
-| `generator-frontend-flutter` | `harness-generator-frontend-flutter` |
-| `evaluator-code-quality` | `harness-evaluator-code-quality` |
-| `evaluator-functional` | `harness-evaluator-functional` |
-| `evaluator-functional-flutter` | `harness-evaluator-functional-flutter` |
-| `evaluator-visual` | `harness-evaluator-visual` |
-| `archive` | (자동 처리됨, 새 dispatch 대기) |
-| `null` (blocked) | 멈춤. 사용자에게 차단 사유 안내 |
-
-### Step 3: 호출된 스킬이 handoff.json을 컨텍스트로 사용
-
-`handoff.json.prompt` 에 thinking mode, sprint, 실패 컨텍스트가 포함되어 있으므로 그대로 사용합니다.
-
-## 사용 시점
-
-- **자동 호출** (스킬이 알아서):
-  - Dispatcher, Generator-*, Evaluator-* 완료 직후 (사용자 검토 게이트 없음)
-  - Planner / Brainstorming은 **사용자 승인 후** 스킬이 호출
-- **수동 호출** (사용자가 직접 입력):
-  - 흐름이 멈춰서 다시 진행시키고 싶을 때
-  - Eval FAIL 후 재시도를 시작할 때
-  - `/harness-stop` 이후 재개
-
-## Team 모드와의 관계
-
-Team 모드는 Lead worker가 자체 오케스트레이션 루프를 돌리므로 `/harness-next`가 필요 없습니다. 이 명령은 **Solo 모드 전용**입니다.
-
-## 관련 명령
-
-- `/harness-solo` — Solo 모드 진입/전환
-- `/harness-team` — Team 모드 진입
-- `/harness-stop` — 진행 중단