@walwal-harness/cli 6.0.3 → 6.0.5

package/CHANGELOG.md

@@ -29,6 +29,49 @@ docmeta:
 
 # Changelog
 
+## 6.0.5 — migrate 가 gotcha entry / bundle version 까지 sync (2026-05-07)
+
+### Why
+Owner 보고 — `npm install @walwal-harness/cli@latest && npx walwal-harness migrate` 가 "이미 최신 버전입니다" 로 종료. 그러나 v6.0.4 에서 새로 추가된 `gotchas/conductor.md` 의 [G-005], [G-006], `gotchas/service-ops.md`, `gotchas/generator-frontend.md [G-001]` 가 사용자 프로젝트에 merge 되지 않음. **존재 여부 (3 항목 — progress v4 / config.mode_selection / M-NEXUS-P3) 만 확인하고 콘텐츠는 비교 안 함** → 본질적 버그.
+
+### Changes
+- **bin/init.js `detectMigrationNeeded`** — 두 신규 시그널 추가:
+  - `gotchaMissingEntries`: `gotchas/*.md` 별로 패키지 → 사용자 [G-NNN] entry 차이 산출 (memory.md 패턴과 동일)
+  - `bundleVersionStale`: `.harness/.bundle-version` 스탬프와 패키지 버전 비교
+- **bin/init.js `runMigrate`** — gotcha entry append + bundle stamp 갱신 단계 추가. 사용자가 직접 추가한 [G-NNN] entry 는 절대 건드리지 않으며, 패키지의 신규 시스템 entry 만 끝에 추가.
+- **bin/init.js `extractGotchaEntryBlock` / `extractEntryBlock`** — JS 정규식 `\Z` 미지원 fix. 마지막 entry 가 추출 누락되던 버그 동시 해결 (v6.0.2 부터 잠재).
+- **bin/init.js main flow** — 콘텐츠 드리프트 없이 stamp 만 누락된 경우 init 종료 시 자동 갱신. stamp 만으로 매번 migrate 권유 알림이 뜨는 것 방지.
+
+### Migration
+```bash
+npm install @walwal-harness/cli@latest
+npx walwal-harness migrate     # gotchas/conductor.md G-005/G-006, gotchas/service-ops.md, gotchas/generator-frontend.md G-001 자동 append + stamp 갱신
+npx walwal-harness verify
+```
+사용자 [G-NNN] entry 는 보존되고 시스템 entry 만 끝에 append. 변경 전 `.harness/archive/migration-<ts>/gotchas-<file>` 백업.
+
+## 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 의 두 지적을 동시 해결:

package/bin/init.js

@@ -988,7 +988,41 @@ function detectMigrationNeeded() {
     progressV3toV4: false,
     configMissingModeSelection: false,
     memoryMissingSystemEntries: [],
+    gotchaMissingEntries: {},   // { "<filename>": [G-IDs...] }
+    bundleVersionStale: null,    // { current, installed }
   };
+
+  // Gotcha entry-level diff: for each bundled gotcha file, compare entry IDs.
+  // 사용자가 직접 추가한 [G-NNN] 은 절대 건드리지 않으며, 패키지에서 새로
+  // 도입된 시스템 entry 만 append 대상.
+  const gotchasSrc = path.join(PKG_ROOT, 'gotchas');
+  const gotchasDest = path.join(HARNESS_DIR, 'gotchas');
+  if (fs.existsSync(gotchasSrc) && fs.existsSync(gotchasDest)) {
+    const files = fs.readdirSync(gotchasSrc).filter((f) => f.endsWith('.md') && f !== 'README.md');
+    for (const file of files) {
+      const srcPath = path.join(gotchasSrc, file);
+      const destPath = path.join(gotchasDest, file);
+      if (!fs.existsSync(destPath)) continue;  // installSkills/init 이 처리
+      try {
+        const srcIds = extractGotchaEntryIds(fs.readFileSync(srcPath, 'utf8'));
+        const dstIds = new Set(extractGotchaEntryIds(fs.readFileSync(destPath, 'utf8')));
+        const missing = srcIds.filter((id) => !dstIds.has(id));
+        if (missing.length) flags.gotchaMissingEntries[file] = missing;
+      } catch {}
+    }
+  }
+
+  // Bundle version stamp: detects fresh package vs. last-applied bundle.
+  // Even if the 3 schema flags pass, a newer bundle may have introduced new
+  // gotcha/SKILL/template content the user hasn't seen yet.
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(PKG_ROOT, 'package.json'), 'utf8'));
+    const stampPath = path.join(HARNESS_DIR, '.bundle-version');
+    const installed = fs.existsSync(stampPath) ? fs.readFileSync(stampPath, 'utf8').trim() : null;
+    if (installed !== pkg.version) {
+      flags.bundleVersionStale = { current: pkg.version, installed };
+    }
+  } catch {}
   if (fs.existsSync(progressPath)) {
     try {
       const p = JSON.parse(fs.readFileSync(progressPath, 'utf8'));
@@ -1025,7 +1059,29 @@ function extractEntryIds(md) {
 // Extracts a single entry block (heading + body until next ### or EOF) from the template.
 function extractEntryBlock(md, id) {
   const escId = id.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-  const re = new RegExp(`(^### \\[${escId}\\][\\s\\S]*?)(?=^### \\[|\\Z)`, 'm');
+  const re = new RegExp(`(^### \\[${escId}\\][\\s\\S]*?)(?=^### \\[|$(?![\\s\\S]))`, 'm');
+  const m = md.match(re);
+  return m ? m[1].trimEnd() : null;
+}
+
+// Returns gotcha entry IDs ("[G-001]", "[G-NEXUS-P3]" etc.) found in a markdown body.
+// Supports both `### [G-NNN]` and `## [G-NNN] ...` heading levels.
+function extractGotchaEntryIds(md) {
+  const re = /^#{2,3}\s+\[(G-[A-Z0-9_-]+)\]/gm;
+  const ids = [];
+  let m;
+  while ((m = re.exec(md)) !== null) ids.push(m[1]);
+  return ids;
+}
+
+// Extracts a single gotcha entry block from a markdown body.
+function extractGotchaEntryBlock(md, id) {
+  const escId = id.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  // JS lacks \Z; emulate end-of-string via (?![\s\S]) negative lookahead.
+  const re = new RegExp(
+    `(^#{2,3}\\s+\\[${escId}\\][\\s\\S]*?)(?=^#{2,3}\\s+\\[G-|$(?![\\s\\S]))`,
+    'm',
+  );
   const m = md.match(re);
   return m ? m[1].trimEnd() : null;
 }
@@ -1048,6 +1104,17 @@ function showMigrationProposal(flags) {
     console.log('    [' + flags.memoryMissingSystemEntries.join(', ') + ']');
     console.log('    사용자 [M-NNN] entry 는 보존, 시스템 entry 만 끝에 추가.');
   }
+  const gotchaSummary = Object.entries(flags.gotchaMissingEntries || {});
+  if (gotchaSummary.length) {
+    console.log('  • gotchas/: 시스템 entry 누락 — entry-level append 가능 (사용자 [G-NNN] 보존)');
+    for (const [file, ids] of gotchaSummary) {
+      console.log(`    ${file}: [${ids.join(', ')}]`);
+    }
+  }
+  if (flags.bundleVersionStale) {
+    const { current, installed } = flags.bundleVersionStale;
+    console.log(`  • bundle: ${installed ?? '(없음)'} → ${current} 스탬프 갱신 필요`);
+  }
   console.log('');
   console.log('  적용:  npx walwal-harness migrate');
   console.log('  미리보기:  npx walwal-harness migrate --dry-run');
@@ -1060,13 +1127,18 @@ function showMigrationProposal(flags) {
 function runMigrate(opts = {}) {
   const dryRun = opts.dryRun || false;
   const flags = detectMigrationNeeded();
+  const gotchaMissingTotal = Object.values(flags.gotchaMissingEntries || {}).reduce((n, a) => n + a.length, 0);
   if (
     !flags.progressV3toV4 &&
     !flags.configMissingModeSelection &&
-    (!flags.memoryMissingSystemEntries || flags.memoryMissingSystemEntries.length === 0)
+    (!flags.memoryMissingSystemEntries || flags.memoryMissingSystemEntries.length === 0) &&
+    gotchaMissingTotal === 0 &&
+    !flags.bundleVersionStale
   ) {
     console.log('');
-    log('이미 최신 버전입니다 (progress v' + TARGET_PROGRESS_VERSION + ' + config.mode_selection + memory 시스템 entry 모두 존재).');
+    let pkgVer = 'unknown';
+    try { pkgVer = JSON.parse(fs.readFileSync(path.join(PKG_ROOT, 'package.json'), 'utf8')).version; } catch {}
+    log(`이미 최신 — bundle v${pkgVer} 일치, progress v${TARGET_PROGRESS_VERSION}, config.mode_selection, memory 시스템 entry, gotcha entry 모두 sync.`);
     return;
   }
 
@@ -1141,6 +1213,39 @@ function runMigrate(opts = {}) {
     }
   }
 
+  // 4. gotcha entry merge — for each bundled gotcha file, append missing
+  //    [G-NNN] entries while preserving everything the user already has.
+  const gotchaMissing = flags.gotchaMissingEntries || {};
+  for (const [file, missingIds] of Object.entries(gotchaMissing)) {
+    if (!missingIds.length) continue;
+    const srcPath = path.join(PKG_ROOT, 'gotchas', file);
+    const destPath = path.join(HARNESS_DIR, 'gotchas', file);
+    if (!fs.existsSync(srcPath) || !fs.existsSync(destPath)) continue;
+    const original = fs.readFileSync(destPath, 'utf8');
+    const tpl = fs.readFileSync(srcPath, 'utf8');
+    const blocks = [];
+    for (const id of missingIds) {
+      const block = extractGotchaEntryBlock(tpl, id);
+      if (block) blocks.push(block);
+    }
+    if (!blocks.length) continue;
+    log(`  gotchas/${file}: 시스템 entry ${blocks.length}개 append (${missingIds.join(', ')})`);
+    if (!dryRun) {
+      fs.writeFileSync(path.join(backupDir, `gotchas-${file}`), original);
+      const sep = original.endsWith('\n') ? '\n' : '\n\n';
+      fs.writeFileSync(destPath, original + sep + blocks.join('\n\n') + '\n');
+    }
+  }
+
+  // 5. Bundle version stamp — record which package version was last applied.
+  if (flags.bundleVersionStale) {
+    const { current, installed } = flags.bundleVersionStale;
+    log(`  .bundle-version: ${installed ?? '(none)'} → ${current}`);
+    if (!dryRun) {
+      fs.writeFileSync(path.join(HARNESS_DIR, '.bundle-version'), current + '\n');
+    }
+  }
+
   console.log('');
   if (dryRun) {
     log('Dry-run 완료 — 실제 변경 적용하려면 `npx walwal-harness migrate` 실행');
@@ -1320,8 +1425,20 @@ function main() {
 
   // v6.0 — propose migration if existing project is on v3
   const migFlags = detectMigrationNeeded();
-  if (migFlags.progressV3toV4 || migFlags.configMissingModeSelection) {
+  const gotchaMissing = Object.keys(migFlags.gotchaMissingEntries || {}).length > 0;
+  const hasContentDrift =
+    migFlags.progressV3toV4 ||
+    migFlags.configMissingModeSelection ||
+    (migFlags.memoryMissingSystemEntries && migFlags.memoryMissingSystemEntries.length) ||
+    gotchaMissing;
+  if (hasContentDrift) {
     showMigrationProposal(migFlags);
+  } else if (migFlags.bundleVersionStale) {
+    // 콘텐츠 드리프트 없이 stamp 만 누락/오래됨 → 정합성 차원에서 직접 갱신.
+    try {
+      const pkg = JSON.parse(fs.readFileSync(path.join(PKG_ROOT, 'package.json'), 'utf8'));
+      fs.writeFileSync(path.join(HARNESS_DIR, '.bundle-version'), pkg.version + '\n');
+    } catch {}
   }
 
   // v6.0 — Brick Office dashboard one-liner

package/gotchas/conductor.md

@@ -68,6 +68,21 @@ docmeta:
   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

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.3",
+  "version": "6.0.5",
   "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/conductor/SKILL.md

@@ -142,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/generator-frontend/SKILL.md

@@ -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/scripts/harness-archive.sh

@@ -1,109 +0,0 @@
-#!/bin/bash
-# harness-archive.sh — 스프린트 종료 시 자동 아카이빙
-#
-# 동작:
-#   1. .harness/actions/ 의 스프린트 산출물을 .harness/archive/D-NNN/S-NNN/ 로 이동
-#   2. progress.json 의 sprint 상태를 초기화 (신규 dispatch 준비)
-#   3. dispatch.id 가 없으면 counter++ 로 새 dispatch 시작
-#
-# 유지되는 파일 (이동하지 않음):
-#   - .harness/gotchas/**, .harness/conventions/**, .harness/ref/**
-#   - .harness/config.json, .harness/memory.md
-#   - .harness/progress.json (초기화만)
-#
-# 호출 주체: harness-next.sh (next_agent="archive" 도달 시 자동)
-
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-source "$SCRIPT_DIR/lib/harness-render-progress.sh" 2>/dev/null || true
-
-PROJECT_ROOT="${1:-.}"
-PROJECT_ROOT="$(cd "$PROJECT_ROOT" && pwd)"
-
-PROGRESS="$PROJECT_ROOT/.harness/progress.json"
-ACTIONS_DIR="$PROJECT_ROOT/.harness/actions"
-ARCHIVE_ROOT="$PROJECT_ROOT/.harness/archive"
-
-if [ ! -f "$PROGRESS" ]; then
-  echo "[archive] ERROR: progress.json not found" >&2
-  exit 1
-fi
-
-command -v jq >/dev/null 2>&1 || { echo "[archive] ERROR: jq required" >&2; exit 1; }
-
-# ── Read current dispatch/sprint numbers ──
-dispatch_counter=$(jq -r '.dispatch.counter // 0' "$PROGRESS")
-dispatch_id=$(jq -r '.dispatch.id // empty' "$PROGRESS")
-sprint_num=$(jq -r '.sprint.number // 0' "$PROGRESS")
-
-# Ensure dispatch id exists (fallback for legacy progress.json without dispatch)
-if [ -z "$dispatch_id" ] || [ "$dispatch_id" = "null" ]; then
-  if [ "$dispatch_counter" -lt 1 ]; then
-    dispatch_counter=1
-  fi
-  dispatch_id=$(printf 'D-%03d' "$dispatch_counter")
-fi
-
-sprint_id=$(printf 'S-%03d' "$sprint_num")
-target_dir="$ARCHIVE_ROOT/$dispatch_id/$sprint_id"
-
-echo ""
-echo "  ── Archive ────────────────────────────"
-echo "  Dispatch : $dispatch_id"
-echo "  Sprint   : $sprint_id"
-echo "  Target   : ${target_dir#$PROJECT_ROOT/}"
-
-# ── Move actions/ contents into archive ──
-if [ -d "$ACTIONS_DIR" ] && [ "$(ls -A "$ACTIONS_DIR" 2>/dev/null)" ]; then
-  mkdir -p "$target_dir"
-  moved=0
-  for f in "$ACTIONS_DIR"/*; do
-    [ -e "$f" ] || continue
-    name="$(basename "$f")"
-    if [ -e "$target_dir/$name" ]; then
-      # Collision — suffix with timestamp to avoid overwrite
-      ts=$(date +%Y%m%d-%H%M%S)
-      mv "$f" "$target_dir/${name%.}.${ts}"
-    else
-      mv "$f" "$target_dir/"
-    fi
-    moved=$((moved + 1))
-  done
-  echo "  Moved    : $moved file(s)"
-else
-  echo "  Moved    : 0 file(s) (actions/ empty)"
-fi
-
-# ── Reset progress.json for next dispatch ──
-# - sprint → init
-# - agents → cleared
-# - artifacts → pending
-# - dispatch.id cleared (next dispatcher run will allocate new D-NNN)
-# - failure → cleared
-jq --arg now "$(date -u +%Y-%m-%dT%H:%M:%SZ)" '
-  .pipeline = null
-  | .dispatch.id = null
-  | .sprint = { number: 0, status: "init", retry_count: 0 }
-  | .current_agent = null
-  | .agent_status = "pending"
-  | .completed_agents = []
-  | .next_agent = "dispatcher"
-  | .failure = { agent: null, location: null, message: null, retry_target: null }
-  | (.artifacts // {}) as $a
-  | .artifacts = ($a | with_entries(
-      if (.value | type) == "object"
-      then .value = { status: "pending", updated_by: null, updated_at: null }
-      else .
-      end))
-  | .updated_at = $now
-' "$PROGRESS" > "${PROGRESS}.tmp" && mv "${PROGRESS}.tmp" "$PROGRESS"
-
-# ── Clear handoff so next session starts fresh ──
-HANDOFF="$PROJECT_ROOT/.harness/handoff.json"
-echo '{}' > "$HANDOFF"
-
-echo "  Status   : archived, progress reset"
-echo ""
-echo "  ✓ 다음 요청은 새로운 dispatch 로 시작합니다."
-echo ""

package/scripts/harness-dashboard-up.sh

@@ -1,72 +0,0 @@
-#!/usr/bin/env bash
-# walwal-harness — Brick Office dashboard launcher
-#
-# 처음 쓰는 사용자도 한 줄로 대시보드를 띄워볼 수 있게 만든 helper.
-# walwal-harness CLI 패키지에는 R3F + Next.js 무게 때문에 dashboard 가 미포함이고,
-# 본 스크립트가 git sparse-checkout 으로 apps/harness-dashboard/ 만 가져와서
-# 사용자 프로젝트 외부 (~/.walwal-harness/dashboard) 에 격리 설치 후 dev 실행한다.
-#
-# Usage:
-#   bash scripts/harness-dashboard-up.sh                 # install + dev (port 3001)
-#   bash scripts/harness-dashboard-up.sh --port 3050     # override port
-#   HARNESS_ROOT=/path/to/project bash ...               # explicit harness root
-set -euo pipefail
-
-REPO_URL="${WALWAL_HARNESS_REPO:-https://github.com/30eggis/walwal-harness.git}"
-DASHBOARD_PATH="apps/harness-dashboard"
-LOCAL_DIR="${HOME}/.walwal-harness/dashboard"
-PORT="${PORT:-3001}"
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --port) PORT="$2"; shift 2 ;;
-    --reinstall) rm -rf "$LOCAL_DIR"; shift ;;
-    --help|-h)
-      sed -n '2,16p' "$0"
-      exit 0 ;;
-    *) echo "[brick-office] unknown arg: $1" >&2; exit 2 ;;
-  esac
-done
-
-if [[ -z "${HARNESS_ROOT:-}" ]]; then
-  HARNESS_ROOT="$(pwd)"
-fi
-if [[ ! -d "${HARNESS_ROOT}/.harness" ]]; then
-  echo "[brick-office] FAIL: ${HARNESS_ROOT} 에 .harness/ 가 없습니다."
-  echo "                먼저 'npx walwal-harness' 로 초기화하세요."
-  exit 3
-fi
-
-echo "[brick-office] HARNESS_ROOT = ${HARNESS_ROOT}"
-echo "[brick-office] dashboard 격리 경로 = ${LOCAL_DIR}"
-
-if [[ ! -d "${LOCAL_DIR}/${DASHBOARD_PATH}" ]]; then
-  echo "[brick-office] 첫 실행 — git sparse-checkout 으로 dashboard 만 가져옵니다 (~5MB)."
-  mkdir -p "${LOCAL_DIR}"
-  cd "${LOCAL_DIR}"
-  git init -q
-  git remote add origin "${REPO_URL}" 2>/dev/null || true
-  git config core.sparseCheckout true
-  echo "${DASHBOARD_PATH}/" > .git/info/sparse-checkout
-  git fetch --depth=1 origin main -q
-  git checkout main -q
-  echo "[brick-office] 다운로드 완료."
-fi
-
-cd "${LOCAL_DIR}/${DASHBOARD_PATH}"
-
-if [[ ! -d node_modules ]]; then
-  echo "[brick-office] npm install (한 번만 실행, ~30s)..."
-  npm install --no-audit --no-fund --loglevel=error
-fi
-
-echo ""
-echo "╔══════════════════════════════════════════════════════════╗"
-echo "║  Brick Office — http://localhost:${PORT}"
-echo "║                                                          ║"
-echo "║  HARNESS_ROOT 이 가리키는 프로젝트의 .harness/ 상태를     ║"
-echo "║  실시간 (SSE) 시각화합니다. Ctrl+C 로 종료.              ║"
-echo "╚══════════════════════════════════════════════════════════╝"
-echo ""
-
-HARNESS_ROOT="${HARNESS_ROOT}" npm run dev:dashboard -- -p "${PORT}"