@walwal-harness/cli 6.1.0 → 6.1.1

package/CHANGELOG.md

@@ -29,6 +29,29 @@ docmeta:
 
 # Changelog
 
+## 6.1.1 — COO hypothesis routing activation (2026-05-08)
+
+### Why
+v6.1.0 에서 COO 직속 `coo-developer` / `documentationer` 역할과 hypothesis cell 문서는 추가됐지만, 실제 Conductor 라우팅은 여전히 `planner -> cto` 직행이었다. 그래서 "COO가 가설을 세우면 빠르게 리서치·실험·판정한다" 는 운용 모델이 문서상으로만 존재했다.
+
+### Changes
+- **runtime routing for hypothesis mode**
+  - `planner.requested_mode = "hypothesis"` 이면 `documentationer` 로 우선 라우팅
+  - 이후 `documentationer -> coo-developer -> documentationer -> planner` 순서로 가설 검증 루프 진행
+  - 단계 추적용 상태를 `planner.last_brief` 에 `hypothesis:research`, `hypothesis:experiment`, `hypothesis:report`, `hypothesis:done` 으로 기록
+- **agent registry update**
+  - `.harness/config.json` 의 `agents` 카탈로그에 `coo-developer`, `documentationer` 등록
+  - handoff/statusline/session-start 가 두 agent 를 정상 인식하도록 연결
+
+### Validation
+- `bash -n scripts/conductor-tick.sh`
+- `jq empty .harness/config.json`
+- `/private/tmp` 샌드박스에서 hypothesis flow 시뮬레이션:
+  - `planner(completed, requested_mode=hypothesis) -> documentationer`
+  - `documentationer -> coo-developer`
+  - `coo-developer -> documentationer`
+  - `documentationer -> planner(requested_mode=hypothesis-verdict)`
+
 ## 6.1.0 — document-driven company loop + task-session isolation (2026-05-08)
 
 ### Why

package/gotchas/coo-developer.md

@@ -0,0 +1,13 @@
+# Gotchas — COO Developer
+
+### [G-001] 운영코드와 실험코드 혼동  <!-- rule_id: coo-developer-experiment-vs-production -->
+- **Status**: unverified
+- **Date**: 2026-05-08
+- **Source**: planner:manual
+- **Trigger**: COO 직속 가설검증 셀 신설
+- **Wrong**: spike 코드를 운영 경로의 정본처럼 다룸
+- **Right**: 실험 코드는 실험으로 남기고, 정규화가 필요하면 Planner가 다시 Sprint artifact로 승격
+- **Why**: 이 셀의 목적은 빠른 사실 확인이지 운영 품질 보장이 아니다
+- **Scope**: `coo-developer`의 모든 실험 작업
+- **Occurrences**: 1
+- **Last-Seen**: 2026-05-08

package/gotchas/documentationer.md

@@ -0,0 +1,13 @@
+# Gotchas — Documentationer
+
+### [G-001] 보고서가 근거를 앞서감  <!-- rule_id: documentationer-claim-without-evidence -->
+- **Status**: unverified
+- **Date**: 2026-05-08
+- **Source**: planner:manual
+- **Trigger**: COO 직속 가설검증 셀 신설
+- **Wrong**: 리서치나 실험 근거보다 해석을 먼저 확정함
+- **Right**: evidence를 명시하고, 판정은 유효/무효/보류 중 하나로 제한
+- **Why**: Documentationer의 산출물은 COO 의사결정의 입력이며, 환상적 확신을 만들면 안 된다
+- **Scope**: `documentationer`의 모든 보고서와 브리프
+- **Occurrences**: 1
+- **Last-Seen**: 2026-05-08

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "6.1.0",
+  "version": "6.1.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"

package/scripts/conductor-tick.sh

@@ -25,6 +25,8 @@ pipeline=$(jq -r '.pipeline // "null"' "$PROGRESS")
 mode=$(jq -r '.mode // "auto"' "$PROGRESS")
 user_override=$(jq -r '.mode_decision.user_override // "null"' "$PROGRESS")
 requested_mode=$(jq -r '.service_ops.requested_mode // "null"' "$PROGRESS")
+planner_requested_mode=$(jq -r '.planner.requested_mode // "null"' "$PROGRESS")
+planner_last_brief=$(jq -r '.planner.last_brief // "null"' "$PROGRESS")
 goal_adherence=$(jq -r '.goals.current_adherence // "null"' "$PROGRESS")
 meetings_active_count=$(jq -r '(.meetings.active | length) // 0' "$PROGRESS")
 cqo_verdict=$(jq -r '.cqo.sprint_verdict // "pending"' "$PROGRESS")
@@ -258,12 +260,44 @@ elif [ "$current_agent" = "meeting-manager" ] && [ "$agent_status" = "completed"
     }"
 
 elif [ "$current_agent" = "planner" ] && [ "$agent_status" = "completed" ]; then
-  next="cto"
-  action="handoff:cto:plan-ready"
-  new_workflow_stage="cto-review"
-  planner_filter='
-    .planner.last_brief = (.planner.requested_mode // "goal-alignment") |
-    .planner.requested_mode = null'
+  if [ "$planner_requested_mode" = "hypothesis" ]; then
+    next="documentationer"
+    action="dispatch:hypothesis:documentationer"
+    new_workflow_stage="coo-hypothesis-research"
+    planner_filter='
+      .planner.last_brief = "hypothesis:research" |
+      .planner.requested_mode = null'
+  else
+    next="cto"
+    action="handoff:cto:plan-ready"
+    new_workflow_stage="cto-review"
+    planner_filter='
+      .planner.last_brief = (.planner.requested_mode // "goal-alignment") |
+      .planner.requested_mode = null'
+  fi
+
+elif [ "$current_agent" = "documentationer" ] && [ "$agent_status" = "completed" ]; then
+  if [ "$planner_last_brief" = "hypothesis:research" ]; then
+    next="coo-developer"
+    action="dispatch:hypothesis:experiment"
+    new_workflow_stage="coo-hypothesis-experiment"
+    planner_filter='.planner.last_brief = "hypothesis:experiment"'
+  elif [ "$planner_last_brief" = "hypothesis:report" ]; then
+    next="planner"
+    action="dispatch:planner:hypothesis-verdict"
+    new_workflow_stage="coo-hypothesis-verdict"
+    planner_filter='
+      .planner.last_brief = "hypothesis:done" |
+      .planner.requested_mode = "hypothesis-verdict"'
+  fi
+
+elif [ "$current_agent" = "coo-developer" ] && [ "$agent_status" = "completed" ]; then
+  if [ "$planner_last_brief" = "hypothesis:experiment" ]; then
+    next="documentationer"
+    action="dispatch:hypothesis:report"
+    new_workflow_stage="coo-hypothesis-report"
+    planner_filter='.planner.last_brief = "hypothesis:report"'
+  fi
 
 elif [ "$current_agent" = "cto" ]; then
   if [ "${cto_hotfixes:-0}" -gt 0 ] || [ "${ops_recommendations:-0}" -gt 0 ]; then

package/skills/conductor/SKILL.md

@@ -142,10 +142,17 @@ idle ─► running ─► (waiting_meeting | waiting_owner | running) ─► co
 [all features PASS]                → Phase Gate Meeting
 [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**:

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/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"]
   },

package/skills/documentationer/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: harness-documentationer
+description: "COO 직속 Documentationer. 웹 리서치, 실험 로그 정리, 보고서 작성, 가설 유효/무효 판정을 담당한다. 운영 문서보다는 의사결정 문서에 초점을 둔다. 트리거: 'report', 'documentation', 'research brief', 'hypothesis verdict'."
+disable-model-invocation: false
+---
+
+# Documentationer
+
+> 리서치와 실험을 문장으로 묶어 COO가 즉시 판단할 수 있는 보고서로 바꾼다.
+
+## 1. 책임
+
+- 웹 리서치 기반 가설 보강
+- `coo-developer` 실험 결과 정리
+- 가설 검증 보고서 작성
+- 가설의 유효/무효/보류 판정 및 근거 명시
+
+## 2. 입력
+
+- Planner의 가설 브리프
+- Service-Ops의 드리프트 신호 또는 신규 기획 방향
+- `coo-developer`의 실험 결과
+- 필요 시 외부 리서치 소스
+
+## 3. 출력
+
+- `hypothesis-brief`
+- `validation-report`
+- `evidence-summary`
+- 다음 액션 제안:
+  - 정규 Sprint로 승격
+  - 추가 실험 필요
+  - 폐기
+
+## 4. 보고서 규칙
+
+- 결론 먼저, 근거 다음
+- 주장마다 evidence 출처 명시
+- 운영팀/CTO/CQO가 바로 이어받을 수 있게 열린 질문을 분리
+- "왜 아직 확실하지 않은가"도 반드시 적을 것
+
+## 5. 금지
+
+- evidence 없는 유효 판정
+- CTO/CQO 검증을 대신했다고 표현
+- 실험 로그를 정제 없이 그대로 보고서로 제출

package/skills/meeting-manager/SKILL.md

@@ -152,6 +152,7 @@ Meeting-Manager는 단순히 "토론해 주세요"라고 말하지 않는다.
 
 - `Dispatcher/CEO`: Goal 자체가 흔들렸는가, Owner escalation 이 필요한가
 - `Planner/COO`: 기획/가설/웹리서치/레퍼런스 재검토가 필요한가
+- `COO Hypothesis Cell`: 실험으로 바로 검증 가능한가, 어떤 백데이터/리서치가 필요한가
 - `CTO`: 구현/아키텍처/기술선택 문제가 원인인가
 - `CQO`: 품질/회귀/검증 부족이 원인인가
 - `Service-Ops`: KPI/로그/incident 기준으로 어떤 drift 가 발생했는가

package/skills/planner/persona-coo-hr.md

@@ -140,6 +140,23 @@ hr_roster:
 ---
 ```
 
+### B-5. COO Direct Hypothesis Cell
+
+Planner는 정규 Sprint 라인과 별도로 다음 2개 직속 역할을 운영할 수 있다:
+
+- `coo-developer`: 빠른 spike, 백데이터 스크립트, throwaway prototype
+- `documentationer`: 웹 리서치, 실험 로그 정리, 보고서, 가설 유효/무효 판정
+
+활성화 조건:
+1. CEO가 기획안 탐색 또는 미검증 아이디어 검토를 지시
+2. Service-Ops가 새 기획 방향 또는 drift 신호를 보고
+3. CTO/CQO 정규 라인에 넣기 전에 빠른 사실 확인이 필요
+
+운영 원칙:
+- 산출물은 정규 구현물이 아니라 `hypothesis brief`, `experiment note`, `validation report`
+- 코드 품질/테스트 완성도보다 의사결정 속도를 우선
+- 결과가 유효하면 Planner가 이를 정규 Sprint artifact로 재작성해 CTO 라인에 넘긴다
+
 ## C. 권한 (보강)
 
 기존 권한에 추가: