@walwal-harness/cli 6.0.5 → 6.1.1

package/scripts/scan-project.sh

@@ -0,0 +1,367 @@
+#!/bin/bash
+# scan-project.sh — 기존 프로젝트 구조를 분석하여 하네스 초기화 정보를 생성
+# 출력: .harness/actions/scan-result.json
+set -e
+
+PROJECT_ROOT="${1:-.}"
+OUTPUT="${PROJECT_ROOT}/.harness/actions/scan-result.json"
+
+mkdir -p "$(dirname "$OUTPUT")"
+
+echo "=== Scanning project: ${PROJECT_ROOT} ==="
+
+# ─────────────────────────────────────────
+# 1. 기존 AGENTS.md / CLAUDE.md 감지
+# ─────────────────────────────────────────
+AGENTS_MD="none"
+CLAUDE_MD="none"
+CLAUDE_MD_IS_SYMLINK=false
+EXISTING_RULES=""
+
+if [ -f "${PROJECT_ROOT}/AGENTS.md" ]; then
+  AGENTS_MD="exists"
+fi
+
+if [ -L "${PROJECT_ROOT}/CLAUDE.md" ]; then
+  CLAUDE_MD="symlink"
+  CLAUDE_MD_IS_SYMLINK=true
+elif [ -f "${PROJECT_ROOT}/CLAUDE.md" ]; then
+  CLAUDE_MD="exists"
+  # 기존 CLAUDE.md 내용 보존용 추출
+  EXISTING_RULES=$(cat "${PROJECT_ROOT}/CLAUDE.md")
+fi
+
+# ─────────────────────────────────────────
+# 2. Tech Stack 감지
+# ─────────────────────────────────────────
+TECH_BACKEND="unknown"
+TECH_FRONTEND="unknown"
+TECH_DB="unknown"
+TECH_MONOREPO="none"
+TECH_LANG="unknown"
+IS_NATIVE_APP=false
+
+# Backend
+if [ -f "${PROJECT_ROOT}/nest-cli.json" ]; then
+  TECH_BACKEND="nestjs"
+  TECH_LANG="typescript"
+elif [ -f "${PROJECT_ROOT}/requirements.txt" ] || [ -f "${PROJECT_ROOT}/pyproject.toml" ]; then
+  TECH_BACKEND="python"
+  TECH_LANG="python"
+  if grep -q "fastapi" "${PROJECT_ROOT}/requirements.txt" 2>/dev/null || grep -q "fastapi" "${PROJECT_ROOT}/pyproject.toml" 2>/dev/null; then
+    TECH_BACKEND="fastapi"
+  elif grep -q "django" "${PROJECT_ROOT}/requirements.txt" 2>/dev/null || grep -q "django" "${PROJECT_ROOT}/pyproject.toml" 2>/dev/null; then
+    TECH_BACKEND="django"
+  fi
+elif [ -f "${PROJECT_ROOT}/go.mod" ]; then
+  TECH_BACKEND="go"
+  TECH_LANG="go"
+elif [ -f "${PROJECT_ROOT}/pom.xml" ] || [ -f "${PROJECT_ROOT}/build.gradle" ]; then
+  TECH_BACKEND="java"
+  TECH_LANG="java"
+fi
+
+# Frontend
+# Flutter 우선 감지 — pubspec.yaml 존재하면 Flutter 프로젝트로 판정 (TECH_LANG도 보정)
+FE_STACK="react"   # react | flutter (기본값은 react 계열)
+FE_TARGET="web"    # web | mobile | desktop (Flutter 의 컴파일 타겟; React 는 항상 web)
+FLUTTER_ROOT=""    # Flutter 프로젝트 루트 경로 (web/mobile/desktop 감지용)
+
+if [ -f "${PROJECT_ROOT}/pubspec.yaml" ] && grep -q "flutter:" "${PROJECT_ROOT}/pubspec.yaml" 2>/dev/null; then
+  TECH_FRONTEND="flutter"
+  TECH_LANG="dart"
+  FE_STACK="flutter"
+  FLUTTER_ROOT="${PROJECT_ROOT}"
+elif [ -f "${PROJECT_ROOT}/next.config.js" ] || [ -f "${PROJECT_ROOT}/next.config.ts" ] || [ -f "${PROJECT_ROOT}/next.config.mjs" ]; then
+  TECH_FRONTEND="nextjs"
+elif [ -f "${PROJECT_ROOT}/vite.config.ts" ] || [ -f "${PROJECT_ROOT}/vite.config.js" ]; then
+  TECH_FRONTEND="vite-react"
+elif [ -f "${PROJECT_ROOT}/angular.json" ]; then
+  TECH_FRONTEND="angular"
+elif [ -f "${PROJECT_ROOT}/nuxt.config.ts" ]; then
+  TECH_FRONTEND="nuxt"
+fi
+
+# Monorepo 내 Frontend 감지
+if [ -d "${PROJECT_ROOT}/apps/web" ]; then
+  if [ -f "${PROJECT_ROOT}/apps/web/next.config.js" ] || [ -f "${PROJECT_ROOT}/apps/web/next.config.ts" ]; then
+    TECH_FRONTEND="nextjs"
+    FE_STACK="react"
+  elif [ -f "${PROJECT_ROOT}/apps/web/vite.config.ts" ]; then
+    TECH_FRONTEND="vite-react"
+    FE_STACK="react"
+  fi
+fi
+
+# Flutter 서브디렉토리 감지 (monorepo 또는 서브 프로젝트 케이스)
+if [ "$TECH_FRONTEND" = "unknown" ]; then
+  # 대표적인 Flutter 서브폴더 이름을 얕게 탐색
+  for d in apps/mobile apps/web mobile clue_mobile_app flutter_app; do
+    if [ -f "${PROJECT_ROOT}/${d}/pubspec.yaml" ] && grep -q "flutter:" "${PROJECT_ROOT}/${d}/pubspec.yaml" 2>/dev/null; then
+      TECH_FRONTEND="flutter"
+      TECH_LANG="dart"
+      FE_STACK="flutter"
+      FLUTTER_ROOT="${PROJECT_ROOT}/${d}"
+      break
+    fi
+  done
+fi
+
+# Flutter fe_target 감지 (web / mobile / desktop)
+# - web/index.html 존재 → web
+# - android/ 또는 ios/ 존재 + web/ 없음 → mobile
+# - macos/ 또는 windows/ 또는 linux/ 존재 + 위 둘 없음 → desktop
+# - 동시 존재 (멀티 타겟) → web 우선 (사용자가 Planner에서 변경 가능)
+if [ "$FE_STACK" = "flutter" ] && [ -n "$FLUTTER_ROOT" ]; then
+  HAS_WEB=false
+  HAS_MOBILE=false
+  HAS_DESKTOP=false
+  [ -f "${FLUTTER_ROOT}/web/index.html" ] && HAS_WEB=true
+  { [ -d "${FLUTTER_ROOT}/android" ] || [ -d "${FLUTTER_ROOT}/ios" ]; } && HAS_MOBILE=true
+  { [ -d "${FLUTTER_ROOT}/macos" ] || [ -d "${FLUTTER_ROOT}/windows" ] || [ -d "${FLUTTER_ROOT}/linux" ]; } && HAS_DESKTOP=true
+
+  if [ "$HAS_WEB" = "true" ]; then
+    FE_TARGET="web"
+  elif [ "$HAS_MOBILE" = "true" ]; then
+    FE_TARGET="mobile"
+  elif [ "$HAS_DESKTOP" = "true" ]; then
+    FE_TARGET="desktop"
+  else
+    FE_TARGET="unknown"
+  fi
+fi
+
+# Swift (macOS / iOS 네이티브 앱) 감지 — Flutter 감지 이후
+if [ "$TECH_FRONTEND" = "unknown" ]; then
+  SWIFT_DETECTED=false
+  if [ -f "${PROJECT_ROOT}/Package.swift" ]; then
+    SWIFT_DETECTED=true
+  fi
+  if ! $SWIFT_DETECTED; then
+    for f in "${PROJECT_ROOT}"/*.xcodeproj "${PROJECT_ROOT}"/*.xcworkspace; do
+      if [ -e "$f" ]; then
+        SWIFT_DETECTED=true
+        break
+      fi
+    done
+  fi
+  if ! $SWIFT_DETECTED && [ -f "${PROJECT_ROOT}/Podfile" ]; then
+    SWIFT_DETECTED=true
+  fi
+
+  if $SWIFT_DETECTED; then
+    TECH_LANG="swift"
+    IS_NATIVE_APP=true
+    FE_STACK="swift"       # FE_STACK 기본값(react) 을 Swift 로 치환
+    FE_TARGET="native"     # web/mobile/desktop 대신 native
+    # 서브타입 판별 — NSStatusBar 가 가장 특화적이므로 우선
+    if grep -rq "NSStatusBar.system" "${PROJECT_ROOT}" --include="*.swift" 2>/dev/null; then
+      TECH_FRONTEND="swift-macos-statusbar"
+    elif grep -rq "import SwiftUI" "${PROJECT_ROOT}" --include="*.swift" 2>/dev/null; then
+      TECH_FRONTEND="swift-swiftui"
+    elif grep -rq "import UIKit" "${PROJECT_ROOT}" --include="*.swift" 2>/dev/null; then
+      TECH_FRONTEND="swift-uikit"
+    else
+      TECH_FRONTEND="swift"
+    fi
+  fi
+fi
+
+# Database
+if grep -rq "typeorm\|prisma\|sequelize\|knex" "${PROJECT_ROOT}/package.json" 2>/dev/null; then
+  if grep -q "pg\|postgres" "${PROJECT_ROOT}/package.json" 2>/dev/null; then
+    TECH_DB="postgresql"
+  elif grep -q "mysql" "${PROJECT_ROOT}/package.json" 2>/dev/null; then
+    TECH_DB="mysql"
+  elif grep -q "sqlite" "${PROJECT_ROOT}/package.json" 2>/dev/null; then
+    TECH_DB="sqlite"
+  else
+    TECH_DB="orm-detected"
+  fi
+elif grep -rq "mongoose\|mongodb" "${PROJECT_ROOT}/package.json" 2>/dev/null; then
+  TECH_DB="mongodb"
+fi
+
+# Monorepo
+if [ -f "${PROJECT_ROOT}/turbo.json" ]; then
+  TECH_MONOREPO="turborepo"
+elif [ -f "${PROJECT_ROOT}/nx.json" ]; then
+  TECH_MONOREPO="nx"
+elif [ -f "${PROJECT_ROOT}/lerna.json" ]; then
+  TECH_MONOREPO="lerna"
+elif [ -f "${PROJECT_ROOT}/pnpm-workspace.yaml" ]; then
+  TECH_MONOREPO="pnpm-workspace"
+elif [ -f "${PROJECT_ROOT}/nest-cli.json" ] && grep -q '"monorepo": true' "${PROJECT_ROOT}/nest-cli.json" 2>/dev/null; then
+  TECH_MONOREPO="nestjs-monorepo"
+fi
+
+# ─────────────────────────────────────────
+# 3. 디렉토리 트리 스캔 (2 depth)
+# ─────────────────────────────────────────
+TREE=$(find "${PROJECT_ROOT}" -maxdepth 3 -type d \
+  ! -path "*/node_modules/*" \
+  ! -path "*/.git/*" \
+  ! -path "*/.next/*" \
+  ! -path "*/dist/*" \
+  ! -path "*/__pycache__/*" \
+  ! -path "*/.harness/archive/*" \
+  ! -name "node_modules" \
+  ! -name ".git" \
+  ! -name ".next" \
+  ! -name "dist" \
+  2>/dev/null | sort | sed "s|${PROJECT_ROOT}/||g" | sed '/^$/d')
+
+# ─────────────────────────────────────────
+# 4. 주요 설정 파일 목록
+# ─────────────────────────────────────────
+CONFIG_FILES=""
+for f in package.json tsconfig.json nest-cli.json next.config.js next.config.ts \
+         vite.config.ts docker-compose.yml docker-compose.yaml Dockerfile \
+         .env .env.example turbo.json nx.json pyproject.toml requirements.txt \
+         go.mod pom.xml build.gradle Makefile; do
+  if [ -f "${PROJECT_ROOT}/${f}" ]; then
+    CONFIG_FILES="${CONFIG_FILES}\"${f}\","
+  fi
+done
+CONFIG_FILES="[${CONFIG_FILES%,}]"
+
+# ─────────────────────────────────────────
+# 5. OpenAPI / Swagger 감지
+# ─────────────────────────────────────────
+OPENAPI="none"
+for f in openapi.json openapi.yaml swagger.json swagger.yaml api-spec.json api-spec.yaml; do
+  if [ -f "${PROJECT_ROOT}/${f}" ] || [ -f "${PROJECT_ROOT}/docs/${f}" ]; then
+    OPENAPI="${f}"
+    break
+  fi
+done
+
+# NestJS Swagger 모듈 감지
+if grep -rq "@nestjs/swagger" "${PROJECT_ROOT}/package.json" 2>/dev/null; then
+  if [ "$OPENAPI" = "none" ]; then
+    OPENAPI="nestjs-swagger-module (runtime-generated)"
+  fi
+fi
+
+# ─────────────────────────────────────────
+# 6. Git 정보
+# ─────────────────────────────────────────
+GIT_INIT=false
+GIT_COMMITS=0
+GIT_BRANCH="none"
+if [ -d "${PROJECT_ROOT}/.git" ]; then
+  GIT_INIT=true
+  GIT_COMMITS=$(git -C "${PROJECT_ROOT}" rev-list --count HEAD 2>/dev/null || echo 0)
+  GIT_BRANCH=$(git -C "${PROJECT_ROOT}" branch --show-current 2>/dev/null || echo "unknown")
+fi
+
+# ─────────────────────────────────────────
+# 7. 하네스 기존 상태
+# ─────────────────────────────────────────
+HARNESS_EXISTS=false
+HARNESS_VERSION="none"
+if [ -f "${PROJECT_ROOT}/.harness/config.json" ]; then
+  HARNESS_EXISTS=true
+  HARNESS_VERSION=$(grep '"version"' "${PROJECT_ROOT}/.harness/config.json" 2>/dev/null | head -1 | sed 's/.*: *"\(.*\)".*/\1/')
+fi
+
+# ─────────────────────────────────────────
+# 8. JSON 출력
+# ─────────────────────────────────────────
+
+# 디렉토리 트리를 JSON 배열로 변환
+TREE_JSON=$(echo "$TREE" | awk 'BEGIN{printf "["} NR>1{printf ","} {printf "\"%s\"", $0} END{printf "]"}')
+
+# 기존 CLAUDE.md 내용 (JSON escape)
+EXISTING_RULES_JSON=$(echo "$EXISTING_RULES" | python3 -c "import sys,json; print(json.dumps(sys.stdin.read()))" 2>/dev/null || echo '""')
+
+cat > "$OUTPUT" << JSONEOF
+{
+  "scanned_at": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
+  "project_root": "${PROJECT_ROOT}",
+
+  "existing_docs": {
+    "agents_md": "${AGENTS_MD}",
+    "claude_md": "${CLAUDE_MD}",
+    "claude_md_is_symlink": ${CLAUDE_MD_IS_SYMLINK},
+    "existing_claude_md_content": ${EXISTING_RULES_JSON}
+  },
+
+  "tech_stack": {
+    "backend": "${TECH_BACKEND}",
+    "frontend": "${TECH_FRONTEND}",
+    "fe_stack": "${FE_STACK}",
+    "fe_target": "${FE_TARGET}",
+    "database": "${TECH_DB}",
+    "monorepo": "${TECH_MONOREPO}",
+    "language": "${TECH_LANG}",
+    "is_native_app": ${IS_NATIVE_APP}
+  },
+
+  "tech_stack_confidence": "$(
+    if [ "$TECH_BACKEND" = "unknown" ] && [ "$TECH_FRONTEND" = "unknown" ]; then
+      echo "unknown"
+    else
+      echo "detected"
+    fi
+  )",
+
+  "structure": {
+    "directories": ${TREE_JSON},
+    "config_files": ${CONFIG_FILES}
+  },
+
+  "api": {
+    "openapi_spec": "${OPENAPI}"
+  },
+
+  "git": {
+    "initialized": ${GIT_INIT},
+    "commits": ${GIT_COMMITS},
+    "branch": "${GIT_BRANCH}"
+  },
+
+  "harness": {
+    "exists": ${HARNESS_EXISTS},
+    "version": "${HARNESS_VERSION}"
+  },
+
+  "recommendation": {
+    "project_type": "$(
+      if [ "$TECH_BACKEND" != "unknown" ] && [ "$TECH_FRONTEND" != "unknown" ]; then
+        echo "fullstack"
+      elif [ "$TECH_BACKEND" != "unknown" ]; then
+        echo "backend-only"
+      elif [ "$TECH_FRONTEND" != "unknown" ]; then
+        echo "frontend-only"
+      else
+        echo "empty"
+      fi
+    )",
+    "agents_md_action": "$(
+      if [ "$AGENTS_MD" = "none" ] && [ "$CLAUDE_MD" = "none" ]; then
+        echo "create-new"
+      elif [ "$AGENTS_MD" = "none" ] && [ "$CLAUDE_MD" = "exists" ]; then
+        echo "migrate-claude-to-agents"
+      elif [ "$AGENTS_MD" = "exists" ]; then
+        echo "rebuild-with-harness"
+      else
+        echo "create-new"
+      fi
+    )"
+  }
+}
+JSONEOF
+
+echo ""
+echo "=== Scan Complete ==="
+echo "Output: ${OUTPUT}"
+echo ""
+echo "--- Summary ---"
+echo "Tech Stack: ${TECH_BACKEND} / ${TECH_FRONTEND} (fe_stack=${FE_STACK}, fe_target=${FE_TARGET}, native=${IS_NATIVE_APP}) / ${TECH_DB}"
+echo "Monorepo: ${TECH_MONOREPO}"
+echo "OpenAPI: ${OPENAPI}"
+echo "Git: ${GIT_INIT} (${GIT_COMMITS} commits, branch: ${GIT_BRANCH})"
+echo "Existing Docs: AGENTS.md=${AGENTS_MD}, CLAUDE.md=${CLAUDE_MD}"
+echo "Harness: ${HARNESS_EXISTS} (v${HARNESS_VERSION})"
+echo "Recommendation: $(cat "$OUTPUT" | python3 -c "import sys,json; d=json.load(sys.stdin); print(f\"type={d['recommendation']['project_type']}, agents_md={d['recommendation']['agents_md_action']}\")" 2>/dev/null)"

package/skills/brainstorming/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: harness-brainstorming
 description: "사용자의 러프한(바이브코딩) 요구사항을 대화형으로 구체화하여 Planner가 바로 쓸 수 있는 디자인/스펙 문서(.harness/actions/brainstorm-spec.md)로 만든다. Dispatcher가 사용자에게 '브레인스토밍 필요?' 라고 확인한 뒤에만 호출된다. 원본: obra/superpowers MIT."
-disable-model-invocation: true
+disable-model-invocation: false
 ---
 
 # Brainstormer — 요구사항 구체화 (obra/superpowers 파생)
@@ -52,9 +52,9 @@ jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/p
 ## Session Boundary Protocol
 
 ### On Start
-1. `.harness/progress.json` 읽기 — `next_agent == "brainstormer"` 인지 확인
+1. `.harness/progress.json` 읽기 — `next_agent == "brainstorming"` 인지 확인
    - 아니면 즉시 STOP + "Dispatcher 를 먼저 실행하세요" 안내
-2. progress.json 업데이트: `current_agent` → `"brainstormer"`, `agent_status` → `"running"`, `updated_at` 갱신
+2. progress.json 업데이트: `current_agent` → `"brainstorming"`, `agent_status` → `"running"`, `updated_at` 갱신
 3. `.harness/memory.md` 읽기 — **프로젝트 공유 학습 규칙 적용**
 4. **Skip 조건 검사**: `.harness/actions/brainstorm-spec.md` 가 이미 존재하고
    사용자가 "새로 브레인스토밍" 을 명시하지 않았다면:
@@ -66,7 +66,7 @@ jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/p
 1. `.harness/actions/brainstorm-spec.md` 가 존재하고 "User Review Gate" 를 통과했는지 확인
 2. progress.json 업데이트:
    - `agent_status` → `"completed"`
-   - `completed_agents` 에 `"brainstormer"` 추가
+   - `completed_agents` 에 `"brainstorming"` 추가
    - `next_agent` → `"planner"`
 3. `.harness/progress.log` 에 요약 추가: `Brainstormer → Planner (spec: <경로>)`
 4. 출력: `"✓ Brainstormer 완료. brainstorm-spec.md 검토 후 승인 신호를 주세요. 승인 시 자동 핸드오프 (Conductor 자율 시동) (Planner)."`

package/skills/conductor/SKILL.md

@@ -136,16 +136,23 @@ idle ─► running ─► (waiting_meeting | waiting_owner | running) ─► co
 
 ```
 [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}
+[generator pending in feature row] → spawn generator-backend | generator-frontend | generator-designer | generator-devops
+[generator done, eval pending]     → spawn evaluator-code-quality | evaluator-functional | evaluator-visual | evaluator-architecture | evaluator-security
 [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)
-[generator-* / eval-functional spawn 직전] → 동시 spawn service-ops/monitor (stream-mode, G-006)
+[Service-Ops cron due]             → spawn service-ops (requested_mode=monitor)
+[ops-report ready]                 → handoff to CTO (spawn cto)
+[planner requested_mode=hypothesis]→ spawn coo-developer and/or documentationer
+[generator-* / eval-functional spawn 직전] → 동시 spawn service-ops (requested_mode=monitor, stream-mode, G-006)
 [mode=team & ready ≥ 2]            → 동시 spawn min(ready,3) generator/evaluator (G-005)
 ```
 
+`planner.requested_mode == "hypothesis"` 인 경우 Conductor 는 정규 Generator/Evaluator 체인보다 COO 직속 셀을 우선한다:
+
+- 리서치·정리 중심 → `documentationer`
+- 빠른 실험·백데이터 코드 중심 → `coo-developer`
+- 둘 다 필요 → 같은 tick 에 2명 병렬 spawn 가능
+
 ### 5.1 Team mode 병렬 spawn (G-005)
 
 `progress.json.mode == "team"` 이면 매 tick 시작 시 ready 목록을 계산하여 **동시 다발 spawn**:
@@ -161,11 +168,12 @@ slots=$(( ready_count < 3 ? ready_count : 3 ))
 
 ### 5.2 Service-Ops monitor 동반 spawn (G-006)
 
-generator-{backend,frontend,frontend-flutter,devops} 또는 evaluator-functional* 을 spawn 하기 직전, **동일 tick 에서** service-ops/monitor 를 stream-mode 로 함께 spawn:
+generator-backend / generator-frontend / generator-devops 또는 evaluator-functional 을 spawn 하기 직전, **동일 tick 에서** `service-ops` 를 `requested_mode=monitor` 로 함께 spawn:
 
 ```bash
 bash scripts/harness-progress-set.sh . \
-  '.service_ops.monitor.stream_active = true |
+  '.service_ops.requested_mode = "monitor" |
+   .service_ops.monitor.stream_active = true |
    .service_ops.monitor.stream_target = "generator-frontend" |
    .agents += [{"id":"service-ops","room":"service-ops","minifigState":"watching"}]'
 ```
@@ -200,7 +208,7 @@ bash scripts/harness-progress-set.sh . \
 
 ## 7.5 모드 결정 (v6.0+, 사용자에서 이양)
 
-이전에는 사용자가 `/harness-solo` 또는 `/harness-team` 으로 직접 선택했다. v6.0 부터 **Conductor 가 sprint 시작 시점에 자동 결정**한다. 사용자 override 는 가능하지만 디폴트는 자동.
+이전에는 사용자가 `/harness-solo` 또는 `/harness-team` 으로 직접 선택했다. v6.0 부터 **Conductor 가 sprint 시작 시점에 자동 결정**하며, 정상 경로는 회사형 team/company 루프다. `solo` 는 사용자 명시 시에만 들어가는 비상용 fallback 이다.
 
 ### 7.5.1 결정 시점
 
@@ -216,12 +224,7 @@ ready_at_start ≥ 3
 feature_count ≥ 6
 critical_path_depth ≤ 2
 
-# Solo 강제 조건 (어느 하나라도)
-ready_at_start ≤ 2
-또는 feature_count ≤ 3
-또는 critical_path_depth ≥ 4
-
-# 동률 → solo (비용 안전)
+# Solo 관련 threshold 는 문서상 fallback 참고치일 뿐, auto 기본 경로는 team 유지
 ```
 
 `critical_path_depth` = feature 의존성 그래프에서 가장 긴 체인의 길이. `feature-list.json` 의 `depends_on` 으로 계산.
@@ -230,7 +233,7 @@ ready_at_start ≤ 2
 
 1. 결정 후 `progress.json` partial update:
    ```json
-   "mode": "solo" 또는 "team",
+  "mode": "team" 기본, 필요 시 "solo",
    "mode_decision": {
      "owner": "conductor",
      "decided_at": "<iso>",
@@ -247,7 +250,7 @@ ready_at_start ≤ 2
 
 | 발화/명령 | 효과 |
 |---|---|
-| `/harness-solo` 또는 "solo 로" | mode=solo 강제, mode_decision.user_override="solo" |
+| `/harness-solo` 또는 "solo 로" | mode=solo 강제, mode_decision.user_override="solo" (비상용 fallback) |
 | `/harness-team` 또는 "team 으로" | mode=team 강제, user_override="team" |
 | "auto 다시" / "Conductor 결정으로" | user_override=null, 다음 sprint 시작 시 재자동결정 |
 

package/skills/coo-developer/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: harness-coo-developer
+description: "COO 직속 가설검증 개발자. 빠른 spike, 백데이터 활용 실험, throwaway prototype 을 통해 가설을 사실로 검증한다. 아키텍처·코드퀄리티·테스트 완결성보다 속도와 의사결정용 evidence를 우선한다. 트리거: '가설 검증 개발', 'spike', 'backdata experiment'."
+disable-model-invocation: false
+---
+
+# COO Developer
+
+> 목적은 운영용 코드를 만드는 것이 아니라, COO가 다음 결정을 내릴 수 있게 충분한 사실을 빠르게 확보하는 것이다.
+
+## 1. 책임
+
+- 가설을 검증하기 위한 최소 코드 작성
+- 백데이터/로그/덤프를 활용한 검증 스크립트 작성
+- 프로덕션 품질보다 속도 우선의 throwaway prototype 제작
+- 결과와 한계를 `documentationer` 또는 Planner에 넘길 수 있는 형태로 정리
+
+## 2. 입력
+
+- CEO 또는 Service-Ops에서 전달된 가설/질문
+- Planner의 `requested_mode = "hypothesis"`
+- 기존 코드베이스, 로컬 데이터, 백데이터, 샘플 CSV/JSON/DB dump
+
+## 3. 출력
+
+- 실험 코드 또는 스크립트
+- 재현 절차
+- 관찰 결과와 한계
+- "가설 지지 / 반박 / 추가 데이터 필요" 3분류 결론
+
+## 4. 작업 원칙
+
+- 빠르게 버릴 수 있는 코드를 두려워하지 말 것
+- 운영 아키텍처에 맞추려다 속도를 잃지 말 것
+- 단, 데이터 훼손이나 destructive action은 금지
+- 결과가 정규화 가치가 있으면 Planner에게 Sprint artifact 승격을 요청
+
+## 5. 금지
+
+- 실험 결과만으로 운영 가능 판정
+- 정규 팀 평가 없이 배포 코드로 승격
+- 근거 없는 직감성 결론

package/skills/cqo/SKILL.md

@@ -90,6 +90,13 @@ CQO는 다음 짝의 평가가 일치하는지 확인:
 docmeta: { ... }
 cqo_audit:
   sprint: <n>
+  decision:
+    owner: cqo
+    action_type: re-evaluate | reject
+    rationale: <why CQO passed or rejected the build>
+    evidence:
+      - source: <artifact path>
+        kind: evaluation | regression | security | architecture
   per_axis_scores:
     functional: 2.85
     visual: 2.92

package/skills/cto/SKILL.md

@@ -93,6 +93,13 @@ CTO 판단 옵션:
 docmeta: { ... }
 cto_review:
   sprint: <n>
+  decision:
+    owner: cto
+    action_type: implement | replan
+    rationale: <fact-based conclusion>
+    evidence:
+      - source: <artifact path>
+        kind: ops-report | meeting-record | cqo-audit
   goal_feasibility: feasible | feasible-with-recruit | infeasible
   recommended_recruits: [generator-designer, eval-security]
   arch_risks: [...]

package/skills/dispatcher/SKILL.md

@@ -53,9 +53,8 @@ jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/p
 1. progress.json 업데이트:
    - `agent_status` → `"completed"`
    - `completed_agents`에 `"dispatcher"` 추가
-   - `next_agent` → **브레인스토밍 결정 트리에 따라 결정** ([섹션 6](#6-brainstormer-routing-decision) 참조)
-     - 신규/재플래닝 + 사용자가 브레인스토밍 선택 → `"brainstorming"`
-     - 신규/재플래닝 + 사용자가 건너뛰기 선택 → `"planner"`
+   - `next_agent` → **기본은 `"meeting-manager"`**. CEO가 먼저 Cxx 회의를 소집하고, Conductor가 그 결과로 `planner(COO)` / `cto` / `cqo` / `service-ops` 를 분배한다.
+     - 신규/재플래닝/Goal 재정렬 → `"meeting-manager"`
      - 특정 에이전트 직접 명령 → 해당 에이전트 (예: `"evaluator-functional"`)
      - Gotcha 교정 후 재작업 → `failure.retry_target` (해당 에이전트)
    - `pipeline` → 선택된 파이프라인 (FULLSTACK/FE-ONLY/BE-ONLY)
@@ -74,7 +73,7 @@ jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/p
      아카이빙 후 `dispatch.id` 는 `null` 로 리셋되므로, 다음 dispatcher 실행 시 새 D-NNN 이 할당된다.
 2. `.harness/progress.log`에 요약 한 줄 추가
 3. 출력: `"✓ Dispatcher 완료. 자동 핸드오프 (Conductor 자율 시동)."`
-4. **즉시 내부 핸드오프 (scripts/harness-next.sh) 를 호출하여 다음 에이전트로 자동 핸드오프** (Solo 모드. Team 모드는 Lead가 별도 오케스트레이션). Brainstorming/Planner 단계가 아니면 사용자 승인 게이트 없음.
+4. **즉시 내부 핸드오프 (scripts/harness-next.sh) 를 호출하여 다음 에이전트로 자동 핸드오프**. 기본 경로는 `meeting-manager -> planner(COO) -> cto -> gen/eval -> cqo -> service-ops -> meeting-manager`.
 
 ## Auto-Routing (UserPromptSubmit Hook)
 
@@ -223,40 +222,30 @@ Dispatcher 는 사용자 요청을 분류한 뒤 아래 순서로 판단:
 ```
 1. Gotcha / 실수 지적인가?
    → YES: gotcha 기록 → next_agent = failure.retry_target (해당 에이전트)
-         (브레인스토밍 없음)
+         (회의 소집 없이 재작업)
 
 2. 특정 에이전트 직접 명령인가?
    ("evaluator 다시 돌려", "generator-frontend 재작업", "planner plan.md 고쳐" 등)
-   → YES: next_agent = <대상 에이전트> (브레인스토밍 없음)
+   → YES: next_agent = <대상 에이전트> (CEO 회의 우회)
 
-3. Planner 가 동작해야 하는 케이스인가?
-   (신규 파이프라인 / 신규 PRD / 기존 plan.md 대폭 수정 / 신규 feature 대규모 추가)
-   → YES: 사용자에게 확인 질문 → 6.2 "브레인스토밍 확인 플로우"
-   → NO:  다른 에이전트로 라우팅 (generator 이어서 등)
+3. 신규 GOAL / 재플래닝 / Goal drift / 운영 이슈인가?
+   → YES: next_agent = meeting-manager
+         (CEO가 COO/CTO/CQO/Service-Ops 회의를 먼저 소집)
 
-4. 그 외 (메타/인사/Claude 자체 질문) → Dispatcher skip
-```
-
-### 6.2 브레인스토밍 확인 플로우
-
-Planner 를 호출해야 한다고 판단되면, **사용자에게 단 하나의 질문을 출력한 뒤 대기한다:**
+4. Brainstorming 이 필요한가?
+   → YES: Brainstorming 은 기본 진입점이 아니라 COO/Planner 내부 판단 또는
+         명시적 요청일 때만 사용
 
+5. 그 외 (메타/인사/Claude 자체 질문) → Dispatcher skip
 ```
-이 요청은 Planner 가 처리할 신규/재플래닝 건으로 보입니다.
-러프한 요구사항을 먼저 구체화하는 Brainstormer 과정을 거칠까요?
 
-  (Y) 예 — Brainstormer 와 대화하며 요구사항을 fit 하게 만든 뒤 Planner
-  (N) 아니오 — 이미 PRD/OpenAPI 가 명확하므로 바로 Planner
+### 6.2 브레인스토밍 확인 플로우
 
-답변: Y / N
-```
+브레인스토밍은 더 이상 Dispatcher의 기본 확인 질문이 아니다.
 
-사용자 응답 처리:
-- **Y (긍정)** — "네", "y", "yes", "필요해", "해줘" 등
-  → `next_agent = "brainstorming"`
-- **N (부정)** — "아니오", "n", "no", "필요없어", "바로", "skip" 등
-  → `next_agent = "planner"`
-- **불명확 / 무응답** — 한 번 더 "Y 또는 N 으로 답해주세요" 요청
+- 기본값: `meeting-manager` 로 넘겨 CEO 회의 후 `planner(COO)` 가 브레인스토밍/웹리서치 필요 여부를 판단
+- 예외: Owner가 명시적으로 "`/harness-brainstorming`", "브레인스토밍부터"를 요청한 경우에만 직접 `brainstorming`
+- 금지: Planner 진입 전에 Brainstorming 여부를 사용자 승인 게이트로 되돌리는 것
 
 ### 6.3 Skip 케이스 정리
 

package/skills/dispatcher/persona-ceo.md

@@ -83,6 +83,7 @@ Source: https://github.com/msitarzewski/agency-agents (MIT)
 | Enterprise Feature | "기존 시스템", "엔터프라이즈", "통합" | + Eval-Arch·Eval-Security·Service-Ops |
 | Marketing/Content | "랜딩", "캠페인", "콘텐츠" | Designer·Marketing(옵트인)·Eval-Visual |
 | Incident Response | "장애", "다운", "긴급", "롤백" | Incident-Responder·Service-Ops·관련 Gen |
+| Hypothesis Validation | "가설", "리서치", "실험", "백데이터", "빠르게 검증" | Planner·coo-developer·documentationer·Service-Ops(옵트인) |
 
 매칭 실패 시 → "추가 정보가 필요합니다" 1회 질문 → 그래도 모호하면 **Startup MVP** 기본값.
 
@@ -96,7 +97,7 @@ Source: https://github.com/msitarzewski/agency-agents (MIT)
   "runbook": "startup-mvp",
   "departments": {
     "must":  ["planner","cto","cqo","conductor","meeting-manager","generator-backend","generator-frontend","generator-designer","evaluator-functional","evaluator-visual","evaluator-code-quality","generator-devops"],
-    "should":["evaluator-architecture","service-ops"],
+    "should":["evaluator-architecture","service-ops","coo-developer","documentationer"],
     "may":   ["evaluator-security","marketing","sales"],
     "off":   ["finance","legal-compliance","spatial-computing"]
   },