@walwal-harness/cli 5.9.5 → 6.0.0

package/CHANGELOG.md

@@ -0,0 +1,105 @@
+---
+docmeta:
+  id: CHANGELOG
+  title: walwal-harness CHANGELOG
+  type: output
+  createdAt: 2026-05-07T00:00:00Z
+  updatedAt: 2026-05-07T00:00:00Z
+  source:
+    producer: agent
+    skillId: harness-release
+  inputs:
+    - documentId: agency-mapping
+      uri: .harness/agency-mapping.md
+      relation: output-from
+      sections:
+        - sourceRange: { startLine: 41, endLine: 53 }
+          targetRange: { startLine: 28, endLine: 40 }
+    - documentId: doctrine-nexus
+      uri: .harness/doctrine/nexus.md
+      relation: output-from
+      sections:
+        - sourceRange: { startLine: 32, endLine: 60 }
+          targetRange: { startLine: 41, endLine: 50 }
+    - documentId: package
+      uri: package.json
+      relation: output-from
+  tags: [changelog, release-notes, v6.0.0, nexus]
+---
+
+# Changelog
+
+## 6.0.0 — NEXUS-Adapted Company Metaphor (2026-05-07)
+
+회사 메타포로의 전면 전환. 기존 단일 dispatcher/planner/generator/evaluator 라인업을 NEXUS 도큐트린에 따라 7부서 + 14 에이전트 조직도로 재해석했습니다.
+
+### Added
+- **CEO (Dispatcher 격상)** — Owner ↔ 회사 단일 대화 창구. GOAL 협의·escalation 보고.
+- **Conductor** — 자율 실행 엔진. Gen↔Eval 무인 루프.
+- **Meeting-Manager** — 동기화 엔진. 5종 회의(standup/planning/review/all-hands/phase-gate) 적응형 cadence.
+- **COO (Planner)** — Sprint·AC·HR·온보딩 통합.
+- **CTO (Generator 총괄)** — Gen-BE/Gen-FE/Designer/DevOps 4팀 통솔.
+- **CQO (Evaluator 총괄)** — Eval-Functional/Visual/CodeQuality + 신규 Architecture/Security.
+- **Service-Ops** — 운용·모니터·인시던트·자율회고.
+- 신규 14개 SKILL.md (`skills/{conductor,meeting-manager,cto,cqo,service-ops,evaluator-architecture,evaluator-security,generator-designer,generator-devops,...}/SKILL.md`).
+- `.harness/doctrine/nexus.md` — Foundational Principles (P1~P5) + 7 Phase Lifecycle.
+- `.harness/agency-mapping.md` — agency-agents → walwal-harness 매핑 (Phase A 결과).
+- `.harness/memory.md` 기반 공유 학습 시스템 (gotcha 와 분리).
+- Brainstormer 스킬 (obra/superpowers 파생, MIT, Visual Companion 포함).
+- 적응형 ref-docs (`.harness/ref/<role>-<stack>.md`) — 단일 에이전트가 스택별 best-practice 동적 로드.
+
+### Changed
+- `agents` 섹션의 Flutter 변형 (`generator-frontend-flutter` / `evaluator-functional-flutter`) 제거. 단일 에이전트가 `.harness/ref/<role>-<stack>.md` 동적 로드.
+- AGENTS.md IA-MAP — 부서 권한 매트릭스 25항 (이전 12항).
+- progress.json 스키마 v3 — `org/goals/conductor/meetings/cto/cqo/service_ops` 슬롯 추가.
+- Evaluator chain 명시화: `evaluator-code-quality → evaluator-functional → evaluator-visual` (FULLSTACK/FE-ONLY) / `code-quality → functional` (BE-ONLY).
+
+### Removed
+- Flutter "유령 스킬" 참조 ([M-001] resolved). config.json + dispatcher SKILL.md 의 fe_stack_substitution 폐기.
+- 기존 PRE-NEXUS dispatcher 단일 라인업.
+- **Dispatcher 의 Solo/Team 모드 질문**. 사용자 "harness-solo / harness-team 입력하세요" 안내 패턴 제거.
+
+### Mode Decision — User → Conductor 이양 (Breaking)
+- `progress.json.mode` 디폴트 `"solo"` → `"auto"`. version 3 → 4.
+- 신규 필드 `progress.json.mode_decision = { owner, decided_at, rationale, user_override }`.
+- `config.json.mode_selection` 신규 — `force_team_when`(ready≥3 + features≥6 + depth≤2) / `force_solo_when` / tie-breaker=solo.
+- Conductor SKILL §7.5: Planner 의 feature-list 확정 직후 자동 결정. 결정은 progress.json + progress.log 에 rationale 명시.
+- `/harness-solo`, `/harness-team` 은 사용자 override 명령으로 의미 변경. `mode_decision.user_override` 에 기록되어 현재 sprint 종료까지 유지. "auto 로 돌려" 발화로 자동결정 복귀.
+- Dispatcher SKILL §"Mode 결정 위임" — 모드 질문/추천 출력 모두 폐기. 사용자 발화에서 명시적 모드 신호 감지 시만 user_override 로 기록.
+
+### Migration (5.9.x → 6.0.0)
+
+기존 walwal-harness 사용 프로젝트는 `npm install @walwal-harness/cli@latest` 후 다음 한 줄로 자동 마이그레이션 가능:
+
+```bash
+npx walwal-harness migrate --dry-run    # 변경 미리보기
+npx walwal-harness migrate              # 실제 적용
+```
+
+**자동 처리되는 것**:
+- `progress.json` v3 → v4 — 기존 `mode` 값 (`"solo"` 또는 `"team"`) 을 `mode_decision.user_override` 로 **그대로 보존**. 새 mode 는 `"auto"` 로 셋되지만 user_override 로 직전 sprint 의 사용자 의도 유지.
+- `config.json` 의 `mode_selection` 누락 시 자동 주입 (rules: ready≥3 + features≥6 + depth≤2 → team / 그 외 → solo). 사용자 customization (`behavior`, `flow.pre_eval_gate.*`) 은 **모두 보존**.
+- 변경 전 자동 백업: `.harness/archive/migration-<timestamp>/` (progress.json + config.json 원본).
+
+**수동 처리 권장**:
+1. AGENTS.md 의 IA-MAP 권한 매트릭스 신규 25항 검토.
+2. 기존 sprint 진행 중이라면 `.harness/archive/` 로 수동 이관 후 새 dispatch 시작.
+3. `.claude/skills/` 의 신규 14개 부서 SKILL.md 가 정상 설치되었는지 확인 (`ls .claude/skills/` 에 conductor / cto / cqo / meeting-manager / service-ops / evaluator-architecture / evaluator-security 포함).
+4. Flutter 프로젝트 사용자: `pubspec.yaml` 자동 감지 + `.harness/ref/generator-frontend-flutter.md` (있을 시) 로 동작. 누락 시 Planner 가 ref 생성 권고.
+
+**Postinstall 안내**: `npm install` 후 v3 detect 시 안내 banner 가 출력될 수 있으나 npm v9+ 의 quiet mode 에서는 누락될 수 있습니다. 의심 시 `npx walwal-harness migrate --dry-run` 으로 직접 확인하세요.
+
+### Reference
+Phase C "Brick Office 대시보드 MVP" 가 본 v6 organization 기반 첫 풀사이클 검증 (3 sprints, 25 features, 모든 평가 PASS).
+
+## 5.9.6 — Queue Integrity & Lead Guard (이전)
+- queue enqueue/integrity 명령 추가, dashboard orphan 경고, Lead 가드.
+
+## 5.9.5 — Solo/Team Mode Drift Fix
+- progress.json mode drift 시 dashboard/tmux 가 SOLO 로 잘못 표시되던 버그 수정.
+
+## 5.9.4 — Graceful Crash Recovery
+- progress.json 손상 시 dashboard crash → 안내 메시지로 graceful 처리.
+
+## 5.9.3 — Compressed Output Fix
+- 분할 패널에서 Conventions/Memory 가 3 줄만 보이던 압축 출력 수정.

package/README.md

@@ -69,25 +69,31 @@ npx walwal-harness team
 #### 대시보드 구성
 
 ```
-┌────────────────────┬──────────────────────────┬───────────┐
-│ Dashboard          │ Gotcha & Memory          │ TEAM 1    │
-│  - pipeline/sprint │  - 활성 에이전트 gotcha   │  Gen|Eval │
-│  - feature 진행도  │  - 나머지 에이전트 요약    ├───────────┤
-│  - queue 상태      │  - SHARED MEMORY          │ TEAM 2    │
-│                    │   (memory.md 최근 N)      │  Gen|Eval │
-├────────────────────┤                          ├───────────┤
-│ Archive Prompt     │                          │ TEAM 3    │
-│  (완료 feature 요약)│                          │  Gen|Eval │
-└────────────────────┴──────────────────────────┴───────────┘
+┌────────────────────┬───────────────┬───────────┐
+│ Dashboard          │ Gotchas       │ TEAM 1    │
+│  - pipeline/sprint │  (활성 에이전트)│  Gen|Eval │
+│  - feature 진행도  ├───────────────┤           │
+│  - queue 상태      │ Conventions   ├───────────┤
+│                    │  (하우스 스타일)│ TEAM 2    │
+├────────────────────┤               │  Gen|Eval │
+│ Archive Prompt     ├───────────────┤           │
+│  (완료 feature 요약)│ Memory        ├───────────┤
+│                    │  (공유 교훈)   │ TEAM 3    │
+│                    │               │  Gen|Eval │
+└────────────────────┴───────────────┴───────────┘
 ```
 
 | 패널 | 내용 | 소스 |
 |------|------|------|
 | **Dashboard** | Pipeline · Sprint · Feature passes · Queue R:B:P · Retry | `harness-dashboard.sh` |
-| **Gotcha & Memory** | 활성 에이전트의 누적 실수 + 나머지 요약 + 공유 메모리 | `harness-gotcha-memory.sh` |
+| **Gotchas** | 활성 에이전트의 누적 실수 (`[G-NNN]`) — v5.9.1 부터 독립 패널 | `harness-gotcha-memory.sh --mode gotcha` |
+| **Conventions** | 하우스 스타일 (`[C-NNN]`) — v5.9.1 부터 독립 패널, 독립 스크롤 | `harness-gotcha-memory.sh --mode conventions` |
+| **Memory** | 공유 교훈 (`memory.md`) — v5.9.1 부터 독립 패널 | `harness-gotcha-memory.sh --mode memory` |
 | **TEAM 1–3** | 각 워커의 현재 feature · phase(Gen/Eval) · 실시간 stdout | `harness-queue-manager.sh` worker loop |
 | **Archive Prompt** | 직전 완료 feature 요약 (다음 팀 컨텍스트 주입용) | archive 디렉토리 |
 
+> **v5.9.1+** Rules 컬럼이 3분할(Gotchas/Conventions/Memory)되어 각각 독립 스크롤됩니다. tmux/iTerm2 모두 동일한 레이아웃을 보장합니다.
+
 ##### Feature 상태 아이콘 (v5.6.4+)
 
 | 아이콘 | 상태 | 의미 |
@@ -220,6 +226,16 @@ Dispatcher 자동 분류:
 
 → Dispatcher 가 `memory.md` 에 `### [M-NNN] ...` 로 기록. Planner 리뷰 후 `unverified → verified` 로 승격.
 
+#### 동적 Gotcha/Convention 자동 등록 (v5.9.0+)
+
+Worker 가 `gen-report-*.md` / `evaluation-*.md` 본문에 `gotcha_candidates` / `convention_candidates` 블록을 작성하면, Lead 가 PASS merge 직후 자동으로 dedup append:
+
+```bash
+bash scripts/harness-gotcha-register.sh . --scan-all
+```
+
+→ 다음 worker spawn 전에 갱신된 gotchas/conventions 가 file system 에 반영. **한 sprint 안에서 발견된 실수를 같은 sprint 의 다음 worker 가 즉시 회피**할 수 있게 됨. Generator 도 mandatory — 모든 에이전트가 후보를 자기 보고서에 남기는 것을 강제합니다.
+
 #### 주의 — 데이터 보존
 
 `npm install` postinstall 은 **누적 엔트리(`[G-NNN]` 또는 `[C-NNN]`)가 있는 파일을 절대 덮어쓰지 않습니다**. 스캐폴드 템플릿인 경우에만 갱신됩니다. v5.5.2 이전 버전은 gotchas 에 이 버그가 있었으므로 `5.6.0+` 사용을 권장합니다.
@@ -470,6 +486,13 @@ jq '.mode = "solo"' .harness/progress.json > /tmp/p.json && mv /tmp/p.json .harn
 - v5.5.2 에서 해결 (postinstall 이 누적 엔트리를 절대 덮어쓰지 않도록 수정).
 - 반드시 `5.5.2+` 사용.
 
+### Dashboard 헤더가 SOLO 인데 실제로는 팀 모드로 돌고 있음
+- v5.9.5 에서 해결. `feature-queue.json.queue.in_progress > 0` 이면 dashboard refresh / tmux 재기동 시 자동으로 `mode=team` 으로 self-heal 합니다.
+- 그 이전 버전: `progress.json` 의 `mode` 만 직접 수정하거나 새 세션을 열어 SessionStart 훅의 heal 을 트리거.
+
+### `progress.json` 손상 시 dashboard crash
+- v5.9.4 에서 해결. invalid JSON 인 경우 안내 메시지로 graceful degrade. 복구 가이드는 dashboard 본문에 inline 표시됩니다.
+
 ---
 
 ## License

package/assets/templates/config.json

@@ -342,6 +342,35 @@
     "auto_route_dispatcher": true,
     "auto_route_dispatcher_description": "true 이면 사용자의 모든 프롬프트가 harness-dispatcher 경유로 분류/라우팅 된다. 사용자가 'harness skip' 등을 말하면 단일 메시지 한정으로 건너뛴다."
   },
+  "mode_selection": {
+    "comment": "v6.0 — Solo/Team 모드를 사용자가 아닌 Conductor 가 결정. progress.json.mode='auto' 일 때 Conductor 가 feature-list 의 ready_count + 의존성 깊이 + sprint feature 수를 보고 룰을 적용. 사용자는 /harness-solo 또는 /harness-team 으로 override 가능하며 그 결정은 progress.json.mode_decision.user_override 에 기록된다.",
+    "default_mode": "auto",
+    "owner": "conductor",
+    "rules": {
+      "force_team_when": {
+        "ready_at_start_gte": 3,
+        "feature_count_gte": 6,
+        "critical_path_depth_lte": 2,
+        "rationale": "ready≥3 + 작은 critical path = 3팀 동시 가동의 P4 Parallel Workstreams 효과 충족 (NEXUS 40~60% 단축)"
+      },
+      "force_solo_when": {
+        "ready_at_start_lte": 2,
+        "or_feature_count_lte": 3,
+        "or_critical_path_depth_gte": 4,
+        "rationale": "직렬 의존 우세 → Team 으로 띄워도 2팀이 유휴. tmux 운영 비용·토큰 3x 정당화 안 됨."
+      },
+      "tie_breaker": "solo",
+      "tie_breaker_rationale": "동률 시 비용 안전한 Solo 선호. 사용자가 명시적으로 team 선택 시만 force."
+    },
+    "user_override": {
+      "comment": "사용자가 명시적으로 모드 강제하면 Conductor 결정 무시. progress.json.mode_decision.user_override 에 기록.",
+      "channels": [
+        "/harness-solo (force solo)",
+        "/harness-team (force team)",
+        "사용자 발화: 'solo 로', 'team 으로', 'auto 다시' (auto 복귀)"
+      ]
+    }
+  },
   "paths": {
     "actions": ".harness/actions",
     "archive": ".harness/archive",

package/assets/templates/progress.json.template

@@ -1,6 +1,12 @@
 {
-  "version": 3,
-  "mode": "solo",
+  "version": 4,
+  "mode": "auto",
+  "mode_decision": {
+    "owner": "conductor",
+    "decided_at": null,
+    "rationale": null,
+    "user_override": null
+  },
   "project_name": "",
   "pipeline": null,
   "dispatch": {

package/bin/init.js

@@ -904,16 +904,19 @@ function showHelp() {
 ╚══════════════════════════════════════╝
 
 Usage:
-  npx walwal-harness              Initialize project for harness engineering
-  npx walwal-harness --force      Re-initialize (overwrites existing files)
-  npx walwal-harness team         Launch Team Mode (tmux studio + auto teams)
-  npx walwal-harness team --kill  Kill Team Mode tmux session
-  npx walwal-harness --help       Show this help
-
-Modes (use inside claude/codex session):
-  /harness-solo       Solo mode — prompting-based sequential pipeline
-  /harness-team       Team mode — auto parallel Gen-Eval loop (3 teams)
+  npx walwal-harness                       Initialize project for harness engineering
+  npx walwal-harness --force               Re-initialize (overwrites existing files)
+  npx walwal-harness team                  Launch Team Mode (tmux studio + auto teams)
+  npx walwal-harness team --kill           Kill Team Mode tmux session
+  npx walwal-harness migrate               Apply v3 → v4 migration (mode→auto + Conductor)
+  npx walwal-harness migrate --dry-run     Preview migration changes without applying
+  npx walwal-harness --help                Show this help
+
+Modes (v6.0+ — Conductor 자동 결정, 사용자 override 가능):
+  /harness-solo       Solo Override — Conductor 결정을 Solo 로 강제
+  /harness-team       Team Override — Conductor 결정을 Team 으로 강제 (tmux 부팅)
   /harness-stop       Stop Team mode (preserves queue state)
+  발화 "auto 로 돌려" → Conductor 자동결정 복귀
 
 What it does:
   1. Scaffolds .harness/ directory (actions, archive, gotchas, config)
@@ -965,6 +968,120 @@ function runTeamStudio() {
   execSync(cmd, { stdio: 'inherit' });
 }
 
+// ─────────────────────────────────────────
+// Migration — v3 → v4 (mode auto + Conductor ownership)
+// ─────────────────────────────────────────
+const TARGET_PROGRESS_VERSION = 4;
+
+function detectMigrationNeeded() {
+  const progressPath = path.join(HARNESS_DIR, 'progress.json');
+  const configPath = path.join(HARNESS_DIR, 'config.json');
+  const flags = { progressV3toV4: false, configMissingModeSelection: false };
+  if (fs.existsSync(progressPath)) {
+    try {
+      const p = JSON.parse(fs.readFileSync(progressPath, 'utf8'));
+      if ((p.version ?? 0) < TARGET_PROGRESS_VERSION) flags.progressV3toV4 = true;
+    } catch {}
+  }
+  if (fs.existsSync(configPath)) {
+    try {
+      const c = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+      if (!c.mode_selection) flags.configMissingModeSelection = true;
+    } catch {}
+  }
+  return flags;
+}
+
+function showMigrationProposal(flags) {
+  console.log('');
+  console.log('╔══════════════════════════════════════════════════════════╗');
+  console.log('║  walwal-harness v6 — 자동 마이그레이션 사용 가능         ║');
+  console.log('╚══════════════════════════════════════════════════════════╝');
+  if (flags.progressV3toV4) {
+    console.log('  • progress.json: v3 → v4 (mode → "auto" + mode_decision 추가)');
+    console.log('    기존 mode 값은 user_override 로 보존됩니다.');
+  }
+  if (flags.configMissingModeSelection) {
+    console.log('  • config.json: mode_selection 섹션 누락 — 자동 주입 가능');
+    console.log('    Conductor 가 ready≥3 + features≥6 + depth≤2 로 자동 모드 결정.');
+  }
+  console.log('');
+  console.log('  적용:  npx walwal-harness migrate');
+  console.log('  미리보기:  npx walwal-harness migrate --dry-run');
+  console.log('');
+  console.log('  ※ 자동 강제 X — 사용자가 명령을 실행할 때만 변경됩니다.');
+  console.log('  ※ 변경 전 .harness/archive/migration-<ts>/ 에 자동 백업.');
+  console.log('');
+}
+
+function runMigrate(opts = {}) {
+  const dryRun = opts.dryRun || false;
+  const flags = detectMigrationNeeded();
+  if (!flags.progressV3toV4 && !flags.configMissingModeSelection) {
+    console.log('');
+    log('이미 최신 버전입니다 (progress.json v' + TARGET_PROGRESS_VERSION + ' + config.json mode_selection 존재).');
+    return;
+  }
+
+  console.log('');
+  log(dryRun ? '=== DRY RUN — 실제 변경 없음 ===' : '=== Migration 적용 ===');
+
+  const ts = new Date().toISOString().replace(/[:.]/g, '-');
+  const backupDir = path.join(HARNESS_DIR, 'archive', `migration-${ts}`);
+  if (!dryRun) ensureDir(backupDir);
+
+  // 1. progress.json
+  const progressPath = path.join(HARNESS_DIR, 'progress.json');
+  if (flags.progressV3toV4 && fs.existsSync(progressPath)) {
+    const original = fs.readFileSync(progressPath, 'utf8');
+    const p = JSON.parse(original);
+    const oldMode = p.mode ?? 'solo';
+    const newP = {
+      ...p,
+      version: TARGET_PROGRESS_VERSION,
+      mode: 'auto',
+      mode_decision: {
+        owner: 'conductor',
+        decided_at: null,
+        rationale: `migration v3→v4 — 기존 mode="${oldMode}" 를 user_override 로 보존`,
+        user_override: oldMode === 'team' || oldMode === 'solo' ? oldMode : null,
+      },
+    };
+    log(`  progress.json: version 3 → ${TARGET_PROGRESS_VERSION}, mode "${oldMode}" → "auto" (user_override="${newP.mode_decision.user_override}")`);
+    if (!dryRun) {
+      fs.writeFileSync(path.join(backupDir, 'progress.json'), original);
+      fs.writeFileSync(progressPath, JSON.stringify(newP, null, 2) + '\n');
+    }
+  }
+
+  // 2. config.json — inject mode_selection from template if missing
+  const configPath = path.join(HARNESS_DIR, 'config.json');
+  const tplPath = path.join(PKG_ROOT, 'assets', 'templates', 'config.json');
+  if (flags.configMissingModeSelection && fs.existsSync(configPath) && fs.existsSync(tplPath)) {
+    const original = fs.readFileSync(configPath, 'utf8');
+    const c = JSON.parse(original);
+    const tpl = JSON.parse(fs.readFileSync(tplPath, 'utf8'));
+    if (tpl.mode_selection) {
+      c.mode_selection = tpl.mode_selection;
+      log('  config.json: mode_selection 섹션 주입 (default_mode=auto, owner=conductor, force_team_when ready≥3+features≥6+depth≤2, tie_breaker=solo)');
+      if (!dryRun) {
+        fs.writeFileSync(path.join(backupDir, 'config.json'), original);
+        fs.writeFileSync(configPath, JSON.stringify(c, null, 2) + '\n');
+      }
+    }
+  }
+
+  console.log('');
+  if (dryRun) {
+    log('Dry-run 완료 — 실제 변경 적용하려면 `npx walwal-harness migrate` 실행');
+  } else {
+    log(`Migration 완료. 백업: ${backupDir}`);
+    log('Conductor 가 다음 sprint 시작 시 자동으로 모드 결정합니다.');
+    log('자동 결정 무시하려면 /harness-solo 또는 /harness-team override.');
+  }
+  console.log('');
+}
+
 function main() {
   if (isHelp) {
     showHelp();
@@ -976,6 +1093,11 @@ function main() {
     return;
   }
 
+  if (subcommand === 'migrate') {
+    runMigrate({ dryRun: args.includes('--dry-run') });
+    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".');
@@ -1006,6 +1128,22 @@ function main() {
   checkPlaywrightMcp();
   checkRecommendedSkills();
 
+  // v6.0 — propose migration if existing project is on v3
+  const migFlags = detectMigrationNeeded();
+  if (migFlags.progressV3toV4 || migFlags.configMissingModeSelection) {
+    showMigrationProposal(migFlags);
+  }
+
+  // v6.0 — Brick Office dashboard one-liner
+  console.log('');
+  console.log('╔══════════════════════════════════════════════════════════╗');
+  console.log('║  Brick Office — 라이브 운영 대시보드 (선택)              ║');
+  console.log('╚══════════════════════════════════════════════════════════╝');
+  console.log('  bash scripts/harness-dashboard-up.sh');
+  console.log('  → http://localhost:3001 에서 .harness/ 상태 실시간 시각화');
+  console.log('  → 첫 실행 시 git sparse-checkout 으로 ~5MB 만 가져옵니다.');
+  console.log('');
+
   console.log('');
   log('═══ Initialization Complete ═══');
   log('');

package/commands/harness-next.md

@@ -32,7 +32,9 @@ bash scripts/harness-next.sh .
 - 에스컬레이션 체크 (3회 실패 시 → Planner)
 - 마지막 에이전트면 자동 archive 실행
 
-### Step 2: handoff.json 읽고 다음 에이전트 호출
+### 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}'

package/commands/harness-solo.md

@@ -4,15 +4,31 @@ docmeta:
   title: /harness-solo — Solo Mode 시작/전환
   type: input
   createdAt: 2026-04-20T00:00:00Z
-  updatedAt: 2026-04-27T00:00:00Z
+  updatedAt: 2026-05-07T00:00:00Z
   source:
     producer: user
     skillId: harness
-  inputs: []
-  tags: [harness, solo-mode, command]
+  inputs:
+    - documentId: skill-conductor
+      uri: ../skills/conductor/SKILL.md
+      relation: output-from
+      sections:
+        - sourceRange: { startLine: 115, endLine: 145 }   # §7.5 모드 결정 위임 룰 + user_override 채널
+          targetRange: { startLine: 17, endLine: 22 }     # 본 명령의 v6.0 override 안내 블록
+    - documentId: config-template
+      uri: ../assets/templates/config.json
+      relation: output-from
+      sections:
+        - sourceRange: { startLine: 345, endLine: 372 }   # mode_selection 룰 (force_solo_when 등)
+          targetRange: { startLine: 17, endLine: 22 }
+  tags: [harness, solo-mode, command, override, v6]
 ---
 
-# /harness-solo — Solo Mode 시작/전환
+# /harness-solo — Solo Mode 사용자 Override (v6.0+)
+
+> v6.0 부터 모드 결정은 **Conductor 가 자동**으로 합니다 (config.json `mode_selection.rules`). 본 명령은 Conductor 의 자동 결정을 사용자가 강제로 덮어쓰는 **override** 입니다.
+>
+> **효과**: `progress.json.mode = "solo"` 강제 + `mode_decision.user_override = "solo"` 기록. 현재 sprint 끝까지 유지. 다음 sprint 진입 시 Conductor 가 재자동결정. **Auto 복귀**: 사용자 발화 "auto 로 돌려" 또는 "Conductor 결정으로".
 
 프롬프트 기반으로 하네스 파이프라인을 순차 진행합니다.
 Team 모드에서 전환 시, 진행 중이던 피처의 상태를 보존하고 Solo로 이어갑니다.

package/commands/harness-team.md

@@ -1,18 +1,34 @@
 ---
 docmeta:
   id: harness-team
-  title: /harness-team — Team Mode 시작/재개
+  title: /harness-team — Team Mode 사용자 Override (v6.0+)
   type: input
   createdAt: 2026-04-20T00:00:00Z
-  updatedAt: 2026-04-20T00:00:00Z
+  updatedAt: 2026-05-07T00:00:00Z
   source:
     producer: user
     skillId: harness
-  inputs: []
-  tags: [harness, team-mode, tmux, command]
+  inputs:
+    - documentId: skill-conductor
+      uri: ../skills/conductor/SKILL.md
+      relation: output-from
+      sections:
+        - sourceRange: { startLine: 115, endLine: 145 }   # §7.5 모드 결정 + user_override
+          targetRange: { startLine: 17, endLine: 22 }
+    - documentId: config-template
+      uri: ../assets/templates/config.json
+      relation: output-from
+      sections:
+        - sourceRange: { startLine: 345, endLine: 372 }   # mode_selection.rules.force_team_when
+          targetRange: { startLine: 17, endLine: 22 }
+  tags: [harness, team-mode, tmux, command, override, v6]
 ---
 
-# /harness-team — Team Mode 시작/재개
+# /harness-team — Team Mode 사용자 Override (v6.0+)
+
+> v6.0 부터 모드 결정은 **Conductor 가 자동**으로 합니다 (config.json `mode_selection.rules.force_team_when`: ready≥3 + features≥6 + critical_path_depth≤2). 본 명령은 Conductor 의 자동 결정을 사용자가 강제로 덮어쓰는 **override** 입니다.
+>
+> **효과**: `progress.json.mode = "team"` 강제 + `mode_decision.user_override = "team"` 기록 + tmux 세션 부팅. 현재 sprint 끝까지 유지. 다음 sprint 진입 시 Conductor 가 재자동결정. **Auto 복귀**: 사용자 발화 "auto 로 돌려" 또는 "Conductor 결정으로".
 
 Planner가 완료한 feature-list.json의 피처들을 최대 3개 팀이 병렬로 Gen→Eval 사이클을 수행합니다.
 
@@ -447,6 +463,46 @@ Lead에게 반환 **첫 줄에 반드시 `RATE_LIMIT` 태그 포함**:
 
 ---
 
+## Ad-hoc Feature 추가 — Canonical Path (필수)
+
+Lead 가 sprint 진행 중 핫픽스 / 새 sprint feature 를 추가해야 할 때 **`feature-queue.json` 을 jq 로 직접 편집하면 안 된다**. feature-list.json 과 큐가 갈라져서 dashboard 가 누락 표시하고, Planner/Evaluator 가 AC 를 찾지 못한다.
+
+**금지**:
+```bash
+# ❌ 절대 금지 — feature-list 우회
+jq '.queue.ready += ["F-XXX"]' .harness/actions/feature-queue.json > /tmp/q.json && mv /tmp/q.json .harness/actions/feature-queue.json
+```
+
+**Canonical**:
+```bash
+# ✅ 옵션 1 — 새 sprint 의 정식 feature 들이면 Planner 재호출
+#    Planner 가 feature-list.json 에 sprint=N 으로 append → next-sprint 가 큐 채움.
+
+# ✅ 옵션 2 — 단발 핫픽스면 enqueue 명령 사용 (feature-list append + 큐 insert 원자적)
+cat > /tmp/feat.json <<EOF
+{
+  "id": "F-XXX",
+  "title": "auth refresh token lifecycle hotfix",
+  "sprint": 8,
+  "depends_on": [],
+  "layer": "fe",
+  "service": "frontend",
+  "acceptance_criteria": [{"id":"AC-1","description":"...","type":"manual","verify":{"tool":"grep","steps":["..."]}}]
+}
+EOF
+bash scripts/harness-queue-manager.sh enqueue /tmp/feat.json
+```
+
+**무결성 체크** (Lead 루프 진입 직전 권장):
+```bash
+bash scripts/harness-queue-manager.sh integrity
+# 종료 코드 0 = OK, 1 = orphan feature 발견 (feature-list 에 없는 queue 항목)
+```
+
+이 룰을 위반한 사례: Sprint 8 (2026-04-29) 에 F-716, F-800~F-806 이 jq 직접 편집으로 큐에만 등록되어 dashboard Features 패널에서 800 번대가 모두 누락된 적 있음. **dashboard 는 v5.9.6+ 에서 union 렌더 + orphan 경고로 가시화하지만, 가시화는 차단이 아님 — Lead 가 위 canonical path 만 쓸 것**.
+
+---
+
 ## 핵심 원칙
 
 ### Worker = 1 Feature Only

package/gotchas/generator-backend-laravel.md

@@ -0,0 +1,85 @@
+---
+docmeta:
+  id: gotchas-generator-backend-laravel
+  title: Generator-Backend Gotchas — Laravel/Livewire/Filament
+  type: output
+  createdAt: 2026-05-07T00:00:00Z
+  updatedAt: 2026-05-07T00:00:00Z
+  source:
+    producer: agent
+    skillId: harness-planner
+  inputs:
+    - documentId: agency-agents-engineering
+      uri: https://github.com/msitarzewski/agency-agents
+      relation: output-from
+      sections:
+        - sourceRange: { startLine: 1, endLine: 1 }
+          targetRange: { startLine: 1, endLine: 999 }
+  tags: [gotcha, generator-backend, laravel, livewire, filament, phase-b]
+---
+
+<!-- Source: https://github.com/msitarzewski/agency-agents (MIT) -->
+
+# Generator-Backend Gotchas — Laravel/Livewire/Filament
+
+> 스택별 가드. 공통 가드는 `gotchas/generator-backend.md` 참조.
+> 모든 항목은 `unverified` 상태로 시작, Planner 리뷰 후 `verified` 승격.
+
+## verified
+
+(없음 — 첫 리비전)
+
+## unverified
+
+### G-LV-001 — Livewire 컴포넌트가 Eloquent 모델을 prop으로 받을 때 직렬화 충돌
+- **언제**: 부모 컴포넌트 → 자식 컴포넌트로 모델을 직접 props 전달
+- **증상**: 새 요청마다 모델 hydrate 실패, lazy load 시 fresh 로드되어 데이터 불일치
+- **회피**: ID만 전달 + 자식이 자기 책임으로 fetch, 또는 `serializeable=true` 명시 + 변경 위험 인지
+
+### G-LV-002 — `wire:model.live` 무차별 사용으로 N+1 트래픽 폭발
+- **증상**: 입력 1자마다 서버 왕복, 운영에서 큐 폭주
+- **회피**: 폼 입력 default `wire:model.live.debounce.500ms` 또는 `wire:model.lazy`
+
+### G-FL-001 — Filament Resource `eagerLoad()` 누락
+- **증상**: 인덱스 페이지 1회 로드에 컬럼 수 × 행 수 만큼 쿼리 (N+1)
+- **회피**: Resource에 `protected $eagerLoadRelations = ['user', 'category']` 명시. Eval-Architecture가 검출.
+
+### G-FL-002 — Filament Tenancy panel에서 Global scope 누락
+- **증상**: 한 테넌트 사용자가 다른 테넌트 데이터 노출
+- **회피**: `getEloquentQuery()` 오버라이드 시 `parent::getEloquentQuery()` 후 scope 추가. Eval-Security 적발.
+
+### G-EL-001 — `whereHas` 다단 사용으로 인덱스 미사용 쿼리
+- **증상**: relation 깊이 ≥ 2 + 결과 set 크면 secs 단위
+- **회피**: subquery 또는 `whereIn(select 1 column)` 패턴, EXPLAIN 첨부
+
+### G-EL-002 — Mass assignment 누락 → 권한 우회
+- **증상**: 사용자가 `is_admin` 같은 컬럼을 요청 본문에 끼워 권한 상승
+- **회피**: 모든 모델 `$fillable` 또는 `$guarded = []` 의도 명시. Eval-Security CRITICAL.
+
+### G-MIG-001 — 인덱스 없는 외래키 컬럼
+- **증상**: parent delete 시 child scan 풀스캔
+- **회피**: 마이그레이션에서 `foreignId(...)->index()` 명시
+
+### G-JOB-001 — Job 안에서 retry 비대응 외부 호출
+- **증상**: Stripe·외부 API 호출이 retry 시 중복 결제·중복 메시지
+- **회피**: idempotency_key 또는 `ShouldBeUnique`. Eval-Security 검토.
+
+### G-CACHE-001 — `Cache::tags()` on file driver
+- **증상**: 운영에서 silent fail (tag 무시)
+- **회피**: prod cache driver는 redis 강제. config/cache.php boot 시 검증.
+
+### G-AUTH-001 — Sanctum 토큰 회전 정책 부재
+- **증상**: 토큰 영구 유효 → 누출 시 영향 무한대
+- **회피**: TTL + 사용 흐름별 ability 분리, 회전 명령 정의 (DevOps와 연계)
+
+### G-OBS-001 — observer chain → 부작용 폭발
+- **증상**: User saving → Profile observer → Account observer → 무한 루프 또는 dead-lock
+- **회피**: observer 안에서 다른 모델 save 금지 룰. 명시적 Action 호출로 대체.
+
+### G-FORM-001 — `$request->validate()` 인라인 사용
+- **증상**: 검증 룰 재사용·테스트·문서화 모두 어려움
+- **회피**: FormRequest 클래스 강제. Eval-CodeQuality lint 룰.
+
+### G-PERF-001 — Telescope prod 활성
+- **증상**: 모든 쿼리·요청 적재 → DB 비대 + 보안 노출
+- **회피**: env 분리, prod에서 `TelescopeServiceProvider` 등록 차단. Eval-Security 적발.