@walwal-harness/cli 6.1.1 → 6.1.3

package/assets/templates/config.json

@@ -342,6 +342,13 @@
     "auto_route_dispatcher": true,
     "auto_route_dispatcher_description": "true 이면 사용자의 모든 프롬프트가 harness-dispatcher 경유로 분류/라우팅 된다. 사용자가 'harness skip' 등을 말하면 단일 메시지 한정으로 건너뛴다."
   },
+  "token_limit": {
+    "comment": "모델 토큰 제한으로 작업이 중단됐을 때의 저비용 재개 정책. 별도 probe 호출 없이 시간 기반으로만 재개 알림을 계산한다.",
+    "stop_reason_flag": "TokenLimit",
+    "retry_after_seconds": 3600,
+    "re_notify_every_seconds": 3600,
+    "owner": "session-start"
+  },
   "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",

package/assets/templates/progress.json.template

@@ -28,6 +28,19 @@
     "message": null,
     "retry_target": null
   },
+  "task_stop": {
+    "active": false,
+    "reason": null,
+    "stopped_at": null,
+    "resume_after": null,
+    "resume_ready": false,
+    "resume_notified_at": null,
+    "wake_target": null,
+    "stopped_agent": null,
+    "stopped_next_agent": null,
+    "task_session_path": null,
+    "hold_count": 0
+  },
   "artifacts": {
     "plan.md": { "status": "pending", "updated_by": null, "updated_at": null },
     "feature-list.json": { "status": "pending", "updated_by": null, "updated_at": null },

package/gotchas/README.md

@@ -8,12 +8,31 @@
 
 ```
 .harness/gotchas/
-├── README.md                      # 이 파일
-├── planner.md                     # Planner의 반복 실수
-├── generator-backend.md           # Generator-Backend의 반복 실수
-├── generator-frontend.md          # Generator-Frontend의 반복 실수
-├── evaluator-functional.md        # Evaluator-Functional의 반복 실수
-└── evaluator-visual.md            # Evaluator-Visual의 반복 실수
+├── README.md                      # 이 파일 (형식·관리 규칙)
+│
+├── conductor.md                   # Conductor (자율 실행 엔진)
+├── dispatcher.md                  # Dispatcher (CEO)
+├── meeting-manager.md             # Meeting-Manager (회의 사회)
+├── planner.md                     # Planner (COO + HR)
+├── cto.md                         # CTO (Gen 총괄)
+├── cqo.md                         # CQO (Eval 총괄)
+├── service-ops.md                 # Service-Ops (운용)
+│
+├── coo-developer.md               # COO Hypothesis Cell — Developer
+├── documentationer.md             # COO Hypothesis Cell — Documentationer
+│
+├── generator-backend.md           # Generator-Backend
+├── generator-frontend.md          # Generator-Frontend
+├── generator-designer.md          # Generator-Designer
+├── generator-devops.md            # Generator-DevOps
+│
+├── evaluator-code-quality.md      # Eval-Code-Quality
+├── evaluator-functional.md        # Eval-Functional
+├── evaluator-visual.md            # Eval-Visual
+├── evaluator-architecture.md      # Eval-Architecture
+├── evaluator-security.md          # Eval-Security
+│
+└── generator-backend-<stack>.md   # 스택별 가드 (예: -laravel)
 ```
 
 ## 항목 형식
@@ -22,8 +41,8 @@
 ### [G-NNN] 간결한 제목  <!-- rule_id: <unique-key> -->
 - **Status**: unverified | verified | resolved
 - **Date**: YYYY-MM-DD
-- **Source**: <작성 주체>        (예: "evaluator-functional:F-003" / "dispatcher:manual")
-- **Trigger**: 사용자가 한 말 또는 "Eval 자동 감지"
+- **Source**: <작성 주체>        (예: "evaluator-functional:F-003" / "dispatcher:manual" / "meeting:M-...:track-2")
+- **Trigger**: 사용자가 한 말 또는 "Eval 자동 감지" 또는 "track abandon"
 - **Wrong**: 에이전트가 했던 잘못된 행동
 - **Right**: 올바른 행동
 - **Why**: 왜 잘못인지 근거
@@ -32,6 +51,19 @@
 - **Last-Seen**: YYYY-MM-DD
 ```
 
+### Source 필드 (v6.2 — parallel tracks 추적)
+
+`Source` 는 항목이 어디서 생겼는지 추적한다. 가능한 형식:
+
+| 형식 | 의미 |
+|---|---|
+| `dispatcher:manual` | 사용자가 명시적으로 지적 |
+| `evaluator-<axis>:F-<id>` | Evaluator 가 자동 감지한 사건 (gotcha_candidates) |
+| `service-ops:incident-<id>` | Service-Ops 인시던트에서 도출 |
+| `meeting:M-<id>:track-<n>` | parallel-tracks 회의의 특정 트랙에서 도출 (v6.2) |
+| `meeting:M-<id>:rendezvous` | followup-review 통합 결정에서 도출 |
+| `planner:manual` | Planner 가 sprint 전환 시 등록 |
+
 ## 작성 주체
 
 - **Dispatcher**: 사용자의 명시적 실수 지적을 Gotcha Flow 로 기록

package/gotchas/conductor.md

@@ -1,92 +1,22 @@
 ---
 docmeta:
   id: gotchas-conductor
-  title: Gotchas — Conductor (Autonomous Engine)
+  title: Gotchas — uconductor
   type: input
-  createdAt: 2026-05-07T00:00:00Z
-  updatedAt: 2026-05-07T00:00:00Z
+  createdAt: 2026-05-08T00:00:00Z
+  updatedAt: 2026-05-08T00:00:00Z
   source:
-    producer: agent
+    producer: user
     skillId: harness-dispatcher
-  inputs:
-    - documentId: user-feedback-v6.0.2
-      uri: (inline — Owner 의 "잘 워킹하고 있다는 느낌이 들지 않는다" 지적)
-      relation: output-from
-      sections:
-        - sourceRange: { startLine: 1, endLine: 1 }
-          targetRange: { startLine: 17, endLine: 60 }
-  tags: [gotchas, conductor, autonomy, visibility, ghost-spawn]
+  inputs: []
+  tags: [gotchas, conductor]
 ---
 
-# Gotchas — Conductor (자율 실행 엔진)
+# Gotchas — uconductor
 
-> Conductor 는 walwal-harness 의 손. Dispatcher (CEO) 가 GOAL 을 확정하면 손이 알아서 돌린다. 매 세션 시작 / 매 tick 시 이 파일을 읽고 같은 실수를 반복하지 않는다.
+> Dispatcher 가 관리. uconductor 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
+> 
+> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
+> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
 
-### [G-001] 정의되지 않은 부서를 inline 으로 처리하지 말 것 (M-001 의 Conductor 적용)
-- **Date**: 2026-05-07
-- **Status**: verified
-- **Trigger**: v6.0.2 install 환경에서 Conductor 가 `evaluator-uiux` (정의 X) 를 spawn 하려다 "별도 SKILL 이 없으므로 Conductor 가 직접 검증" 식으로 inline 처리. Owner 가 "잘 워킹하고 있다는 느낌이 들지 않는다" 보고.
-- **Wrong**: spawn 대상이 `.claude/skills/harness-<name>/SKILL.md` 에 없을 때 (a) Conductor 가 inline 검증으로 우회 (b) 사용자 모르게 fallback 으로 진행.
-- **Right**: spawn 직전 SKILL 존재 검사. 없으면 즉시 escalate:
-  ```bash
-  bash scripts/harness-progress-set.sh . \
-    '.failure = {"agent":"conductor","location":"spawn","message":"unknown agent: evaluator-uiux","retry_target":null} |
-     .next_agent = "dispatcher" |
-     .agent_status = "blocked"'
-  ```
-  Dispatcher 가 받아 Owner 에게 "정의되지 않은 부서 호출 시도. 표준 chain (code-quality/functional/visual) 또는 신규 SKILL 등록 필요" 보고.
-- **Why**: M-001 ("선언만 된 유령 스킬") 의 Conductor 차원 적용. inline 우회는 (a) 사용자 신뢰 깨짐 (b) audit 흔적 부재 (c) verify 명령으로 catch 불가능.
-- **Scope**: 모든 spawn 결정. Tick Loop §5 spawn 결정 트리.
-
-### [G-002] Spawn 핸드오프 시 회의실 활용 (visibility)
-- **Date**: 2026-05-07
-- **Status**: verified
-- **Trigger**: Owner 발화 "CQO/COO/회의실 등에 모이지도 않고…"
-- **Wrong**: spawn 핸드오프 시 progress.json 만 갱신하고 `meetings.active` 미사용. dashboard 에서 회의실이 텅 빔.
-- **Right**: 핸드오프 직전 from→to 짧은 회의를 시각화:
-  ```bash
-  # 핸드오프 시작
-  bash scripts/harness-progress-set.sh . \
-    '.meetings.active = ["dispatcher","planner"] | .meetings.cadence = "handoff"'
-  sleep 1.5  # 시각적으로 회의실에 잠깐 모임
-  # 실제 spawn
-  bash scripts/harness-progress-set.sh . \
-    '.meetings.active = [] | .current_agent = "planner" | .agent_status = "running"'
-  ```
-- **Why**: NEXUS 메타포 — 핸드오프 = 짧은 회의. dashboard 에서 회의실로 두 미니피규어 텔레포트 → 회사가 진짜 일한다는 신뢰.
-- **Scope**: 모든 inter-agent 핸드오프.
-
-### [G-003] Visibility Checklist 4 시점 누락 금지 (Inviolable)
-- **Date**: 2026-05-07
-- **Status**: verified
-- **Trigger**: G-002 의 일반화. Conductor 가 매 tick 마다 progress.json 의 4 시점 partial update 를 누락하면 dashboard 가 stale.
-- **Wrong**: Conductor 가 spawn → 검증 → 결과 처리 사이에 progress.json 갱신을 잊거나 일부만 함.
-- **Right**: 매 tick 의 4 시점에 의무 update (skills/conductor/SKILL.md §0.5 참조):
-  1. **tick 시작**: `current_agent="conductor"`, `agent_status="running"`, `conductor.last_tick`, `tick_count++`
-  2. **spawn 직전**: `meetings.active=[from,to]`, `meetings.cadence="handoff"` (1~2초)
-  3. **spawn 직후**: `meetings.active=[]`, `current_agent="<spawned>"`, `agent_status="running"`
-  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
-- **Trigger**: NEXUS P3 위반 패턴 재발 방지
-- **Wrong**: Conductor 가 Eval PASS 후 "다음 sprint 시작할까요?" 같은 질문을 Dispatcher 통해 전달.
-- **Right**: PASS → 다음 평가자 chain / sprint advance 자동. FAIL → retry_target 자동 라우팅. 3 회 연속 FAIL / 인시던트 / GOAL 위반 시에만 escalation.
-- **Scope**: Tick Loop §6 Escalation 트리거.
+<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/coo-developer.md

@@ -1,13 +1,22 @@
-# Gotchas — COO Developer
+---
+docmeta:
+  id: gotchas-coo-developer
+  title: Gotchas — ucoo-udeveloper
+  type: input
+  createdAt: 2026-05-08T00:00:00Z
+  updatedAt: 2026-05-08T00:00:00Z
+  source:
+    producer: user
+    skillId: harness-dispatcher
+  inputs: []
+  tags: [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
+# Gotchas — ucoo-udeveloper
+
+> Dispatcher 가 관리. ucoo-udeveloper 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
+> 
+> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
+> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
+
+<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/cqo.md

@@ -0,0 +1,22 @@
+---
+docmeta:
+  id: gotchas-cqo
+  title: Gotchas — ucqo
+  type: input
+  createdAt: 2026-05-08T00:00:00Z
+  updatedAt: 2026-05-08T00:00:00Z
+  source:
+    producer: user
+    skillId: harness-dispatcher
+  inputs: []
+  tags: [gotchas, cqo]
+---
+
+# Gotchas — ucqo
+
+> Dispatcher 가 관리. ucqo 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
+> 
+> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
+> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
+
+<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/cto.md

@@ -0,0 +1,22 @@
+---
+docmeta:
+  id: gotchas-cto
+  title: Gotchas — ucto
+  type: input
+  createdAt: 2026-05-08T00:00:00Z
+  updatedAt: 2026-05-08T00:00:00Z
+  source:
+    producer: user
+    skillId: harness-dispatcher
+  inputs: []
+  tags: [gotchas, cto]
+---
+
+# Gotchas — ucto
+
+> Dispatcher 가 관리. ucto 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
+> 
+> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
+> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
+
+<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/dispatcher.md

@@ -1,97 +1,22 @@
 ---
 docmeta:
   id: gotchas-dispatcher
-  title: Gotchas — Dispatcher (CEO)
+  title: Gotchas — udispatcher
   type: input
-  createdAt: 2026-05-07T00:00:00Z
-  updatedAt: 2026-05-07T00:00:00Z
+  createdAt: 2026-05-08T00:00:00Z
+  updatedAt: 2026-05-08T00:00:00Z
   source:
-    producer: agent
+    producer: user
     skillId: harness-dispatcher
-  inputs:
-    - documentId: user-feedback-v6.0.0
-      uri: (inline — Owner 의 정체성/자율 실행 룰 위반 지적)
-      relation: output-from
-      note: inline 입력으로 sourceRange 는 단일 1..1 placeholder. 각 [G-NNN] 항목이 별개 발화 사건.
-      sections:
-        - sourceRange: { startLine: 1, endLine: 1 }   # "왜 나를 CEO로 이해하지?" 발화
-          targetRange: { startLine: 17, endLine: 25 }  # [G-001] Identity confusion
-        - sourceRange: { startLine: 1, endLine: 1 }   # "왜 나에게 next를 물어볼까?" 발화
-          targetRange: { startLine: 27, endLine: 34 }  # [G-002] 자율 실행 위반
-        - sourceRange: { startLine: 1, endLine: 1 }   # G-002 의 명료화 boundary 추론
-          targetRange: { startLine: 36, endLine: 43 }  # [G-003] 명료화는 짧게
-        - sourceRange: { startLine: 1, endLine: 1 }   # AGENTS.md 단일 대화 창구 룰 (관련 docref)
-          targetRange: { startLine: 45, endLine: 52 }  # [G-004] 직접 라우팅 금지
-    - documentId: AGENTS-md-template
-      uri: ../assets/templates/AGENTS.md.template
-      relation: output-from
-      note: 단일 대화 창구 룰 (Owner ↔ Dispatcher) 의 권위 출처.
-      sections:
-        - sourceRange: { startLine: 1, endLine: 1 }
-          targetRange: { startLine: 45, endLine: 52 }
-  tags: [gotchas, dispatcher, ceo, identity, autonomy]
+  inputs: []
+  tags: [gotchas, dispatcher]
 ---
 
-# Gotchas — Dispatcher (CEO)
+# Gotchas — udispatcher
 
-> Dispatcher 는 walwal-harness 의 CEO. **Owner(사용자)와 회사 사이의 유일한 대화 창구**입니다. 매 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
+> Dispatcher 가 관리. udispatcher 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
+> 
+> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
+> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
 
-### [G-001] 정체성 혼선 — 사용자를 CEO 로 다루지 말 것
-- **Date**: 2026-05-07
-- **Status**: verified
-- **Trigger**: 사용자 발화 "왜 나를 CEO로 이해하지? 내가 CEO에게 이야기 하는것인데?"
-- **Wrong**: Dispatcher 가 응답에서 "CEO 직접 리뷰 기반…" 같이 사용자를 CEO 로 지칭하거나, 사용자가 CEO 의 권한 (GOAL 자유 변경, 부서 직접 명령) 을 가진 듯 동작.
-- **Right**: 사용자 = **Owner**, Dispatcher = **CEO**. Owner 는 미션을 던지고, CEO 가 GOAL 으로 정립한 뒤 회사를 자율 운영한다. Owner 는 회사의 운영 방식이 아니라 **방향과 평가** 를 제시한다.
-- **Why**: 정체성이 흐려지면 (a) Owner 에게 회사 내부 결정을 떠넘김, (b) Dispatcher 의 단일 대화 창구 룰이 약화, (c) Conductor/Planner 가 Owner 를 직접 호출하는 위반이 연쇄.
-- **Scope**: 모든 응답 문구, GOAL 작성, 부서 호출 안내, escalation 보고.
-
-### [G-002] 자율 실행 위반 — 사용자에게 진행 여부를 묻지 말 것
-- **Date**: 2026-05-07
-- **Status**: verified
-- **Trigger**: 사용자 발화 "왜 나에게 next를 물어볼까? Goal이 정해졌으면 바로 하네스 넥서스 회사가 자율적으로 움직여야 하는것 아닌가?"
-- **Wrong**: GOAL 확정 후에도 "/harness-next 자동 진행하시겠습니까?", "다음 단계로 진행할까요?" 같은 사용자 펌프 질문 출력.
-- **Right**: GOAL 이 명확해지면 즉시 **Conductor 자율 시동**. 사용자 개입 없이 Planner → Gen → Eval chain 무인 진행. 사용자에게 돌아오는 시점은 (a) GOAL 자체가 모호해 명료화 필요, (b) 결과 보고, (c) escalation (3회 FAIL / 인시던트 / GOAL 위반) 셋 뿐.
-- **Why**: NEXUS 도큐트린 P3 "Continuous Loop > End-of-Pipeline" 위반. 사용자 펌프 = 자율성 부재. 회사가 매 단계 사용자 허락을 구하면 NEXUS 메타포 자체가 무너짐.
-- **Scope**: dispatcher → planner / dispatcher → conductor 핸드오프 모든 시점, eval PASS 후 다음 단계 진입, sprint 경계 (단 새 sprint 의 GOAL 이 모호하면 명료화 한 번만).
-
-### [G-003] GOAL 모호성 명료화는 **짧게** 한 번만
-- **Date**: 2026-05-07
-- **Status**: unverified
-- **Trigger**: G-002 의 boundary case
-- **Wrong**: GOAL 명료화를 빌미로 사용자에게 5~10 개 질문 폭탄, 또는 매 sprint 시작 때마다 재명료화.
-- **Right**: 미션이 진짜로 양 갈래일 때 단 1~2 개 질문, AskUserQuestion 으로 객관식. 그 외에는 합리적 해석으로 GOAL 작성 후 Conductor 시동. 결과가 의도와 다르면 사용자가 사후 교정.
-- **Why**: 명료화 인터럽트가 자율성 위반의 우회 통로가 되지 않도록.
-- **Scope**: dispatcher 의 GOAL 정립 단계.
-
-### [G-005] 사용자에게 슬래시 명령을 입력하라고 요구하지 말 것
-- **Date**: 2026-05-07
-- **Status**: verified
-- **Trigger**: Owner 발화 "회사인데 왜 자꾸 나에게 무언가 요청하는가? CEO 가 알아서 결정하면 될것을"
-- **Wrong**: 응답에 "/harness-next 입력하세요", "/harness-evaluator-functional 호출하세요", "다음은 /harness-planner 슬래시 명령" 식으로 Owner 에게 회사 내부 진행 도구를 노출/요구.
-- **Right**: 모든 슬래시 핸드오프 (`/harness-next`, `/harness-planner`, `/harness-evaluator-*` 등) 는 **회사 내부 자동화** 다. SKILL 의 On Complete 에서 직접 핸드오프하거나 `scripts/harness-next.sh` 를 호출. Owner 는 결과 보고와 escalation 만 본다.
-- **Why**: NEXUS 메타포 — Owner 는 회사가 어떤 도구로 일하는지 신경쓰지 않는다. 슬래시 노출은 (a) 자율 실행 깨짐 (b) 정체성 (Owner ≠ CEO) 흐림.
-- **Scope**: 모든 응답 문구. 단 사용자 명시 override 명령 (`/harness-solo`, `/harness-team`, `/harness-stop`) 은 예외 — 이건 Owner 의 권한이며 Owner 가 먼저 묻거나 Conductor 결정에 불만 있을 때만.
-
-### [G-006] Owner 와 대화하는 동안 dashboard 가시화 의무
-- **Date**: 2026-05-07
-- **Status**: verified
-- **Trigger**: Owner 발화 "dispatcher 로 대화 중일때도 CEO 는 자리에 없었고… 잘 워킹하고 있다는 느낌이 들지 않는다"
-- **Wrong**: Dispatcher 가 Owner 의 메시지를 받고 응답을 작성하는 동안 progress.json 의 `current_agent` 가 셋되지 않아 Brick Office dashboard 의 CEO 룸이 idle 로 표시됨.
-- **Right**: Owner 메시지 수신 즉시 첫 행동:
-  ```bash
-  bash scripts/harness-progress-set.sh . '.current_agent = "dispatcher" | .agent_status = "running" | .updated_at = "<iso>"'
-  ```
-  응답 송신 직전 마지막 행동:
-  ```bash
-  bash scripts/harness-progress-set.sh . '.agent_status = "completed" | .updated_at = "<iso>"'
-  ```
-  → CEO 미니피규어가 typing → idle 깜빡임. Owner 가 dashboard 에서 "회사가 일하고 있다" 신뢰 획득.
-- **Scope**: 모든 inbound owner message 처리.
-
-### [G-004] Owner ↔ Conductor / Planner / Generator / Evaluator 직접 라우팅 금지
-- **Date**: 2026-05-07
-- **Status**: verified
-- **Trigger**: AGENTS.md 단일 대화 창구 룰
-- **Wrong**: Dispatcher 가 "Conductor 가 작업 중이니 직접 물어보세요" 또는 사용자 발화를 Conductor 응답으로 직접 전달.
-- **Right**: 모든 부서 ↔ Owner 통신은 Dispatcher 경유. Conductor 의 escalation 도 Dispatcher 가 받아 Owner 에게 요약 보고. Owner 의 추가 입력도 Dispatcher 가 정제해 부서로 전달.
-- **Scope**: 모든 inbound/outbound owner 통신.
+<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/documentationer.md

@@ -1,13 +1,22 @@
-# Gotchas — Documentationer
+---
+docmeta:
+  id: gotchas-documentationer
+  title: Gotchas — udocumentationer
+  type: input
+  createdAt: 2026-05-08T00:00:00Z
+  updatedAt: 2026-05-08T00:00:00Z
+  source:
+    producer: user
+    skillId: harness-dispatcher
+  inputs: []
+  tags: [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
+# Gotchas — udocumentationer
+
+> Dispatcher 가 관리. udocumentationer 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
+> 
+> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
+> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
+
+<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/evaluator-architecture.md

@@ -0,0 +1,22 @@
+---
+docmeta:
+  id: gotchas-evaluator-architecture
+  title: Gotchas — uevaluator-uarchitecture
+  type: input
+  createdAt: 2026-05-08T00:00:00Z
+  updatedAt: 2026-05-08T00:00:00Z
+  source:
+    producer: user
+    skillId: harness-dispatcher
+  inputs: []
+  tags: [gotchas, evaluator-architecture]
+---
+
+# Gotchas — uevaluator-uarchitecture
+
+> Dispatcher 가 관리. uevaluator-uarchitecture 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
+> 
+> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
+> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
+
+<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/evaluator-code-quality.md

@@ -1,31 +1,22 @@
 ---
 docmeta:
-  id: evaluator-code-quality-gotchas
-  title: Gotchas — Evaluator-Code-Quality
+  id: gotchas-evaluator-code-quality
+  title: Gotchas — uevaluator-ucode-uquality
   type: input
-  createdAt: 2026-04-22T00:00:00Z
-  updatedAt: 2026-04-22T00:00:00Z
+  createdAt: 2026-05-08T00:00:00Z
+  updatedAt: 2026-05-08T00:00:00Z
   source:
     producer: user
     skillId: harness-dispatcher
-  tags:
-    - gotchas
-    - evaluator
-    - code-quality
+  inputs: []
+  tags: [gotchas, evaluator-code-quality]
 ---
 
-# Gotchas — Evaluator-Code-Quality
+# Gotchas — uevaluator-ucode-uquality
 
-> Dispatcher가 관리. Evaluator-Code-Quality는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
+> Dispatcher 가 관리. uevaluator-ucode-uquality 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
+> 
+> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
+> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
 
 <!-- 항목이 추가되면 아래에 기록됩니다 -->
-
-## [G-001] 런타임 버그 인지 후 PASS 판정 금지 (verified · 2026-04-27)
-
-**Status**: verified · **Severity**: HIGH
-
-**규칙**: Code-quality eval 단계에서 SSR/RSC↔CC 경계 위반, 잘못된 라우트 타입, missing not-found/error.tsx 등 **런타임에 깨질 정적 결함**을 발견하면 즉시 FAIL. "스타일/구조 문제만 본다" 는 자기 합리화로 런타임 결함을 functional 단계로 넘기지 말 것.
-
-**Why**: 사용자 명시 — "오류가 있는 것을 인지한 채로 스프린트를 넘어가는 행위는 절대 용납할 수 없다." Code-quality 가 정적 분석으로 잡을 수 있었던 결함을 통과시키면 evaluator chain 전체가 신뢰성을 잃는다.
-
-**How to apply**: tsc/eslint 외에도 Next.js App Router 규칙 (use client 경계, typed routes), 라우트 세그먼트 필수 파일 (not-found/error/loading) 누락 여부를 정적으로 검사. 1 건이라도 발견 시 VERDICT=FAIL, retry_target=결함 위치 Generator.

package/gotchas/evaluator-functional.md

@@ -1,42 +1,22 @@
 ---
 docmeta:
-  id: evaluator-functional-gotchas
-  title: Gotchas — Evaluator-Functional
+  id: gotchas-evaluator-functional
+  title: Gotchas — uevaluator-ufunctional
   type: input
-  createdAt: 2026-04-08T00:00:00Z
-  updatedAt: 2026-04-27T00:00:00Z
+  createdAt: 2026-05-08T00:00:00Z
+  updatedAt: 2026-05-08T00:00:00Z
   source:
     producer: user
     skillId: harness-dispatcher
   inputs: []
-  tags: [harness, gotcha, evaluator, evaluator-functional]
+  tags: [gotchas, evaluator-functional]
 ---
 
-# Gotchas — Evaluator-Functional
+# Gotchas — uevaluator-ufunctional
 
-> Dispatcher가 관리. Evaluator-Functional은 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
+> Dispatcher 가 관리. uevaluator-ufunctional 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
+> 
+> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
+> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
 
 <!-- 항목이 추가되면 아래에 기록됩니다 -->
-
-## [G-001] 런타임 버그 인지 후 PASS 판정 금지 (verified · 2026-04-27)
-
-**Status**: verified
-**Severity**: HIGH
-**Occurrences**: 1+ (실제 사례: harness-clue Sprint 3 F-209)
-
-**규칙**: Evaluator (functional / visual / code-quality 모두) 가 평가 중 런타임 버그를 발견했거나 worker 가 보고서에 런타임 버그를 명시한 경우, **PASS 판정 절대 금지**. carry-over / 다음 sprint 처리 / follow-up 으로 미루기도 금지. 같은 sprint 안에서 fix 완료 후에만 PASS.
-
-**검출 시그널** (eval 자체 + worker report 둘 다 스캔):
-- "runtime bug", "런타임 버그/에러", "runtime error"
-- RSC ↔ Client Component 경계 위반 (`use client` 누락 등)
-- `not-found.tsx`, `error.tsx`, `loading.tsx` 누락/오류
-- typed-routes / TypeScript route 타입 미스매치
-- Hydration error, Hydration mismatch
-- 콘솔 uncaught error, unhandled promise rejection
-- worker 가 자기 결과를 "carry-over", "다음 sprint", "추후", "follow-up" 으로 표현
-
-**처리**: 위 시그널 1 건 이상 → VERDICT=FAIL, score 무관, retry_target = 결함 위치 Generator. 점수가 2.80+ 이어도 FAIL 강제 (Adversarial Rule).
-
-**Why**: 사용자 명시 — "오류가 있는 것을 인지한 채로 스프린트를 넘어가는 행위는 절대 용납할 수 없다. 견고하게 기반을 다져나가야 한다."
-
-**How to apply**: Eval 종료 직전 자기 보고서 + Generator 보고서를 위 키워드로 grep. 1 건이라도 매치하면 verdict 를 FAIL 로 강제 변환하고 evaluation-*.md 의 결론 섹션에 "Hard Gate G-001 위반: <검출 키워드> — 같은 sprint 내 fix 후 재평가 필요" 명시.

package/gotchas/evaluator-security.md

@@ -0,0 +1,22 @@
+---
+docmeta:
+  id: gotchas-evaluator-security
+  title: Gotchas — uevaluator-usecurity
+  type: input
+  createdAt: 2026-05-08T00:00:00Z
+  updatedAt: 2026-05-08T00:00:00Z
+  source:
+    producer: user
+    skillId: harness-dispatcher
+  inputs: []
+  tags: [gotchas, evaluator-security]
+---
+
+# Gotchas — uevaluator-usecurity
+
+> Dispatcher 가 관리. uevaluator-usecurity 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
+> 
+> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
+> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
+
+<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/evaluator-visual.md

@@ -1,31 +1,22 @@
 ---
 docmeta:
-  id: evaluator-visual-gotchas
-  title: Gotchas — Evaluator-Visual
+  id: gotchas-evaluator-visual
+  title: Gotchas — uevaluator-uvisual
   type: input
-  createdAt: 2026-04-08T00:00:00Z
-  updatedAt: 2026-04-27T00:00:00Z
+  createdAt: 2026-05-08T00:00:00Z
+  updatedAt: 2026-05-08T00:00:00Z
   source:
     producer: user
     skillId: harness-dispatcher
   inputs: []
-  tags: [harness, gotcha, evaluator, evaluator-visual]
+  tags: [gotchas, evaluator-visual]
 ---
 
-# Gotchas — Evaluator-Visual
+# Gotchas — uevaluator-uvisual
 
-> Dispatcher가 관리. Evaluator-Visual은 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
+> Dispatcher 가 관리. uevaluator-uvisual 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
+> 
+> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
+> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
 
 <!-- 항목이 추가되면 아래에 기록됩니다 -->
-
-## [G-001] 런타임 버그 인지 후 PASS 판정 금지 (verified · 2026-04-27)
-
-**Status**: verified · **Severity**: HIGH
-
-**규칙**: Visual eval 중 콘솔 에러/Hydration mismatch/RSC↔CC 경계 위반/렌더 실패가 한 번이라도 관찰되면 PASS 절대 금지. 스크린샷이 멀쩡해 보여도 console.error 가 1 건 이상이면 FAIL. carry-over/follow-up 으로 미루기 금지.
-
-**검출 시그널**: console error/warning, Hydration error, "use client" 누락, not-found/error.tsx 미렌더, layout shift 비정상, 404/500 응답.
-
-**처리**: VERDICT=FAIL, retry_target=generator-frontend, evaluation-visual.md 결론에 "Hard Gate G-001 위반" 명시. 같은 sprint 내 fix 완료 후에만 재평가.
-
-**Why**: 사용자 명시 — "오류가 있는 것을 인지한 채로 스프린트를 넘어가는 행위는 절대 용납할 수 없다."