@walwal-harness/cli 5.9.6 → 6.0.1

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 적발.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "5.9.6",
-  "description": "Production harness for AI agent engineering — Solo/Team mode, Planner, Generator(BE/FE), Evaluator chain (Code-Quality → Functional → Visual), optional Brainstormer. Supports React, Next.js, and Flutter FE stacks.",
+  "version": "6.0.1",
+  "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"
   },
@@ -24,6 +24,13 @@
     "planner",
     "generator",
     "evaluator",
+    "nexus",
+    "ceo",
+    "cto",
+    "cqo",
+    "conductor",
+    "meeting-manager",
+    "service-ops",
     "nestjs",
     "react",
     "flutter",
@@ -45,6 +52,7 @@
     "scripts/",
     "commands/",
     "assets/",
-    "gotchas/"
+    "gotchas/",
+    "CHANGELOG.md"
   ]
 }

package/scripts/harness-dashboard-up.sh

@@ -0,0 +1,72 @@
+#!/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}"

package/scripts/harness-goal-init.sh

@@ -0,0 +1,72 @@
+#!/usr/bin/env bash
+# harness-goal-init.sh — 새 GOAL 발급 (CEO=Dispatcher 전용)
+# 사용법: bash scripts/harness-goal-init.sh "<title>"
+#
+# 동작:
+#   1. .harness/actions/goals.md 가 없으면 template로 생성
+#   2. 다음 GOAL ID(G-N) 발급 → progress.json.goals.list 에 등록
+#   3. progress.json.goals.active_id 갱신
+#   4. CTO 협의 미완료 상태(cto_feasibility=null, owner_confirmed=false)
+#
+# 후속:
+#   - CTO는 cto_feasibility 의견을 협의 후 같은 항목에 채워줌
+#   - Owner 최종 확인 시 dispatcher 가 owner_confirmed=true 로 갱신
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+GOAL_FILE="$ROOT/.harness/actions/goals.md"
+TEMPLATE="$ROOT/.harness/actions/goals.md.template"
+PROGRESS="$ROOT/.harness/progress.json"
+
+TITLE="${1:-}"
+if [ -z "$TITLE" ]; then
+  echo "usage: $0 \"<title>\"" >&2
+  exit 1
+fi
+
+mkdir -p "$ROOT/.harness/actions"
+
+# 1. 파일이 없으면 template 복사 후 ISO 시각 채움
+if [ ! -f "$GOAL_FILE" ]; then
+  if [ ! -f "$TEMPLATE" ]; then
+    echo "template missing: $TEMPLATE" >&2; exit 1
+  fi
+  ISO="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+  sed "s|<ISO>|$ISO|g" "$TEMPLATE" > "$GOAL_FILE"
+fi
+
+# 2. 다음 GOAL ID 계산
+LAST_N=$(jq -r '.goals.list | map(.id // "G-0") | map(sub("G-"; "")) | map(tonumber? // 0) | max // 0' "$PROGRESS" 2>/dev/null || echo 0)
+NEXT_N=$((LAST_N + 1))
+GOAL_ID="G-${NEXT_N}"
+ISO="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+
+# 3. progress.json 에 등록 (partial update)
+jq --arg id "$GOAL_ID" --arg title "$TITLE" --arg iso "$ISO" '
+  .goals.list += [{
+    "id": $id,
+    "title": $title,
+    "status": "draft",
+    "owner_confirmed": false,
+    "cto_feasibility": null,
+    "created_at": $iso
+  }] |
+  .goals.active_id = $id |
+  .updated_at = $iso
+' "$PROGRESS" > "$PROGRESS.tmp" && mv "$PROGRESS.tmp" "$PROGRESS"
+
+# 4. goals.md 에 GOAL 섹션 append (CEO가 이후 본문 채움)
+cat >> "$GOAL_FILE" <<EOF
+
+## $GOAL_ID — $TITLE
+status: draft
+owner_confirmed: false
+cto_feasibility: null
+created_at: $ISO
+
+(CEO가 success_metrics·deadline·kpis·runbook 채움)
+EOF
+
+echo "$GOAL_ID 발급 완료: $TITLE"
+echo "→ $GOAL_FILE 에서 본문 작성"
+echo "→ CTO 협의 후 owner 확정 시 owner_confirmed=true"

package/scripts/harness-goal-show.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+# harness-goal-show.sh — 현재 active GOAL + 적합도 요약 출력
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+PROGRESS="$ROOT/.harness/progress.json"
+GOAL_FILE="$ROOT/.harness/actions/goals.md"
+
+if [ ! -f "$PROGRESS" ]; then
+  echo "progress.json 없음. bash init.sh 먼저 실행." >&2; exit 1
+fi
+
+ACTIVE_ID=$(jq -r '.goals.active_id // ""' "$PROGRESS")
+ADHERENCE=$(jq -r '.goals.current_adherence // "n/a"' "$PROGRESS")
+
+if [ -z "$ACTIVE_ID" ]; then
+  echo "Active GOAL 없음. CEO(Dispatcher)가 첫 발화에서 발급."
+  echo "  bash scripts/harness-goal-init.sh \"<title>\""
+  exit 0
+fi
+
+echo "Active GOAL: $ACTIVE_ID"
+echo "Adherence:   $ADHERENCE"
+echo ""
+
+# progress.json 의 GOAL 메타 출력
+jq -r --arg id "$ACTIVE_ID" '
+  .goals.list[] | select(.id == $id) |
+  "title:           \(.title)",
+  "status:          \(.status)",
+  "owner_confirmed: \(.owner_confirmed)",
+  "cto_feasibility: \(.cto_feasibility // "pending")",
+  "created_at:      \(.created_at // "?")"
+' "$PROGRESS"
+
+echo ""
+echo "본문: $GOAL_FILE 에서 ## $ACTIVE_ID 섹션 참조"

package/scripts/harness-next.sh

@@ -415,25 +415,24 @@ if [ "$next_agent" != "null" ] && [ "$next_agent" != "archive" ] && [ "$agent_st
   # ── Collect artifacts ──
   FEATURE_LIST="$PROJECT_ROOT/.harness/actions/feature-list.json"
 
-  local -a artifacts_ready=()
+  artifacts_ready=()
   for f in plan.md feature-list.json api-contract.json sprint-contract.md evaluation-functional.md evaluation-visual.md; do
     if [ -f "$PROJECT_ROOT/.harness/actions/$f" ]; then
       artifacts_ready+=("$f")
     fi
   done
-  local artifacts_json
   artifacts_json=$(printf '%s\n' "${artifacts_ready[@]}" | jq -R . | jq -s .)
 
   # Collect focus features (incomplete ones)
-  local focus_features="[]"
+  focus_features="[]"
   if [ -f "$FEATURE_LIST" ]; then
     focus_features=$(jq '[.features[]? | select(.passes == null or (.passes | length) == 0 or ((.passes // []) | map(select(. == "evaluator-functional")) | length == 0)) | .id] | .[0:5]' "$FEATURE_LIST" 2>/dev/null || echo "[]")
   fi
 
   # ── Regression data ──
-  local regression_source="null"
-  local prev_sprint=$((sprint_num - 1))
-  local prev_archive="$PROJECT_ROOT/.harness/archive/sprint-$(printf '%03d' $prev_sprint)"
+  regression_source="null"
+  prev_sprint=$((sprint_num - 1))
+  prev_archive="$PROJECT_ROOT/.harness/archive/sprint-$(printf '%03d' $prev_sprint)"
   if [ "$prev_sprint" -ge 1 ] && [ -d "$prev_archive" ]; then
     if [ -f "$prev_archive/feature-list.json" ]; then
       regression_source=$(jq '{
@@ -445,8 +444,8 @@ if [ "$next_agent" != "null" ] && [ "$next_agent" != "archive" ] && [ "$agent_st
   fi
 
   # ── Eval-specific config ──
-  local eval_config="null"
-  local cross_validation_data="null"
+  eval_config="null"
+  cross_validation_data="null"
   case "$next_agent" in
     evaluator-*)
       eval_config=$(jq '{
@@ -462,15 +461,15 @@ if [ "$next_agent" != "null" ] && [ "$next_agent" != "archive" ] && [ "$agent_st
   esac
 
   # ── Cross-Validation (chain: code-quality → functional → visual) ──
-  local cross_validation_from_code_quality="null"
+  cross_validation_from_code_quality="null"
   if [ "$next_agent" = "evaluator-functional" ] || [ "$next_agent" = "evaluator-visual" ]; then
-    local cq_eval="$PROJECT_ROOT/.harness/actions/evaluation-code-quality.md"
+    cq_eval="$PROJECT_ROOT/.harness/actions/evaluation-code-quality.md"
     if [ -f "$cq_eval" ]; then
       cross_validation_from_code_quality=$(sed -n '/```json/,/```/p' "$cq_eval" | tail -n +2 | head -n -1 | jq 'select(.evaluator == "code-quality" or .cross_validation_from_code_quality)' 2>/dev/null || echo "null")
     fi
   fi
   if [ "$next_agent" = "evaluator-visual" ]; then
-    local func_eval="$PROJECT_ROOT/.harness/actions/evaluation-functional.md"
+    func_eval="$PROJECT_ROOT/.harness/actions/evaluation-functional.md"
     if [ -f "$func_eval" ]; then
       cross_validation_data=$(sed -n '/```json/,/```/p' "$func_eval" | tail -n +2 | head -n -1 | jq 'select(.evaluator == "functional")' 2>/dev/null || echo "null")
     fi

package/skills/conductor/SKILL.md

@@ -0,0 +1,247 @@
+---
+name: harness-conductor
+description: "자율 실행 엔진. Dispatcher(CEO)가 하달한 GOAL을 받아 Planner→Gen→Eval→Service-Ops 루프를 사용자 개입 없이 끊김없이 진행한다. 3회 FAIL/GOAL 위반/인시던트 시 Dispatcher 통해 Owner에게 escalation. 트리거: '컨덕터 시작', 'conductor run', 'autopilot on'."
+disable-model-invocation: false
+---
+
+<!--
+Source attribution: https://github.com/msitarzewski/agency-agents (MIT)
+이 스킬은 specialized/agents-orchestrator.md 의 자율 파이프라인 매니저 패턴을
+walwal-harness 의 Dispatcher/Planner/Gen/Eval/Service-Ops 조직도에 맞게 재해석함.
+-->
+
+# Conductor — 자율 실행 엔진
+
+> "Dispatcher는 입, **Conductor는 손**, Planner는 머리, CTO/CQO/Service-Ops는 몸."
+> 사용자는 Dispatcher와 대화하고, Conductor가 알아서 굴린다.
+
+## 0. 자율 시동 트리거 (NEXUS P3 Inviolable)
+
+Conductor 는 다음 시점에 **자동 시동**한다. 사용자 펌프 없이.
+
+1. **Dispatcher 가 GOAL 을 확정한 직후** — `progress.json.goals.active_id` 가 set 되고 `progress.json.next_agent` 가 `"planner"` 또는 `"conductor"` 로 set 되면 즉시.
+2. **Planner 가 feature-list 를 확정한 직후** — `feature-list.json` 의 status 가 `"approved"` 가 되면 Gen↔Eval 루프 시동.
+3. **Eval PASS 직후** — chain 의 다음 평가자 또는 다음 sprint 로 즉시 advance.
+4. **Eval FAIL 직후** — `failure.retry_target` 으로 자동 라우팅.
+
+**금지**: 사용자에게 "다음 단계 진행할까요?" 묻지 말 것. 모드 결정도 Conductor 가 자동 (config.json `mode_selection.rules`). 사용자는 미션·결과·escalation 만 본다 — 회사가 매 단계 사용자 허락을 구하면 NEXUS 메타포가 무너진다.
+
+자세한 anti-pattern → `.harness/gotchas/dispatcher.md` 의 [G-002] 자율 실행 위반.
+
+## 1. 정체성
+
+- **위치**: Dispatcher(CEO) 직속, Planner와 평행
+- **책임**: 한 번 시동 걸리면 GOAL 달성 또는 escalation까지 자율 진행
+- **권한**: 어떤 Generator/Evaluator도 spawn 가능. Meeting-Manager 호출 가능. 코드는 직접 쓰지 않음(전적으로 Generator 위임).
+- **금지**: Owner와 직접 대화, GOAL 임의 수정, Eval 점수 임의 override.
+
+## 2. 입력 / 출력
+
+**입력**
+- `.harness/actions/goals.md` (현재 활성 GOAL)
+- `.harness/progress.json` (현재 상태)
+- `.harness/actions/feature-list.json`
+- `.harness/actions/sprint-contract.md`
+
+**출력**
+- `progress.json.conductor.{state, last_tick, next_action, retries, escalation}` 필드 갱신
+- `.harness/conductor.log` (틱별 결정 로그)
+- escalation 시 `.harness/actions/escalations/<id>.md`
+
+## 3. State Machine
+
+```
+idle ─► running ─► (waiting_meeting | waiting_owner | running) ─► completed
+                                                       └─► escalated ─► paused
+```
+
+| state | 의미 | 트리거 |
+|---|---|---|
+| `idle` | 시동 대기 | 초기 / 완료 후 |
+| `running` | 다음 부서 spawn 중 | 정상 진행 |
+| `waiting_meeting` | Meeting-Manager 결정 대기 | Spec/Sprint Review/Phase Gate 발생 |
+| `waiting_owner` | Owner 응답 대기 | escalation 발신 후 |
+| `escalated` | escalation 진행 중 | 3회 FAIL · GOAL 위반 · 인시던트 |
+| `paused` | 사용자 수동 정지 | `/conductor stop` |
+| `completed` | GOAL 달성 또는 Phase 종료 | Phase Gate PASS |
+
+## 4. Tick Loop (핵심 알고리즘)
+
+매 틱마다:
+
+```
+1. read progress.json + goals.md
+2. compute next_action:
+   - if conductor.state ∈ {paused, waiting_*, escalated}: return (no-op)
+   - if open Meeting exists: state = waiting_meeting; return
+   - if Service-Ops red-alert: spawn Incident War Room Meeting; state = waiting_meeting
+   - if 3-consecutive-FAIL on same (feature, axis): escalate; return
+   - if goal_adherence < 0.7: spawn Spec Review Meeting; return
+   - else: next_agent = progress.json.next_agent (Planner이 계산)
+3. spawn(next_agent) with handoff package (sprint-contract + feature row)
+4. on agent complete:
+   - update progress.json (partial, jq)
+   - append conductor.log
+5. evaluate Phase Gate:
+   - if all features in current Phase PASS ≥ 2.80: spawn Phase Gate Meeting
+6. loop or exit
+```
+
+## 5. Spawn 결정 트리
+
+```
+[Planner missing or sprint=0]      → spawn planner
+[generator pending in feature row] → spawn generator-{be|fe|designer|devops}
+[generator done, eval pending]     → spawn evaluator-{func|visual|cq|arch|sec}
+[all eval PASS for feature]        → next feature
+[all features PASS]                → Phase Gate Meeting
+[Service-Ops cron due]             → spawn service-ops monitor
+[ops-report ready]                 → handoff to CTO (spawn cto-review)
+```
+
+## 6. Escalation 트리거 & 양식
+
+| 트리거 | 양식 | Owner 응답 옵션 |
+|---|---|---|
+| 3회 연속 FAIL (같은 feature·축) | scope 축소 / 접근 변경 / abort 중 택 1 요청 | 1·2·3 |
+| `goal_adherence < 0.5` 24h 이상 | GOAL 재정의 vs 자원 추가 | A·B |
+| 인시던트 P0~P1 | 즉시 보고 + 핫픽스 승인 요청 | 승인/반려 |
+| 승인 필요 의사결정 (Phase Gate, 예산, 외부 API 키 등) | 옵션 명시 | 옵션 선택 |
+
+`.harness/actions/escalations/<id>.md` 작성 후 `progress.json.conductor.state = "waiting_owner"`. Dispatcher가 다음 Owner 메시지에서 이를 읽고 보고.
+
+## 7. 실행 모드
+
+### 모드 A: 채팅 루프 내부 (1차, 기본)
+- 매 Owner 메시지 또는 hook 트리거 시 1틱 진행
+- `scripts/conductor-tick.sh` 가 진입점
+- UserPromptSubmit hook에서 `next=conductor` 일 때 자동 호출
+
+### 모드 B: 데몬 (2차 옵션)
+- `scripts/conductor-daemon.sh` (백그라운드 nohup)
+- 60s 주기 또는 fs-watch trigger
+- Owner는 대시보드에서만 진행 상황 확인
+- escalation 발생 시 push notification
+
+> 1차 릴리즈는 모드 A만 활성. 모드 B는 안정화 후 옵트인.
+
+## 7.5 모드 결정 (v6.0+, 사용자에서 이양)
+
+이전에는 사용자가 `/harness-solo` 또는 `/harness-team` 으로 직접 선택했다. v6.0 부터 **Conductor 가 sprint 시작 시점에 자동 결정**한다. 사용자 override 는 가능하지만 디폴트는 자동.
+
+### 7.5.1 결정 시점
+
+- Planner 가 `feature-list.json` 작성/갱신 직후, sprint 시작 전.
+- 새 sprint 진입 시 (이전 sprint archive 후).
+- 사용자 override 발화 감지 시 (즉시 재계산 없이 그 발화부터 적용).
+
+### 7.5.2 룰 (config.json `mode_selection.rules` 참조)
+
+```
+# Team 강제 조건 (모두 만족)
+ready_at_start ≥ 3
+feature_count ≥ 6
+critical_path_depth ≤ 2
+
+# Solo 강제 조건 (어느 하나라도)
+ready_at_start ≤ 2
+또는 feature_count ≤ 3
+또는 critical_path_depth ≥ 4
+
+# 동률 → solo (비용 안전)
+```
+
+`critical_path_depth` = feature 의존성 그래프에서 가장 긴 체인의 길이. `feature-list.json` 의 `depends_on` 으로 계산.
+
+### 7.5.3 적용
+
+1. 결정 후 `progress.json` partial update:
+   ```json
+   "mode": "solo" 또는 "team",
+   "mode_decision": {
+     "owner": "conductor",
+     "decided_at": "<iso>",
+     "rationale": "ready=4, features=8, depth=2 → team",
+     "user_override": null
+   }
+   ```
+2. `progress.log` 한 줄: `conductor: mode=team (ready=4, features=8, depth=2)`
+3. Team 결정 시 추가: tmux 세션 부재면 `scripts/harness-tmux.sh` 자동 기동 권고만 출력 (실제 부팅은 사용자 확인 필요 — 외부 OS 영향이라 hard automation 회피).
+
+### 7.5.4 사용자 override
+
+다음 발화가 감지되면 Conductor 결정을 무시하고 사용자 선호로 강제:
+
+| 발화/명령 | 효과 |
+|---|---|
+| `/harness-solo` 또는 "solo 로" | mode=solo 강제, mode_decision.user_override="solo" |
+| `/harness-team` 또는 "team 으로" | mode=team 강제, user_override="team" |
+| "auto 다시" / "Conductor 결정으로" | user_override=null, 다음 sprint 시작 시 재자동결정 |
+
+override 는 **현재 sprint 끝까지** 유지된다. 다음 sprint 진입 시 user_override 가 명시적으로 살아있지 않으면 자동 재계산.
+
+### 7.5.5 Dispatcher 위임 룰
+
+Dispatcher 는 더 이상 사용자에게 Solo/Team 모드를 묻지 않는다. dispatcher SKILL.md §4 의 모드 질문은 v6.0 부터 제거. 사용자가 모드를 명시한 경우만 user_override 로 기록 후 즉시 적용.
+
+## 8. progress.json 추가 필드
+
+```json
+"conductor": {
+  "state": "idle|running|waiting_meeting|waiting_owner|escalated|paused|completed",
+  "last_tick": "<iso>",
+  "tick_count": 0,
+  "current_action": "spawn:generator-frontend",
+  "retries": { "<feature_id>:<axis>": 0 },
+  "escalation": null,
+  "mode": "chat|daemon"
+}
+```
+
+## 9. Hook 통합
+
+- `UserPromptSubmit`: `next_agent == "conductor"` 일 때 `scripts/conductor-tick.sh` 호출
+- `PostToolUse:Write`: 코드 변경 감지 시 다음 틱에 Eval 강제 진입
+- `SessionStart`: conductor.state 가 `running` 이면 "자율 실행 진행 중" 안내
+
+## 10. Session Boundary Protocol
+
+### On Start (each tick)
+1. `.harness/progress.json` 읽기 — `conductor.state` 확인
+2. partial update: `conductor.last_tick`, `tick_count++`
+3. `.harness/memory.md` 읽기 — escalation 룰 적용
+
+### On Complete (each tick)
+1. partial update:
+   - `conductor.state` → 결정된 다음 상태
+   - `conductor.current_action` → 다음 spawn 대상 또는 `null`
+   - `next_agent` → 결정된 부서
+2. `.harness/conductor.log` append: `[<ts>] tick=<n> state=<s> action=<a>`
+
+### On Escalation
+1. `.harness/actions/escalations/<id>.md` 작성
+2. partial update: `conductor.state = "waiting_owner"`, `conductor.escalation = "<id>"`
+3. 다음 Owner 메시지에서 Dispatcher가 보고
+
+## 11. 안전 가드
+
+- **루프 폭주 방지**: `tick_count` 가 한 세션에서 100 초과 시 자동 `paused`
+- **무한 retry 방지**: 같은 (feature, axis) 3회 FAIL 시 escalation 강제
+- **권한 위반 감지**: spawn 대상이 권한 없는 파일을 수정하면 다음 틱에서 rollback + escalation
+- **GOAL 변경 보호**: Conductor는 goals.md를 절대 수정하지 않음 (CEO 전용)
+
+## 12. 사용자 명령
+
+| 명령 | 동작 |
+|---|---|
+| `/conductor start` | state → running, 다음 틱부터 가동 |
+| `/conductor stop` | state → paused |
+| `/conductor status` | 현재 state·tick·retries 요약 출력 |
+| `/conductor abort` | state → completed (강제 종료) + 회고 Sprint Review 소집 |
+
+## 13. 출처 (Attribution)
+
+본 스킬은 https://github.com/msitarzewski/agency-agents (MIT) 의 다음 패턴을 재해석함:
+- `specialized/agents-orchestrator.md` — autonomous pipeline manager
+- `strategy/nexus-strategy.md` — Dev↔QA 연속 루프
+- `testing/testing-reality-checker.md` — default-to-FAIL escalation 자세