@walwal-harness/cli 7.1.6 → 7.1.8

package/HR-Resource/resource-manager/SKILL.md

@@ -21,6 +21,10 @@ Manage worker availability and invocation wording.
 
 1. Check whether the requester is a CXX. CEO cannot request specialist worker assignment directly.
 2. Check whether a suitable worker is already hired for that owning CXX.
-3. If hired, return the exact skill name, owning CXX, hierarchical installed paths, and mission report path.
+3. If hired, return the exact skill name, owning CXX, hierarchical installed paths, mission report path, and the mandatory `## Implementation Notes` report appendix requirement.
 4. If not hired, suggest `.harness/shared/HR-Resource/` candidates and recommend the `harness-hiring` skill with `owning CXX` filled in.
 5. Keep aliases narrow enough to avoid accidental generic invocation.
+
+## Mandatory Worker Report Appendix
+
+Every worker assignment must require the worker to append an English `## Implementation Notes` section with these subsections: `Design Decisions`, `Deviations`, `Tradeoffs`, and `Open Questions`. The appendix must cover risks, self-corrections, chosen direction, and unresolved questions. Use `None` for empty subsections.

package/README.md

@@ -93,6 +93,30 @@ Owner /hot-fix → CEO → CTO → [dev workers] → CQO → [evaluator workers]
 | 6 | CEO routes only to CXX — never directly to workers |
 | 7 | No CXX self-execution — deliverables without matching worker records are rejected |
 | 8 | No verdict without worker evidence — CQO self-inspection is not valid |
+| 9 | Hierarchical worker ownership — worker reports live under `.harness/documents/{mission}/{owning-cxx}/workers/` |
+| 10 | Implementation Notes required — `ceo.md`, every `{cxx}.md`, and every worker report must end with an English `## Implementation Notes` section |
+
+### Implementation Notes Format
+
+Every `ceo.md`, `{cxx}.md`, and worker report must end with:
+
+```markdown
+## Implementation Notes
+
+### Design Decisions
+- How the role interpreted the Owner request
+
+### Deviations
+- Where the role intentionally diverged from the request
+
+### Tradeoffs
+- Alternatives considered and why they were rejected
+
+### Open Questions
+- What still needs Owner or CXX confirmation
+```
+
+Use `None` when a subsection has no entries. This section is mandatory even for small or emergency work. CEO must reject any CXX report that omits it. CTO and CQO must not accept worker output that omits it.
 
 ---
 
@@ -145,6 +169,8 @@ harness-hiring           → register and onboard worker
 
 | Version | Summary |
 |---|---|
+| 7.1.8 | HR-Resource: replace China-platform-specific workers with global equivalents; refine cross-border/video/livestream skills |
+| 7.1.7 | Implementation Notes mandatory in all CXX docs and worker reports; harness-worker-evidence-validate.sh |
 | 7.1.6 | CXX hierarchy enforcement: CEO→CXX-only gate, CTO prerequisite gate, CQO worker-evidence mandate; dashboard gotchas tab, mission-specific history tab, worker file list in flow |
 | 7.1.5 | Dashboard: mission flow timeline, markdown viewer, 50vw drawer |
 | 7.1.4 | Dashboard: org-tree redesign with real `.harness/documents/` data |

package/assets/templates/AGENTS-ko /341/204/207/341/205/251/341/206/250/341/204/211/341/205/241/341/204/207/341/205/251/341/206/253.md"

@@ -0,0 +1,114 @@
+# AGENTS.md — {{PROJECT_NAME}}
+# walwal-harness v7.1 | Company Mode
+# 설치일: {{DATE}} | CLAUDE.md는 이 파일의 심볼릭 링크입니다.
+
+---
+
+## 1. 진입점
+
+Owner가 회사에 접근하는 명령은 두 개뿐이다. 그 외의 경로는 없다.
+
+| 명령 | 사용 시점 |
+|---|---|
+| `/goal` | 미션 설정, 수정, 추가 |
+| `/hot-fix` | 활성 goal과 독립된 긴급 수정 |
+
+`/ceo`, `/cto`, `/cqo`, `/coo`, `/cdo`, `/ops`, `/hiring`은 slash command가 아니다.
+내부 라우팅은 agent/skill wiring으로만 처리한다.
+
+---
+
+## 2. 행동 전 확인
+
+가정하지 않는다. 불명확한 것을 숨기지 않는다.
+
+- 구현 전 가정을 명시한다. 불확실하면 질문한다.
+- 여러 접근이 가능하면 모두 제시한다 — 조용히 선택하지 않는다.
+- 요청을 해결하는 최소한의 변경만 한다. 추측성 scope는 금지.
+- 불명확한 부분이 있으면 멈춘다. 무엇이 불명확한지 명시하고 질문한다.
+
+hot-fix: 가장 작은 올바른 패치만. 인접 코드를 "개선"하지 않는다.
+goal: CEO가 CXX에 라우팅하기 전에 검증 가능한 성공 기준을 정의한다.
+
+---
+
+## 3. Company 구조
+
+```
+Owner
+  └─ /goal 또는 /hot-fix
+      └─ harness-ceo          오케스트레이터 — Owner의 유일한 접점
+          ├─ harness-coo      리서치, 가설, 서비스 방향
+          ├─ harness-cdo      브랜딩, UI/UX, 디자인 리뷰
+          ├─ harness-cto      아키텍처, API, 플랫폼, 구현 총괄
+          ├─ harness-cqo      품질 게이트, 회귀, archive, gotcha/convention 관리
+          └─ harness-ops      빌드 모니터링, 로그 분석, 서비스 이벤트
+```
+
+각 CXX는:
+- **독립된 fresh session 컨텍스트**에서 실행된다 — CEO 세션과 메모리를 공유하지 않는다
+- 결정을 `.harness/documents/{mission_name}/{cxx}.md`에 기록한다
+- 모든 전문 작업을 hired worker에게 위임한다 — 직접 실행하지 않는다
+- 필요한 worker가 없으면 `harness-hiring`을 먼저 호출한다
+
+CEO는 worker 기록 없이 완료된 산출물을 포함한 CXX 보고서를 거부한다.
+
+---
+
+## 4. 미션 플로우
+
+### Goal
+
+1. CEO가 Owner 요청을 읽고 판단한다: 브레인스토밍 먼저, 또는 즉시 실행.
+2. CEO가 관련 CXX에게만 범위를 한정한 질문을 전달한다.
+3. 각 CXX가 worker를 고용하고, 위임하고, 결과를 수집하여 `{cxx}.md`에 기록한다.
+4. CEO가 CXX 산출물을 종합하여 다음 CXX에 라우팅하거나 Owner에게 보고한다.
+
+**완료 기준:** `.harness/documents/{mission_name}/ceo.md`에 최종 Owner 보고가 존재한다.
+
+### Hot Fix
+
+1. CEO가 긴급 요청을 받고 즉시 CTO와 CQO를 소집한다.
+2. CTO가 최소 패치 경로를 설계하고 구현 worker를 고용한다.
+3. Worker가 구현한다. CTO가 worker 증거를 검증하고 `cto.md`를 작성한다.
+4. CQO가 회귀 게이트를 실행한다. `.harness/gotchas/` 또는 `.harness/conventions/`에 교훈을 등록하고 `cqo.md`를 작성한다.
+5. CQO 판정 **PASS** 이후에만 archive한다.
+
+**완료 기준:** `cto.md`, `cqo.md`, 그리고 최소 하나의 신규 gotcha 또는 convention 항목이 존재한다.
+
+주의: harness 문서(ceo.md, cto.md, cqo.md, worker 보고서)에 대한 docmeta skip 판단은 미션 프로토콜 단계를 건너뛸 권한을 부여하지 않는다. 이 파일들은 분석 산출물이 아니라 미션 기록이다.
+
+---
+
+## 5. 하네스 런타임
+
+| 경로 | 역할 |
+|---|---|
+| `.harness/documents/{mission}/` | 미션별 CXX 결정 기록 및 worker 보고서 |
+| `.harness/conventions/` | 지속 규칙 (CQO가 작성, 미션을 넘어 유지) |
+| `.harness/gotchas/` | 재발 방지 기록 (CQO가 hot-fix마다 작성) |
+| `.harness/memories/` | 장기 공유 컨텍스트 |
+| `.harness/shared/HR-Resource/` | 채용 가능한 worker skill pool |
+| `.harness/archive/` | CQO 승인 완료 미션 (불변) |
+| `.harness/logs/YYYY-MM-DD/` | OPS 예외 로그 (비정상 케이스만) |
+
+`.harness/`는 미션 상태 저장소다. 빌드 산출물이 아니다. 삭제하지 않는다.
+
+---
+
+## 6. 금지 규칙
+
+1. **`{mission}/cto.md` 없이 소스 코드 편집 금지** — CTO의 범위 승인이 있어야 소스 파일을 수정할 수 있다.
+2. **CXX 사칭 금지** — 현재 모델이 CEO/CTO/CQO를 인라인으로 대행하지 않는다. 설치된 harness skill을 fresh session에서 사용한다.
+3. **이름 없는 worker 금지** — 모든 전문 작업은 `harness-hiring` → `harness-resource-manager`를 거친다.
+4. **CQO 판정 없이 archive 금지** — 명시적 PASS가 담긴 `{mission}/cqo.md`가 존재해야 한다.
+5. **gotcha 등록 생략 금지** — 모든 hot-fix는 `.harness/gotchas/` 또는 `.harness/conventions/`에 최소 하나의 항목을 만든다.
+6. **미션 중 이 파일 편집 금지** — AGENTS.md를 수정하려면 별도 `/goal`을 제출한다.
+
+---
+
+## 7. 프로젝트 컨텍스트
+
+- **기술 스택**: {{TECH_STACK}}
+- **프로젝트 구조**: {{PROJECT_STRUCTURE}}
+- **하네스 설치일**: {{DATE}}

package/assets/templates/AGENTS.md.template

@@ -108,6 +108,7 @@ Note: A docmeta skip decision on harness documents (ceo.md, cto.md, cqo.md, work
 8. **No CXX self-execution** — CXX agents coordinate and manage only. A CXX that produces deliverables without matching worker records has violated its scope. CEO must reject such reports.
 9. **No verdict without worker evidence** — CQO cannot issue ACCEPTED/REJECTED without a Worker Evidence Manifest referencing at least one evaluator worker. Self-inspection by CQO is not valid evidence.
 10. **Hierarchical worker ownership** — Hired workers are installed under `.claude/skills/{owning-cxx}/{worker}/` and `.codex/skills/{owning-cxx}/{worker}/`; mission worker reports live under `.harness/documents/{mission}/{owning-cxx}/workers/`. Flat `{mission}/workers/` reports are legacy and signal an ownership violation unless explicitly migrated.
+11. **Implementation Notes required** — `ceo.md`, every `{cxx}.md`, and every worker report must end with an English `## Implementation Notes` section containing `Design Decisions`, `Deviations`, `Tradeoffs`, and `Open Questions`. Use `None` for empty subsections.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "7.1.6",
+  "version": "7.1.8",
   "description": "Company-style AI agent harness for Claude and Codex. Installs commands, CXX agents, skills, HR-Resource hiring pool, and project-local .harness runtime state.",
   "bin": {
     "walwal-harness": "bin/init.js"

package/scripts/harness-worker-evidence-validate.sh

@@ -10,6 +10,16 @@ DOC_ROOT="$PROJECT_ROOT/.harness/documents"
 mode="${2:-text}"
 violations=()
 
+has_implementation_notes() {
+  local file="$1"
+  [ -s "$file" ] || return 1
+  grep -Eq '^##[[:space:]]+Implementation Notes[[:space:]]*$' "$file" &&
+    grep -Eq '^###[[:space:]]+Design Decisions[[:space:]]*$' "$file" &&
+    grep -Eq '^###[[:space:]]+Deviations[[:space:]]*$' "$file" &&
+    grep -Eq '^###[[:space:]]+Tradeoffs[[:space:]]*$' "$file" &&
+    grep -Eq '^###[[:space:]]+Open Questions[[:space:]]*$' "$file"
+}
+
 has_worker_report() {
   local mission_dir="$1"
   local owner="${2:-}"
@@ -29,6 +39,11 @@ for mission_dir in "$DOC_ROOT"/*; do
   [ -d "$mission_dir" ] || continue
   mission_name="$(basename "$mission_dir")"
 
+  ceo_path="$mission_dir/ceo.md"
+  if [ -s "$ceo_path" ] && ! has_implementation_notes "$ceo_path"; then
+    violations+=("$mission_name:ceo.md-missing-implementation-notes")
+  fi
+
   if has_legacy_flat_worker_report "$mission_dir"; then
     violations+=("$mission_name:legacy-flat-workers")
   fi
@@ -36,9 +51,20 @@ for mission_dir in "$DOC_ROOT"/*; do
   for cxx in coo cdo cto cqo ops; do
     cxx_path="$mission_dir/$cxx.md"
     [ -s "$cxx_path" ] || continue
+    if ! has_implementation_notes "$cxx_path"; then
+      violations+=("$mission_name:$cxx.md-missing-implementation-notes")
+    fi
     if ! has_worker_report "$mission_dir" "$cxx"; then
       violations+=("$mission_name:$cxx.md")
     fi
+    workers_dir="$mission_dir/$cxx/workers"
+    [ -d "$workers_dir" ] || continue
+    for worker_report in "$workers_dir"/*.md; do
+      [ -e "$worker_report" ] || continue
+      if ! has_implementation_notes "$worker_report"; then
+        violations+=("$mission_name:$cxx/workers/$(basename "$worker_report")-missing-implementation-notes")
+      fi
+    done
   done
 
   cqo_path="$mission_dir/cqo.md"