@walwal-harness/cli 6.1.5 → 7.1.0

package/gotchas/dispatcher.md

@@ -1,38 +0,0 @@
----
-docmeta:
-  id: gotchas-dispatcher
-  title: Gotchas — udispatcher
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  inputs: []
-  tags: [gotchas, dispatcher]
----
-
-# Gotchas — udispatcher
-
-> Dispatcher 가 관리. udispatcher 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->
-
-### [G-001] Owner GOAL 반복 확인 질문 금지
-
-- Status: verified
-- Date: 2026-05-08
-- Trigger: Owner 가 이미 GOAL 을 명시했거나 `.harness/actions/pipeline.json`, `.harness/actions/goals.md`, `AGENTS.md Active dispatch` 중 하나가 현재 목표를 설명하는데도 “어떤 방식으로 진행할까요”, “다음 단계로 갈까요”, “브레인스토밍할까요”를 반복 질문
-- Rule: GOAL 이 존재하면 합리적 해석으로 회사 루프를 진행한다. 질문은 GOAL 자체가 상호 배타적인 두 방향으로 해석되어 자동 선택이 위험할 때 한 번만 허용한다.
-- Evidence: okx/seller에서 Owner가 목표를 준 뒤에도 같은 성격의 확인 질문이 3회 반복되어 “알아서 동작하는 회사” 모델을 깨뜨렸다.
-
-### [G-SYS-ROLE-CONTRACT-NOT-PROMPT-ONLY] 역할 계약을 일회성 프롬프트에만 넣지 말 것
-
-- Status: verified
-- Date: 2026-05-10
-- Trigger: CEO/COO/CTO/CQO/Service-Ops가 각자 해야 할 일과 금지 사항을 이해하지 못하는데, 이를 개별 wake prompt나 회의 템플릿에만 임시로 적어 하위 에이전트에 자동 적용되지 않음.
-- Rule: 회사 구조, 자율 구조, 역할별 해야 할 일/하면 안 되는 일은 하네스 공통 convention/gotcha/memory에 들어가야 한다. 개별 프롬프트는 이 SoT를 읽게 해야 하며, SoT 자체를 대체하면 안 된다.
-- Fix: 구조적 규칙은 `conventions/shared.md`, 역할별 실수는 `gotchas/<role>.md`, 모든 에이전트 공통 교훈은 `memory.md`에 시스템 entry로 승격한다.

package/gotchas/documentationer.md

@@ -1,22 +0,0 @@
----
-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]
----
-
-# Gotchas — udocumentationer
-
-> Dispatcher 가 관리. udocumentationer 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/evaluator-architecture.md

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

package/gotchas/evaluator-functional.md

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

package/gotchas/evaluator-security.md

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

package/gotchas/generator-backend-laravel.md

@@ -1,19 +0,0 @@
----
-docmeta:
-  id: gotchas-generator-backend-laravel
-  title: Gotchas — Generator-Backend (Laravel/Livewire/Filament)
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  inputs: []
-  tags: [gotchas, generator-backend, laravel]
----
-
-# Gotchas — Generator-Backend · Laravel/Livewire/Filament
-
-> 스택별 가드. Generator-Backend 는 Laravel 스택을 감지하면 `gotchas/generator-backend.md` 와 함께 이 파일을 추가로 읽습니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/generator-backend.md

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

package/gotchas/generator-designer.md

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

package/gotchas/generator-devops.md

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

package/gotchas/generator-frontend.md

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

package/gotchas/meeting-manager.md

@@ -1,30 +0,0 @@
----
-docmeta:
-  id: gotchas-meeting-manager
-  title: Gotchas — umeeting-umanager
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  inputs: []
-  tags: [gotchas, meeting-manager]
----
-
-# Gotchas — umeeting-umanager
-
-> Dispatcher 가 관리. umeeting-umanager 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->
-
-### [G-SYS-MINUTES-NOT-OPS-TABLE] 회의록을 Service-Ops 상태표로 대체하지 말 것
-
-- Status: verified
-- Date: 2026-05-10
-- Trigger: hourly report 또는 meeting record가 서버 health table, queue 상태, "continue loop" 한 줄만 남기고 CEO/COO/CTO/CQO/Service-Ops가 무엇을 논의했는지 보여주지 않음.
-- Rule: Meeting-Manager의 산출물은 운영 리포트가 아니라 임원 회의록이다. `## Role Briefs` 또는 `## Required Role Positions`에 Dispatcher/CEO, Planner/COO, CTO, CQO, Service-Ops 전원의 Position/Evidence/Action이 있어야 하며, `## Discussion`, `## Decision JSON`, `## Action Items`가 없으면 회의 완료로 보고하지 않는다.
-- Fix: Service-Ops health table은 evidence로만 넣고, 토론과 decision owner/action_type으로 내부 실행 owner를 지정한다.

package/gotchas/planner.md

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

package/gotchas/service-ops.md

@@ -1,30 +0,0 @@
----
-docmeta:
-  id: gotchas-service-ops
-  title: Gotchas — uservice-uops
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  inputs: []
-  tags: [gotchas, service-ops]
----
-
-# Gotchas — uservice-uops
-
-> Dispatcher 가 관리. uservice-uops 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->
-
-### [G-SYS-ALERT-MUST-BECOME-MEETING-ACTION] 운영 경고를 혼자 남기고 끝내지 말 것
-
-- Status: verified
-- Date: 2026-05-10
-- Trigger: Service-Ops가 서버 down, health fail, KPI drift를 감지했지만 ops-report만 쓰고 CTO/CQO/Meeting-Manager action으로 연결하지 않음.
-- Rule: Service-Ops의 경고는 최종 산출물이 아니라 회의 evidence다. red-alert/down/degraded가 있으면 incident-war-room 또는 followup-review를 요구하고, CTO runtime-recovery action과 CQO evidence gate가 회의록에 남도록 해야 한다.
-- Fix: `.service_ops.incident.open[]`, ops-report path, health table을 evidence로 제출하고 `.meetings.requested_type`/`.meetings.requested_reason` 또는 meeting decision을 통해 다음 owner를 지정한다.

package/skills/_shared/dynamic-registration.md

@@ -1,120 +0,0 @@
----
-docmeta:
-  id: dynamic-registration
-  title: 동적 Gotcha / Convention 등록 — 모든 worker mandatory
-  type: input
-  createdAt: 2026-04-27T00:00:00Z
-  updatedAt: 2026-04-27T00:00:00Z
-  source:
-    producer: user
-    skillId: harness
-  inputs: []
-  tags: [harness, gotcha, convention, dynamic-registration, mandatory]
----
-
-# 동적 Gotcha / Convention 등록 — 모든 worker mandatory
-
-모든 Generator / Evaluator / Lead 는 자기 작업 결과물(`evaluation-*.md` / `gen-report-*.md` / `lead-report-*.md`) 끝에 **두 개의 fenced JSON 블록**을 반드시 포함한다. `harness-next.sh` 와 Team mode Lead 가 작업 직후 자동으로 `harness-gotcha-register.sh --scan-all` 을 호출하여 두 블록을 dedup append 한다.
-
-**왜 mandatory 인가**: 사용자 명시 — "Gen/Eval 이 발견한 패턴은 메뉴얼로 시키기 전에 동적으로 등록되어야 한다. 자동으로 패턴화되는 이슈는 등록하라." 한 번 발견된 실수가 다음 sprint 에서 반복되지 않게 하려면 발견자가 그 자리에서 등록하는 것이 유일한 closure.
-
-**금지**: 두 블록 중 하나라도 누락된 채로 작업 종료. 비어 있어도 `[]` 로 명시 (블록 자체 생략 금지).
-
----
-
-## 1) gotcha_candidates — 부정 가이드 (실수 패턴)
-
-**누가 등록**:
-- Evaluator: 평가 중 발견한 generator 의 반복 가능한 결함
-- Generator: 자기 작업 중 한 번 시도했다가 깨졌던 접근, 자체 fix 한 코드 실수
-- Lead (Team mode): worker 보고서들에서 N 회 반복되는 패턴 (≥2 occurrences 권장)
-
-**검출 기준** (하나라도 해당):
-- 같은 sprint 내 다른 feature 에서도 재발할 가능성이 있는 결함
-- generator 가 자주 빠뜨리는 케이스 (RSC↔CC 경계, schema 누락, missing not-found.tsx 등)
-- spec/contract 위반 패턴
-- AC 부분 통과 / Hard Gate 위반 사유
-- lint/type 이 한 번에 안 잡힌 케이스 (정적 분석으로 못 잡는 결함)
-
-**스키마**:
-```gotcha_candidates
-[
-  {
-    "target": "generator-frontend",
-    "rule_id": "rsc-cc-boundary-monitoring",
-    "title": "Server Component 에서 useState/useEffect 호출",
-    "wrong": "app/monitoring/page.tsx 에 'use client' 없이 hook 사용 → 빌드 통과해도 런타임에 깨짐",
-    "right": "client-side state 사용 시 파일 최상단에 'use client' 명시. 또는 server component 로 유지하면서 client 부분만 분리.",
-    "why": "Next.js App Router 의 RSC↔CC 경계는 정적 분석으로 100% 안 잡힘. F-209 에서 발견.",
-    "scope": "app/**/page.tsx, app/**/layout.tsx",
-    "source": "evaluator-functional:F-209"
-  }
-]
-```
-
-비어 있으면:
-```gotcha_candidates
-[]
-```
-
-필수 필드: `target`, `rule_id`, `title`. 권장 필드: `wrong`, `right`, `why`, `scope`, `source`.
-
-`target` 가능 값: `planner`, `dispatcher`, `brainstorming`, `generator-backend`, `generator-frontend`, `generator-frontend-flutter`, `evaluator-code-quality`, `evaluator-functional`, `evaluator-visual`, `evaluator-functional-flutter`.
-
-`rule_id` 는 dedup key — 같은 rule_id 가 이미 있으면 Occurrences +1 만 증가하고 본문은 안 바뀜. **kebab-case 짧고 의미 있는 식별자**.
-
----
-
-## 2) convention_candidates — 긍정 가이드 (반복 가능한 best practice)
-
-**누가 등록**:
-- Evaluator: 평가 중 확립된 반복 가능한 모범 사례
-- Generator: 작업 중 적용한 일관된 패턴 (다른 feature 에 모방되어야 하는)
-- Lead: sprint 전반에서 합의된 룰
-
-**검출 기준**:
-- 같은 sprint 의 다른 feature 가 모방해야 할 패턴
-- API 계약 / 폴더 구조 / 명명 규칙 관련 결정
-- 사용자가 "이렇게 해" 라고 한 한 번의 발언이 평가/생성에서 일반화 가능한 경우
-
-**스키마**:
-```convention_candidates
-[
-  {
-    "scope": "generator-frontend",
-    "rule_id": "route-segment-files",
-    "title": "App Router 세그먼트 필수 파일 세트",
-    "rule": "모든 app/**/page.tsx 는 같은 폴더에 not-found.tsx, error.tsx, loading.tsx 를 함께 배치한다.",
-    "why": "Next.js 의 segment-level 에러/로딩 처리. 누락 시 default 흰 화면 노출. F-209 평가에서 표준화 결정.",
-    "source": "evaluator-functional:F-209"
-  }
-]
-```
-
-비어 있으면:
-```convention_candidates
-[]
-```
-
-필수 필드: `rule_id`, `title`, `rule`. 권장 필드: `scope`, `why`, `source`.
-
-`scope` 가능 값: `shared` (전체 공통), `generator-backend`, `generator-frontend`, `evaluator-*`, `planner`. 미지정 시 `shared`.
-
----
-
-## 3) 등록 결과 확인
-
-작업 완료 후 다음 명령으로 등록된 항목 확인 가능:
-```bash
-bash scripts/harness-gotcha-register.sh . --scan-all  # 수동 재스캔
-ls .harness/gotchas/ .harness/conventions/             # 누적 결과
-tail -20 .harness/progress.log | grep gotcha-register  # 등록 로그
-```
-
-## 4) Team mode 추가 룰
-
-Team mode 에서 Lead 는 worker PASS/FAIL 처리 직후 (merge 전) 다음을 실행한다:
-```bash
-bash scripts/harness-gotcha-register.sh . --scan-all
-```
-이로써 worker 가 작성한 두 블록이 즉시 누적되며, 다음 worker spawn 시 새 worker 가 갱신된 gotchas/conventions 를 startup 에 읽어 같은 실수를 반복하지 않는다.