@walwal-harness/cli 6.1.6 → 7.1.1

package/commands/hot-fix.md

@@ -0,0 +1,25 @@
+---
+description: Start an urgent fix outside the active goal.
+argument-hint: "<incident or fix request>"
+---
+
+# /hot-fix
+
+Route the Owner request to the installed `harness-ceo` agent/skill as an emergency mission.
+
+Required flow:
+1. Create `.harness/documents/{hotfix_name}/ceo.md`.
+2. CEO summons CTO and CQO; summon COO/CDO only when planning or UX decisions are involved.
+3. CTO applies the smallest correct patch path through hired implementation skills.
+4. CXX roles must not directly execute specialist deliverables. They must use hired workers for implementation, QA, ops checks, and documentation even when the fix is small.
+5. If a required worker is missing, CEO or the responsible CXX must invoke the installed `harness-hiring` skill before assigning the work.
+6. CQO records regression coverage and recurrence prevention with worker report paths under `.harness/documents/{hotfix_name}/workers/`.
+7. Register durable lessons in `.harness/gotchas/`, `.harness/conventions/`, or `.harness/memories/` as appropriate.
+8. Archive only after CQO has accepted the fix.
+9. Do not invoke internal roles through slash commands; commands are Owner entrypoints only.
+
+Hot-fix request:
+
+```
+$ARGUMENTS
+```

package/commands/play-harness.md

@@ -0,0 +1,22 @@
+---
+description: Run the harness play build and notify OPS monitoring.
+argument-hint: "[additional play args]"
+---
+
+# /play-harness
+
+Run the target project's harness play mode.
+
+Required flow:
+1. Confirm `.harness/` exists in the current project.
+2. Run `bash scripts/play.sh $ARGUMENTS`.
+3. Treat play mode and release mode as mutually exclusive. If release mode is active, stop it first with `/stop-harness` or report the conflict to the Owner.
+4. After the script returns, read the emitted OPS report path and notify the installed `harness-ops` skill/agent that play monitoring has started.
+5. Record the build result in `.harness/documents/{mission_name}/ops.md` when a mission is active.
+6. Do not route this through `/goal`; this command is an Owner-facing runtime control entrypoint.
+
+Play arguments:
+
+```
+$ARGUMENTS
+```

package/commands/release-harness.md

@@ -0,0 +1,22 @@
+---
+description: Run the harness release build, start service operation, and notify OPS monitoring.
+argument-hint: "[additional release args]"
+---
+
+# /release-harness
+
+Run the target project's harness release mode and begin service operation.
+
+Required flow:
+1. Confirm `.harness/` exists in the current project.
+2. Run `bash scripts/release.sh release $ARGUMENTS`.
+3. Treat play mode and release mode as mutually exclusive. If play mode is active, stop it first with `/stop-harness` or report the conflict to the Owner.
+4. After the script returns, read the emitted OPS report path and notify the installed `harness-ops` skill/agent that release monitoring has started.
+5. Record the release result in `.harness/documents/{mission_name}/ops.md` when a mission is active.
+6. Do not route this through `/goal`; this command is an Owner-facing runtime control entrypoint.
+
+Release arguments:
+
+```
+$ARGUMENTS
+```

package/commands/stop-harness.md

@@ -0,0 +1,21 @@
+---
+description: Stop any harness play or release process/session.
+argument-hint: "[optional stop reason]"
+---
+
+# /stop-harness
+
+Stop any active harness play or release runtime.
+
+Required flow:
+1. Confirm `.harness/` exists in the current project.
+2. Run `bash scripts/harness-runtime-stop.sh $ARGUMENTS`.
+3. Verify both play and release runtime state files are cleared or marked stopped.
+4. Notify the installed `harness-ops` skill/agent that monitoring should stop for the terminated runtime mode.
+5. Record the stop result in `.harness/documents/{mission_name}/ops.md` when a mission is active.
+
+Stop reason:
+
+```
+$ARGUMENTS
+```

package/conventions/README.md

@@ -1,92 +1,18 @@
----
-docmeta:
-  id: conventions-readme
-  title: Conventions — House Style Registry
-  type: input
-  createdAt: 2026-04-22T00:00:00Z
-  updatedAt: 2026-04-22T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - house-style
-    - registry
----
+# Conventions
 
-# Conventions — House Style Registry
+Bundled v7 convention templates copied into target projects during `walwal-harness init`.
 
-> 이 디렉토리는 프로젝트의 **긍정 규범(house style)** 을 누적 기록합니다.
-> Gotcha(실수 기록) 가 사고 이후의 방어선이라면, Convention 은 합의된 원칙입니다.
-> Dispatcher 가 사용자의 긍정 가이드("~해야 해", "~이렇게 해줘") 를 감지하면
-> 해당 에이전트/스코프의 convention 파일에 `### [C-NNN]` 으로 append 합니다.
+Only company-level roles are provided by default:
 
-## 파일 구조
+- `shared.md`
+- `ceo.md`
+- `coo.md`
+- `cdo.md`
+- `cto.md`
+- `cqo.md`
+- `ops.md`
+- `hiring.md`
+- `resource-manager.md`
+- `brick-office.md`
 
-```
-.harness/conventions/
-├── README.md                        # 이 파일
-├── shared.md                        # 모든 에이전트 공통 규범
-│
-├── conductor.md
-├── dispatcher.md
-├── meeting-manager.md
-├── planner.md
-├── cto.md
-├── cqo.md
-├── service-ops.md
-│
-├── coo-developer.md
-├── documentationer.md
-│
-├── generator-backend.md
-├── generator-frontend.md
-├── generator-designer.md
-├── generator-devops.md
-│
-├── evaluator-code-quality.md
-├── evaluator-functional.md
-├── evaluator-visual.md
-├── evaluator-architecture.md
-└── evaluator-security.md
-```
-
-루트의 `CONVENTIONS.md` 는 사용자가 자유롭게 기술하는 **최상위 원칙** 용도로
-그대로 유지됩니다. 여기 `.harness/conventions/` 는 대화 중 Dispatcher 가
-자동 누적하는 계층화된 하위 규범 저장소입니다.
-
-## 읽기 순서 (모든 에이전트)
-
-세션 시작 시 각 에이전트는 아래 순서로 적용합니다:
-
-1. `CONVENTIONS.md` (루트, 최상위 원칙)
-2. `.harness/conventions/shared.md` (공통)
-3. `.harness/conventions/<self>.md` (자기 스코프)
-4. `.harness/gotchas/<self>.md` (과거 실수 방어)
-5. **(v6.2) parallel-tracks 형제 트랙 owner 의 gotcha** — `progress.json.conductor.tracks[]` 에서 자기 트랙이 아닌 형제 트랙의 owner 를 식별, 해당 owner 의 `gotchas/<owner>.md` 도 한 번 훑기. fork 회의에서 같은 결정으로 함께 출발한 부서의 가드를 무시하지 않기 위함.
-6. `.harness/memory.md` (구조적 교훈)
-
-**충돌 시 우선순위**: `<self>` > `shared` > 루트 `CONVENTIONS.md`.
-형제 트랙 gotcha 는 **참고**용 — 자기 결정과 충돌 시 자기 스코프가 우선.
-
-## 항목 형식
-
-```markdown
-### [C-NNN] 간결한 제목
-- **Date**: YYYY-MM-DD
-- **Scope**: <agent> | shared
-- **Rule**: 규범 내용 (긍정형)
-- **Rationale**: 왜 이렇게 하는가
-- **Applies to**: 적용 대상 (에이전트·파일 경로 등)
-- **Added from**: 출처 (사용자 프롬프트 / 마이그레이션 / 수동)
-```
-
-## 데이터 보존
-
-- `npm install` postinstall 은 `### [C-NNN]` 엔트리가 있는 파일을 **절대 덮어쓰지 않습니다** (v5.6.0+).
-- 스캐폴드 템플릿인 경우에만 갱신됩니다.
-- 원본 백업: `.harness/archive/pre-harness-*.md.bak` (최초 설치 시 마이그레이션)
-
-## 수동 편집
-
-사용자가 직접 편집해도 됩니다. `### [C-NNN]` 형식만 지키면 Dispatcher 가 다음 자동 append 시 번호를 이어서 부여합니다.
+Specialist worker conventions are not bundled here. They are created or promoted later through hiring, mission work, and CQO memory hygiene.

package/conventions/brick-office.md

@@ -0,0 +1,5 @@
+# Brick Office Conventions
+
+- Brick Office is an internal agent/skill, not a slash command.
+- Brick Office visualizes `.harness` runtime state: missions, CXX status, hired workers, events, archive state, and ops exceptions.
+- Brick Office works with CDO for UI/UX, CTO for app wiring, CQO for visibility criteria, and OPS for log surfaces.

package/conventions/cdo.md

@@ -0,0 +1,6 @@
+# CDO Conventions
+
+- CDO owns branding, UI/UX direction, design references, mock selection, and design review.
+- CDO records decisions in `.harness/documents/{mission_name}/cdo.md`.
+- CDO hires design and design-review workers before assigning specialist design tasks.
+- CDO output must be implementable by CTO teams, not only descriptive.

package/conventions/ceo.md

@@ -0,0 +1,9 @@
+# CEO Conventions
+
+- CEO is the only Owner-facing internal role.
+- CEO receives `/goal` and `/hot-fix` through command entrypoints.
+- CEO routes work to CXX agents through agent/skill invocation, not slash commands.
+- CEO records mission framing and routing decisions in `.harness/documents/{mission_name}/ceo.md`.
+- CEO asks only mission-relevant questions to COO, CDO, CTO, CQO, and OPS.
+- CEO does not accept CXX completion unless specialist deliverables were produced by hired workers.
+- CEO requires worker names and `.harness/documents/{mission_name}/workers/{worker-name}.md` paths in CXX completion reports.

package/conventions/coo.md

@@ -0,0 +1,6 @@
+# COO Conventions
+
+- COO owns planning, research, service direction, reference models, and hypothesis validation.
+- COO records decisions in `.harness/documents/{mission_name}/coo.md`.
+- COO hires researchers, product planners, junior experiment developers, and documentation workers before delegating specialist work.
+- COO reports mission fit, evidence, rejected options, and recommended next CXX to CEO.

package/conventions/cqo.md

@@ -1,24 +1,7 @@
----
-docmeta:
-  id: conventions-cqo
-  title: Conventions — ucqo
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - cqo
----
+# CQO Conventions
 
-# Conventions — ucqo
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기는 ucqo 스코프의 긍정 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드("~해야 해", "~이렇게 해줘") 를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->
+- CQO owns quality strategy, regression gates, archive approval, memory hygiene, and recurrence prevention.
+- CQO records decisions in `.harness/documents/{mission_name}/cqo.md`.
+- CQO hires evaluators and reviewers before assigning specialist quality work.
+- No archive is accepted without evidence.
+- Verified recurring lessons are promoted to `.harness/conventions/`, `.harness/gotchas/`, `.harness/memories/`, or `.harness/shared/`.

package/conventions/cto.md

@@ -1,24 +1,6 @@
----
-docmeta:
-  id: conventions-cto
-  title: Conventions — ucto
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - cto
----
+# CTO Conventions
 
-# Conventions — ucto
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기는 ucto 스코프의 긍정 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드("~해야 해", "~이렇게 해줘") 를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->
+- CTO owns architecture, API, account model, platform choices, and implementation coordination.
+- CTO records decisions in `.harness/documents/{mission_name}/cto.md`.
+- CTO hires backend, frontend, app, web, architecture, DevOps, and evaluator workers before assigning specialist work.
+- CTO must not collapse architecture, implementation, and evaluation into one generic task.

package/conventions/hiring.md

@@ -0,0 +1,7 @@
+# Hiring Conventions
+
+- Hiring searches `.harness/shared/HR-Resource/` for the smallest suitable worker.
+- Hiring installs selected workers into `.claude/skills/` and `.codex/skills/`.
+- Hiring updates `.harness/shared/hr-roster.json`.
+- Hiring asks Resource Manager to update invocation wording.
+- Hiring never marks an absent worker as available.

package/conventions/ops.md

@@ -0,0 +1,9 @@
+# OPS Conventions
+
+- OPS monitors two explicit environment classes: build environments driven by commands, and service environments driven by mapped server endpoints.
+- OPS does not invent live service mappings. CEO must collect local/Docker/cloud server information from the Owner before OPS marks a service live.
+- CEO records the Owner-approved `{xx}000` base port in `.env` as `HARNESS_BASE_PORT`; CXX services allocate ports above that base.
+- OPS flags unmapped ports, missing `.env` base port, or services outside the agreed base range as ops drift.
+- OPS records operating decisions in `.harness/documents/{mission_name}/ops.md`.
+- OPS writes daily logs under `.harness/logs/YYYY-MM-DD/`.
+- OPS logs every non-good-case result and raises emergency events to CEO, CTO, and CQO.

package/conventions/resource-manager.md

@@ -0,0 +1,6 @@
+# Resource Manager Conventions
+
+- Resource Manager maintains `.harness/shared/resource-index.json`.
+- Resource Manager answers whether a suitable worker is already hired.
+- If no worker is hired, Resource Manager suggests HR-Resource candidates and recommends Hiring.
+- Invocation wording must be specific enough to avoid accidental generic execution.

package/conventions/shared.md

@@ -1,58 +1,29 @@
----
-docmeta:
-  id: conventions-shared
-  title: Conventions — shared
-  type: input
-  createdAt: 2026-04-22T00:00:00Z
-  updatedAt: 2026-04-22T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - shared
----
-
-# Conventions — shared
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기(`.harness/conventions/shared.md`)는 역할 국한 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `.harness/conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->
-
-### [C-SYS-AUTONOMOUS-DEPLOY-AFTER-FIX] 코드 수정 후 운영 반영은 회사가 자율 처리
-
-- **Status**: verified
-- **Date**: 2026-05-10
-- **Scope**: all agents
-- **Rule**: 어떤 에이전트든 코드를 수정한 직후 운영 반영이 필요하면 build, restart, migration, cron/launchd 재등록, health check, ops-report까지 회사가 자율 처리한다. CTO, Service-Ops, Generator-DevOps 사이 협의는 내부 handoff로 처리하고 Owner에게는 시작 통지와 결과 보고만 한다.
-- **Why**: Owner 입력은 GOAL/사고/결과 확인용이지 운영 펌프 신호가 아니다. 최초 GOAL 이후 회사는 내부 owner를 정해 복구와 배포를 진행해야 한다.
-- **Apply**: 코드/설정 변경 후 운영 반영이 필요하면 Meeting-Manager 또는 Conductor는 `required_execution`에 owner, deliverable, verifier를 명시하고, Service-Ops가 health evidence를 갱신할 때까지 `waiting_owner`로 멈추지 않는다.
-
-### [C-SYS-HOURLY-REPORT-AS-MEETING-MINUTES] hourly 보고서는 부서 회의록 형식이다
-
-- **Status**: verified
-- **Date**: 2026-05-10
-- **Scope**: meeting-manager, service-ops, conductor
-- **Rule**: `harness-hourly-review.sh`가 작성하는 md 및 Telegram 송신 대상은 단순 service health/KPI dump가 아니라 CEO/COO/CTO/CQO/Service-Ops의 role position, discussion, decision JSON, action items, required execution을 포함한 회의록이어야 한다.
-- **Why**: Owner가 확인하려는 것은 서버 운용현황 자체가 아니라 회사가 GOAL을 향해 어떤 상황을 어떻게 타진하고 어떤 실행 결정을 내렸는지다.
-- **Anti-pattern**: health table만 있고 `required_execution`, owner, verifier, next-tick deliverable이 없으면 회의가 아니라 paperwork로 분류한다.
-
-### [C-SYS-EXEC-ROLE-CONTRACT] 회사 구조와 임원 역할 계약은 하네스 공통 규칙이다
-
-- **Status**: verified
-- **Date**: 2026-05-10
-- **Scope**: all agents
-- **Rule**: walwal-harness는 "회사 구조 + 자율 구조 + 하네스"를 구현한다. CEO/COO/CTO/CQO/Service-Ops의 역할, 해야 할 일, 하면 안 되는 일은 개별 회의 프롬프트의 장식이 아니라 모든 에이전트가 세션 시작 시 적용해야 하는 하네스 공통 규칙이다.
-- **Role contract**:
-  - `Dispatcher/CEO`: Owner와의 유일한 외부 창구. GOAL, 사업 우선순위, Owner escalation 필요성을 판정한다. 내부 해결 가능한 일을 Owner 대기로 끝내지 않는다.
-  - `Planner/COO`: GOAL을 work package, queue, 가설, plan으로 바꾼다. planning_drift/goal_drift를 판정하고 다음 operating cycle을 정의한다.
-  - `CTO`: 구현, 아키텍처, 기술선택, runtime recovery 책임자다. 서버 down이나 구현 drift를 Service-Ops 알림으로 방치하지 않고 복구/핫픽스 owner를 지정한다.
-  - `CQO`: 품질, 회귀, 검증 기준 책임자다. evidence 없는 PASS, 낙관론, 미검증 복구 주장을 통과시키지 않는다.
-  - `Service-Ops`: 운영 신호, KPI, incident, monitor cadence 책임자다. 경고를 혼자 남기고 끝내지 않고 meeting-manager를 통해 CTO/CQO action으로 연결한다.
-  - `Meeting-Manager`: 임원 회의를 소집/기록/디스패치한다. 회의록에는 각 role의 Position, Evidence, Action이 있어야 한다.
-- **Autonomy rule**: 최초 GOAL 이후 Owner 입력은 interrupt/additional request다. 회사는 `waiting_owner`로 멈추지 않고 `meeting-manager`와 `conductor`를 통해 다음 내부 owner로 진행한다.
-- **Evidence rule**: "회의했다"는 `.harness/actions/meetings/<id>/meeting-<id>.md`에 임원별 입장, 토론, decision JSON, action items가 있을 때만 말할 수 있다.
+# Shared Conventions
+
+## V7 Runtime Boundary
+
+- This package repository must not contain project runtime `.harness/` state.
+- `walwal-harness init` creates `.harness/` in the target project.
+- `.claude/commands` and `.codex/commands` contain only `/goal` and `/hot-fix`.
+- CXX and worker execution uses installed agents/skills, not slash commands.
+
+## Hiring Boundary
+
+- A missing specialist must not be replaced by a generic default AI engine.
+- Use `harness-resource-manager` to find already hired workers.
+- Use `harness-hiring` to hire from `.harness/shared/HR-Resource/`.
+- Record hired workers in `.harness/shared/hr-roster.json`.
+- CXX agents do not complete specialist work directly, even for small tasks.
+- Research, planning, design, implementation, QA, ops checks, and documentation deliverables must be assigned to hired workers.
+- CXX mission reports must cite worker names and report paths for accepted deliverables.
+
+## Mission Documents
+
+- Mission records live under `.harness/documents/{mission_name}/`.
+- CXX decisions use `{cxx}.md`.
+- Worker reports use `workers/{worker-name}.md`.
+
+## DDD
+
+- Keep domain, application, interface, and infrastructure decisions distinct.
+- CXX agents define responsibility boundaries before assigning workers.

package/gotchas/README.md

@@ -1,86 +1,18 @@
-# Gotchas — Agent Mistake Registry
+# Gotchas
 
-> 이 디렉토리는 각 에이전트가 반복하는 실수를 누적 기록합니다.
-> Dispatcher가 사용자의 실수 지적을 감지하면 해당 에이전트의 gotchas 파일에 추가합니다.
-> 각 에이전트는 세션 시작 시 자신의 gotchas 파일을 읽고 같은 실수를 반복하지 않습니다.
+Bundled v7 gotcha templates copied into target projects during `walwal-harness init`.
 
-## 파일 구조
+Only company-level roles are provided by default:
 
-```
-.harness/gotchas/
-├── 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)
-```
+- `shared.md`
+- `ceo.md`
+- `coo.md`
+- `cdo.md`
+- `cto.md`
+- `cqo.md`
+- `ops.md`
+- `hiring.md`
+- `resource-manager.md`
+- `brick-office.md`
 
-## 항목 형식
-
-```markdown
-### [G-NNN] 간결한 제목  <!-- rule_id: <unique-key> -->
-- **Status**: unverified | verified | resolved
-- **Date**: YYYY-MM-DD
-- **Source**: <작성 주체>        (예: "evaluator-functional:F-003" / "dispatcher:manual" / "meeting:M-...:track-2")
-- **Trigger**: 사용자가 한 말 또는 "Eval 자동 감지" 또는 "track abandon"
-- **Wrong**: 에이전트가 했던 잘못된 행동
-- **Right**: 올바른 행동
-- **Why**: 왜 잘못인지 근거
-- **Scope**: 이 규칙이 적용되는 조건/범위
-- **Occurrences**: 1
-- **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 로 기록
-- **Evaluator (code-quality / functional / visual)**: evaluation-*.md 의 `gotcha_candidates` JSON 블록을 통해 자동 등록 (v5.7.1+). `harness-next.sh` 가 Evaluator 완료 직후 `scripts/harness-gotcha-register.sh --scan-evaluations` 로 처리.
-
-## Status 라이프사이클 (v5.7.1+)
-
-- **unverified**: 신규 자동/수동 등록 기본값. Generator 는 참조하지만 페널티 강도 낮음.
-- **verified**: Planner/사용자 리뷰 후 승격. 이후 위반 시 하드 페널티.
-- **resolved**: 근본 원인이 코드/스킬/컨벤션에 반영되어 더 이상 재발하지 않는 항목. 삭제 대신 태그 유지.
-
-Planner 는 스프린트 전환 시 `unverified` 항목을 검토해 `verified` 또는 제거 판정을 내린다 (AGENTS.md "메모리 오염 방어" 섹션).
-
-## 관리 규칙
-
-- Dispatcher + Evaluator 만 gotchas 파일에 쓰기 가능 (자동 등록 포함)
-- 각 에이전트는 자신의 gotchas 파일을 읽기 전용으로 참조
-- 중복 항목 금지 — 동일 `rule_id` 는 `Occurrences` + `Last-Seen` 만 갱신
-- 해결된 항목: `Status: resolved` 또는 제목 뒤 `[RESOLVED]` 태그
-- 항목이 20개 초과 시 가장 오래된 resolved 항목부터 정리
+Specialist worker gotchas are not bundled. CQO promotes recurring verified failures into this store as the company learns.

package/gotchas/brick-office.md

@@ -0,0 +1,9 @@
+# Brick Office Gotchas
+
+## Dashboard As Landing Page
+
+Do not build a marketing page. Brick Office is an operational dashboard over `.harness` runtime state.
+
+## Package-local State Assumption
+
+Do not assume this package repository contains the target project's runtime `.harness`.

package/gotchas/cdo.md

@@ -0,0 +1,9 @@
+# CDO Gotchas
+
+## Unimplementable Design
+
+Do not produce design direction that CTO cannot implement or evaluate.
+
+## Self-review Only
+
+Do not accept a design direction without reviewer feedback when the mission requires quality or differentiation.

package/gotchas/ceo.md

@@ -0,0 +1,9 @@
+# CEO Gotchas
+
+## Treating CXX As Commands
+
+CEO must not call `/coo`, `/cto`, or similar slash commands. CXX routing is agent/skill invocation.
+
+## Over-broad Meeting
+
+Do not summon every CXX for every mission by default. Ask only the roles needed for the decision.

package/gotchas/coo.md

@@ -0,0 +1,9 @@
+# COO Gotchas
+
+## Planning Without Evidence
+
+Do not report a hypothesis as goal-fit without evidence, reference analysis, backtest, spike, or explicit uncertainty.
+
+## Specialist Bypass
+
+Do not perform specialist research, experiment development, or documentation as a generic COO response when a worker should be hired.

package/gotchas/cqo.md

@@ -1,22 +1,9 @@
----
-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]
----
+# CQO Gotchas
 
-# Gotchas — ucqo
+## Archive Without Evidence
 
-> Dispatcher 가 관리. ucqo 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
+Do not approve archive based on narrative confidence. Require concrete quality evidence.
 
-<!-- 항목이 추가되면 아래에 기록됩니다 -->
+## Unpromoted Recurrence
+
+Do not leave repeated failures only in chat or mission notes. Promote verified recurrence prevention to conventions, gotchas, memories, or shared state.

package/gotchas/cto.md

@@ -1,22 +1,9 @@
----
-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]
----
+# CTO Gotchas
 
-# Gotchas — ucto
+## Generic Engineering Assignment
 
-> Dispatcher 가 관리. ucto 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
+Do not assign architecture, backend, frontend, DevOps, and evaluation to one generic worker.
 
-<!-- 항목이 추가되면 아래에 기록됩니다 -->
+## Missing Boundary
+
+Do not start implementation before domain, API, platform, account, and integration boundaries are explicit enough for workers.

package/gotchas/hiring.md

@@ -0,0 +1,9 @@
+# Hiring Gotchas
+
+## Over-hiring
+
+Do not hire a broad worker when a narrower HR-Resource candidate fits the task.
+
+## Missing Wiring
+
+Do not stop after copying a skill. Update roster and Resource Manager wording so the requester can invoke the worker.