zugzbot 1.0.20 → 1.0.22

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/SKILL.md

@@ -1,129 +0,0 @@
----
-name: omd-lab-02-design-harness
-description: OmD Lab #02 — 디자인 하네스 정교화 실험. 동일 task를 v1, v2, v3... 버전별 하네스 설정으로 돌려서 산출물 품질·토큰 비용·iteration 수·persona ABANDON 율을 비교. 트리거 — '/omd-lab-02', '하네스 lab 시작', '디자인 하네스 v2 돌려서 비교', 'lab #02 자동 비교'.
----
-
-# OmD Lab #02 — Design Harness Refinement
-
-`omd:harness`의 정교화 작업을 위한 실험실. 동일한 design task를 *서로 다른 하네스 설정* (v1, v2, v3, ...)으로 돌려서 품질·비용·실패모드를 비교한다.
-
-## 왜
-
-Lab #01이 "DESIGN.md 유무"의 영향을 봤다면, Lab #02는 **하네스 자체의 설정**(prompt 변형, persona pool, eval rubric, asset 정책 등)이 산출물에 미치는 영향을 본다.
-
-## 디렉토리 구조
-
-```
-skills/omd-lab-02-design-harness/
-├── SKILL.md                       (this file)
-├── playbooks/
-│   ├── v1.md                      (현재 baseline — first full implementation)
-│   ├── v2.md                      (다음 실험 가설)
-│   └── ...
-├── runs/
-│   ├── v1-run-<ts>-<slug>/        ← omd:harness가 v1 설정으로 돌린 산출물 전체
-│   ├── v2-run-<ts>-<slug>/
-│   └── ...
-├── compare/
-│   ├── README.md                  (어떤 task로 어떤 v를 비교했는가)
-│   └── <task-id>/
-│       ├── index.html             (v1 vs v2 vs v3 동시 비교 뷰)
-│       └── metrics.json           (집계 비교 지표)
-└── postmortem-aggregate.md        (전 v 누적 학습)
-```
-
-## Lab Run 프로토콜
-
-### 새 v 정의 (Lab 운영자 — 사용자 또는 Claude)
-
-1. `playbooks/v<N>.md` 작성. 가설을 한 줄로:
-   ```
-   ## Hypothesis
-   v2 raises persona ABANDON budget from 3s → 5s, expecting fewer false-abandon and more useful friction signal.
-   ```
-2. v<N>이 v<N-1>과 *바꾸는 것 정확히 명시*. 1개 변수만 바꾸는 게 원칙.
-3. 변경 점이 sub-agent 프롬프트에 있으면 `playbooks/v<N>/agents-overrides/*.md`로 patch 보관.
-
-### Lab Run 실행
-
-```bash
-# 운영자가 수동 실행
-omd harness "<task>" --lab v2
-# 또는 사용자가 자연어:
-# "이 task를 lab v2 설정으로도 돌려서 v1과 비교해줘"
-```
-
-`--lab v<N>`이 들어오면:
-- `runs/v<N>-run-<ts>-<slug>/` 디렉토리에 산출물 적재
-- v<N>의 agent overrides가 있으면 그걸 임시로 `.claude/agents/`에 덮어씌운 채 실행 (run 종료 시 원복)
-- run.log에 `lab_version: v<N>` 기록
-
-### 비교 뷰 생성
-
-운영자가 동일 task에 대해 v1, v2, ..., vN의 run을 끝내면:
-
-```bash
-omd lab compare --task "<task-slug>" --versions v1,v2,v3
-```
-
-이게 `compare/<task-slug>/index.html`을 만든다. 4-패널 (또는 N-패널) 비교:
-- 각 v의 brief.md / 주요 wireframe / DESIGN.md.patch / persona ABANDON 요약 / 토큰 비용
-- 공통 metrics.json: per-v {iterations, total_tokens, persona_abandon_rate, deterministic_pass_rate, jury_score, time_to_handoff}
-
-### 비교 metrics 정의
-
-```json
-{
-  "task": "토스 스타일 가족 식단 앱 메인",
-  "versions": {
-    "v1": {
-      "iterations": 2,
-      "total_tokens_estimated": 320000,
-      "persona_abandon_rate": 0.5,
-      "deterministic_pass_rate": 1.0,
-      "jury_score_normalized": 0.72,
-      "time_to_handoff_min": 18,
-      "user_satisfied": "?"
-    },
-    "v2": { ... }
-  },
-  "delta_v1_v2": "v2 reduced persona_abandon_rate by 0.25 but raised total_tokens by 12% — net win on signal quality"
-}
-```
-
-## 진행 트랙 (이 Lab의 로드맵)
-
-| v | hypothesis | status |
-|---|---|---|
-| v1 | First full implementation — 8 agents, 10 phases, 3 user checkpoints | active baseline |
-| v2 | (TBD) | pending |
-| v3 | (TBD) | pending |
-
-`playbooks/v1.md`가 baseline 정의. 운영자는 매 회 새 가설로 v<N>.md를 추가한다.
-
-## postmortem-aggregate.md 정책
-
-매 lab run 종료 시, run의 `postmortem.md`에서 *cross-version-relevant* 신호만 발췌해 `postmortem-aggregate.md`에 누적:
-- 자주 발생하는 deterministic gate 실패
-- persona ABANDON 트리거 빈도 분포
-- 사용자가 가장 자주 reject하는 phase 출력
-- 토큰이 가장 많이 새는 sub-agent
-
-이게 다음 v의 가설을 만들어낸다.
-
-## 사용 예 (한 줄 시연)
-
-```
-사용자: "토스 스타일 결제 화면 — Lab #02로 v1, v2 비교"
-→ Claude: omd harness "..." --lab v1 실행 → v1-run 적재
-→ (사용자 체크포인트 진행, ship 결정)
-→ Claude: omd harness "..." --lab v2 실행 (동일 brief 재사용 가능)
-→ omd lab compare --task <slug> --versions v1,v2
-→ compare/<slug>/index.html 결과 제시
-```
-
-## 금지
-
-- v 정의 없이 run 적재 X (반드시 playbooks/v<N>.md 선행)
-- 동일 task의 동일 v 결과를 덮어쓰지 X (timestamp로 보존)
-- runs/ 정리 X (영구 보존)

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/playbooks/v1.md

@@ -1,105 +0,0 @@
-# Lab #02 — Playbook v1 (Baseline)
-
-**Date locked:** 2026-04-27
-**Status:** Active baseline
-**Hypothesis:** None (this is the reference implementation against which v2+ will measure).
-
-## Configuration snapshot
-
-| Dimension | v1 setting |
-|---|---|
-| Channels | Claude Code (primary), Codex (mirror — declarative parity) |
-| Phases | 10 (1 / 1.5 / 2 / 3 / 4 / 5 / 6 / 6.5 / 7 / 8 + handoff) |
-| Sub-agents | 8 (master, ux-researcher, asset-curator, ui-junior, microcopy, a11y-auditor, persona-tester, critic) |
-| Iteration cap | 3 |
-| User checkpoints | 3 mandatory (Phase 3 / Phase 5 / Phase 8) + 1 informational (Phase 1.5 asset choice) |
-| Discovery questions | 5-8 in one batch |
-| UX research parallelism | 2-3 ux-researcher agents |
-| Persona testing parallelism | 4 persona-testers (1 from §13 user-defined + 3 adversarial) |
-| Adversarial persona budget | 3s/step, ABANDON token strict |
-| Eval pipeline | deterministic gate → prompt-diversity Claude jury → persona walkthrough |
-| External API keys | NOT required — orchestration runs entirely inside Claude Code / Codex session |
-| Cross-family jury | Opt-in v2+ feature — v1 uses 3-judge prompt-diversity ensemble on host model |
-| Vision-LLM use | Triage only with Set-of-Mark |
-| Self-Refine cap | 2 retries gated on oracle signal |
-| Korean persona source | Nemotron-Personas-Korea lazy-load opt-in (PIPA-compliant) |
-| Asset fallback chain | Pinterest URL listing → Unsplash → Pexels → Lucide → Heroicons → unDraw → Mixkit → Coverr → brand-color SVG |
-| Asset Pinterest policy | URL listing only (TOS forbids scraping) |
-| Run archive | Permanent, content-addressed screenshots |
-| Token budget | None (per user: explicitly out of scope for v1) |
-
-## Agent prompts source
-
-The 8 prompts live at `.claude/agents/omd-*.md` (this repo) and `.codex/agents/omd-*.toml` (Codex mirror). v1 ships them verbatim.
-
-## Eval rubric (jury)
-
-LLM jury rates against 4 dimensions (0-5 each, no compound score):
-
-| Dimension | Rubric criteria |
-|---|---|
-| Voice fidelity | Forbidden phrases used: 0. Microcopy matches §10 register. |
-| State completeness | All 5 states (empty/loading/error/success/skeleton) present per screen. |
-| Principle adherence | No §12 Principle violations in wireframes/components. |
-| IA discipline | Every screen has entry, exit, error path. |
-
-Pairwise vs previous iteration, both orderings, position bias mitigated.
-
-## Persona pool (default)
-
-For Korean projects:
-- 1 from DESIGN.md §13 (user-defined; if missing, swap to nemotron 1×)
-- adversarial-impatient (3s budget)
-- adversarial-low-literacy
-- adversarial-brand-skeptic
-
-For English projects: same skeleton, persona prompts in English.
-
-## Success criteria for v1
-
-A v1 run is "successful" if:
-1. Reaches Phase 9 handoff without crash or infinite loop.
-2. All 3 mandatory user checkpoints honored (no auto-skip).
-3. handoff/v0.zip is non-empty and contains brief + DESIGN.md + wireframes + components/manifest.json + assets/.
-4. eval/deterministic.json verdict = "pass".
-5. ≥ 2/4 personas reach task_success = true.
-6. Total tokens stay under ANY single-day Claude Pro / ChatGPT Plus quota for an active user (informally tracked, not enforced).
-
-## Known v1 limitations (will guide v2-v3 hypotheses)
-
-- Cross-family jury graceful-degrades to single-family if user lacks GPT/Gemini keys → v2 candidate: enforce 2-family minimum or substitute with prompt-diversity ensemble.
-- Asset sourcing is API-key-gated (Unsplash / Pexels APIs); without keys, falls back to WebFetch on public pages → v2 candidate: ship with default API keys via package.json env-template, or bundle a public-domain seed pack.
-- Persona walkthrough simulation mode (no Playwright) loses motion/click realism → v2 candidate: bundle a static-HTML render layer so simulation has DOM to walk.
-- Korean persona pool requires user opt-in (license) → v2 candidate: pre-stage opt-in at first run instead of mid-flow.
-
-## Instrumentation (what v1 measures, mandatory for compare/)
-
-Every v1 run must emit `postmortem.md` with:
-
-```markdown
-- iterations: <N>
-- total_tokens_estimated: <approx based on agent log>
-- persona_abandon_rate: <abandons / total personas>
-- deterministic_pass_rate: <passes / total checks>
-- jury_score_normalized: <avg rubric score / 5>
-- time_to_handoff_min: <ISO end - ISO start, in minutes>
-- user_satisfied: yes | partial | no | unknown
-- user_reject_phases: [<phases user pushed back on>]
-- agent_token_breakdown:
-    omd-master: ~Xk
-    omd-ux-researcher (×3): ~Xk
-    ...
-- failure_modes_hit: [<list of named failure modes>]
-```
-
-`omd lab compare` reads these to build metrics.json.
-
-## Scope freeze
-
-v1 does NOT include:
-- Pixel rendering of components (delegated to v0/Cursor/Subframe)
-- A11y violations beyond axe-core + lighthouse (no manual heuristic walk)
-- Live A/B testing with real users (synthetic personas only)
-- Automatic API key acquisition (user provides)
-
-These are explicit scope decisions — moving them in is a v2+ change, not a v1 bug.

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/live-2026-04-27-water-app/feedback-log.md

@@ -1,230 +0,0 @@
-# Live Feedback Log — water-app first-run (2026-04-27)
-
-**Lab version:** v1 baseline
-**Task:** "물을 하루 3번 이상 음용하도록 유도하는 웹앱의 메인 화면"
-**Driver:** kwakseongjae (별도 Claude Code 세션)
-**Observer:** main session (this conversation) — applies critical fixes immediately, queues non-critical observations.
-
-## Triage policy
-
-| Severity | Definition | Action |
-|---|---|---|
-| **critical** | Run blocks / crashes / produces fundamentally wrong artifact / safety violation | Fix immediately in source, rerun affected step |
-| **major** | Causes user friction or wrong UX in the moment but run continues | Note here, fix between steps if cheap, otherwise after run |
-| **minor** | Quality / polish observation | Note here, batch into v2 playbook hypotheses |
-
-## Step-by-step log
-
-### Pre-flight
-- ✅ npm link done
-- ✅ install-skills extended to copy `.claude/agents/` and `.codex/agents/`
-- ✅ API-key warnings purged across 4 places (CLI / master / skill / playbook)
-- ✅ Question discipline (`[Q]`/`[C]` + ⭐ recommendation) added to omd-master
-- ✅ postinstall + install-skills outro + harness short-task-hint added
-
-### Step 1 — wipe + fresh init ✅
-- 2026-04-27 17:47 — empty `~/Desktop/projects/water-app/` confirmed
-
-### Step 2 — install-skills ✅
-- 8 agents installed: master / ux-researcher / asset-curator / ui-junior / microcopy / a11y-auditor / persona-tester / critic
-
-### Step 3 — install-skills v2 (re-run, clean) ✅
-- 2026-04-28 — `cd .. && rm -rf water-app && mkdir water-app && cd water-app` clean restart, then `omd install-skills --agent claude-code` → 19 files written.
-- ✅ 7 skills (.claude/skills/omd-*)
-- ✅ 8 agents (.claude/agents/omd-*) — generated from canonical agents/
-- ✅ 4 data files (.claude/data/{reference-fingerprints,reference-tags,vocabulary,synonyms}) — for skill-side semantic matching
-
-### Step 4 — /omd-harness in Claude Code (pending)
-
-### Step 5 — Phase 1 Discovery answers (pending)
-
-### Step 6+ — checkpoints (pending)
-
----
-
-## Critical fixes applied mid-flight
-
-### 2026-04-27 17:50 — `omd harness` CLI step folded into `/omd-harness` skill
-- **Reported by:** user — "왜 별도 CLI 호출이 필요한지 모르겠다 / 사용자 task 두 번 입력하는 꼴"
-- **Root cause:** Original design exposed 2 entry points (CLI bootstrap + skill spawn). The CLI is deterministic mkdir+slug+INDEX; the skill is the LLM-driven orchestrator. Splitting them was technical correctness without UX justification — user enters task twice.
-- **Fix:**
-  - `skills/omd-harness/SKILL.md` updated: skill now (a) extracts task from slash-arg or asks `[Q]` once, (b) finds latest run dir or calls `omd harness "<task>"` Bash internally to bootstrap, (c) reuses if task matches.
-  - CLI command (`omd harness "..."`) still works standalone for power users.
-  - User-facing entry point now a single `/omd-harness <task>`.
-- **Trade-off accepted:** skill must Bash-call CLI (one extra round-trip) but determinism (slug consistency, INDEX append) stays in compiled CLI not LLM prose.
-
-## Critical fixes applied mid-flight (continued)
-
-### 2026-04-27 17:55 — slash command 표기 `omd:harness` → `omd-harness` (Claude Code 컨벤션)
-- **Reported by:** user — "Unknown command: /omd:harness. Did you mean /omd-harness?" (Claude Code의 자동 안내)
-- **Root cause:** Claude Code의 슬래시 명령은 콜론(`:`)을 받지 않음. 스킬 frontmatter의 `name: omd:harness`는 namespace ID로 유효하지만, 사용자가 실제 입력하는 슬래시는 하이픈으로 정규화됨. 모든 user-facing 문서·메시지가 `/omd:harness`로 잘못 표기되어 있었음.
-- **Fix:** 7 파일 일괄 치환 (스크립트로):
-  - `src/cli/install-skills.ts` outro
-  - `src/cli/harness.ts` Next 패널 3곳
-  - `scripts/postinstall.cjs` 3곳
-  - `skills/omd-harness/SKILL.md` 트리거·설명
-  - `research/harness-design/06-omd-integration-design.md` 2곳
-  - `research/harness-design/docs-todo.md` 3곳
-  - 본 feedback-log.md 자체
-- **Trade-off accepted:** frontmatter `name: omd:harness`는 유지 (기존 `omd:init`/`omd:apply` 컨벤션 일관성). 사용자 입력만 하이픈.
-
-### 2026-04-27 18:15 — 질문 형식이 사용자에게 내부 분류(`[C]` + (a)(b)(c))를 그대로 누출
-- **Reported by:** user — "C하니까 AB는? 궁금증이 생김. 갑자기 C DESIGN 없음 이런식으로 뜨니까 당황스러워."
-- **Root cause:** `[Q]`/`[C]` 와 `(a)(b)(c)` 라벨링은 *agent 내부 분류 도구*로 설계했는데, 출력 그대로 넣어버림. 사용자는 시니어 디자이너가 옆에서 폼을 작성시키는 것처럼 느낌. UX 누출.
-- **Fix:**
-  - `omd-master.md` Question discipline 섹션 재작성: 분류는 internal-only, 출력은 자연 prose. 추천을 *문장*으로 리드하고 대안은 inline label(예: 또는 `init먼저` · `중단`)로.
-  - Phase 1 8개 질문 — `(a)(b)(c)` 사라짐, prose batch.
-  - Asset checkpoint #0 / Checkpoint #1, #2, #3 — 모두 prose 형식, 추천은 statement, 대안은 backtick label.
-  - SKILL.md DESIGN.md 분기 — 동일하게 prose.
-  - 금지 패턴 명시: `[Q]`/`[C]` 출력, `(a)(b)(c)` 라벨, ⭐ "추천" 태그 — 모두 X.
-- **Trade-off accepted:** 라벨 명료성 약간 줄어듦 (사용자가 원하면 *명시적* 옵션 라벨이 더 빠를 수도). v2 후보: 토글 가능하게 `omd config harness.question_style = prose|formal`.
-
-### 2026-04-27 18:25 — DESIGN.md 자동 부트스트랩 시 reference 하드코딩 ("toss")
-- **Reported by:** user — "왜 토스 레퍼런스로 자동 부트스트랩? 사용자가 init 하는거처럼 레퍼런스도 고르고 막 할 수 있게. 아니면 사용자 프로젝트 성격에 맞춰 추천을."
-- **Root cause:** SKILL.md DESIGN.md 분기에서 "toss reference로 자동 부트스트랩"이라고 하드코딩했음. OmD 철학(67 references 중 task에 맞춰 추천)과 정면 충돌. omd init은 이미 `omd init recommend` CLI로 top-5 추천을 제공하는데 하네스가 그걸 무시.
-- **Fix:**
-  - `skills/omd-harness/SKILL.md` step 2: `omd init recommend "<task>" --json --top 5` 호출 → top-5 reference + matchedKeywords 얻음 → 자연 prose로 제시 (1위는 statement-lead, 후보는 inline label).
-  - 사용자 응답 처리: `go`(=top1) / 명시적 ref id (top-5 안 또는 밖) / `init먼저` / `중단`.
-  - delta_set.warnings 감지 시 prose 위에 한 줄 알림.
-  - `omd-master.md` Phase 5: `chosen_ref_id`를 SKILL이 spawn args로 넘기므로 verbatim 사용. 없으면 master가 직접 `omd init recommend` 호출 + prose 제시. **Hardcode 금지** 명시.
-- **Consequence:** 사용자가 task에 맞는 reference (예: "헬스/웰니스 + calm-blue"면 toss 또는 line, "B2B SaaS dashboard"면 linear, "이커머스"면 stripe/shopify 등)를 자동 추천받음. 본인이 알고 있는 다른 reference도 한 줄로 override 가능.
-
-### 2026-04-27 18:40 — `omd harness` CLI를 hidden internal helper로 강등 + 진입점 단일화 (`/omd-harness`만)
-- **Reported by:** user — "왜 배시로 정적 기능을 호출? 그냥 다 있는데? 뭘 하는 기능?"
-- **Root cause:** CLI는 deterministic slug+mkdir helper인데 사용자에겐 *진입점*처럼 노출되어 있었음. UX 메시지·README·outro·docs 곳곳에서 `omd harness` CLI 직접 호출을 권장 → "왜 진입점이 두 개?" 인식 발생.
-- **Decision (option C):** 모든 사용자 진입은 skill/agent를 통해. CLI는 internal helper로 강등.
-- **Fix:**
-  - `bin/oh-my-design.ts`: `program.command('harness')` → `program.addCommand(harnessCmd, { hidden: true })`. `omd --help`에서 사라짐.
-  - `--internal` 플래그 추가: skill이 호출할 때 friendly UX(intro/outro/Next panel) 모두 스킵, single-line JSON만 emit (`{runId, runDir, taskFile, labVersion, designMdExists}`).
-  - `skills/omd-harness/SKILL.md`: `omd harness ... --internal` 호출 + JSON 파싱 명시.
-  - `src/cli/install-skills.ts` outro: "Power user CLI" 라인 제거.
-  - `AGENTS.md`: `omd harness` 직접 호출 섹션 → `/omd-harness` 단일 진입 명시. Codex 채널도 동일.
-  - `scripts/postinstall.cjs`: 이미 `/omd-harness`만 — 변경 불필요.
-- **Trade-off accepted:** CLI는 여전히 컴파일된 채로 남아있어 binary 크기 동일. Power user/CI 스크립팅이 정 필요하면 `--help`에 안 보여도 작동 (undocumented but stable).
-- **Verified:**
-  - `omd --help` → harness 명령 미노출 ✅
-  - `omd harness "..." --internal` → JSON 단일 라인 emit ✅
-
-### 2026-04-27 19:15 — v2 B-partial 마이그레이션 적용 완료
-- **Reported by:** user — "voice fingerprint 패턴 + oh-my-* 리서치 기반 재설계. 스킬화 + 러닝커브 적정선"
-- **Decision:** B-partial scope (A + B-partial + C + D), C(전부 pure-skill 도입)는 v3 candidate로 보류.
-- **Applied:**
-  - **A. `agents/` portable source-of-truth** — `agents/omd-*.md` 8개를 canonical로 격상. `install-skills`가 `parseCanonicalAgent()` + `renderClaudeAgent()` / `renderCodexAgent()`로 Claude/Codex 채널별 generate. `.claude/agents/` 와 `.codex/agents/` 는 generated artifact.
-  - **B-partial — `omd init recommend` 제거**: SKILL.md가 직접 `data/reference-fingerprints.json` (67 ref voice fingerprint manifest, 병렬 7-agent 추출 결과) + `reference-tags.md` + `vocabulary.json` Read해서 의미 매칭. Hallucination 방지 (id 검증).
-  - **B-partial — data assets 자동 install**: `installDataFile()` 추가. 4 data files (`reference-fingerprints.json`, `reference-tags.md`, `vocabulary.json`, `synonyms.json`) 가 `.claude/data/` / `.codex/data/`로 복사.
-  - **B-partial — 유지**: `omd harness --internal` (slug), `omd init prepare` (delta_set), `omd remember` (preferences format), `git apply`, `npx axe-core/lighthouse`.
-  - **C. Numbered-9s 가드레일**: `omd-master.md` 끝에 9/99/999/.../99999999 anti-pattern 박음 (Ralph 패턴).
-  - **C. `agents/AGENT.md` (54줄)**: Ralph 컨텍스트 카드 — identity / stack / dir map / core architecture / brand non-negotiables / numbered-9s / 어디 보면 좋을지.
-  - **D. Voice fingerprints**: 7 parallel agents × 67 references → `data/reference-fingerprints.json`. Categories canonicalized (10 buckets). water-app sanity check: toss/line이 정확히 1-2위 매칭.
-- **Trade-off accepted:** `omd init prepare` (delta_set 200줄) + `omd remember` (preferences 포맷) 는 KEEP — 안정성 vs 순도 trade-off에서 안정성 선택. v3 candidate.
-- **Verified:**
-  - `npm run lint` ✅
-  - `npm run build` ✅
-  - `npm test` 505/505 ✅
-  - End-to-end install-skills (clean dir) → `.claude/agents/` 8 files + `.claude/data/` 4 files emit ✅
-  - Self-install --force on this repo → `.claude/agents/omd-master.md` 에 numbered-9s 7회 매칭 ✅
-- **Generated artifact policy**: `.claude/agents/` `.codex/agents/` 은 commit 가능하지만 source-of-truth 아님. `agents/` 만 편집, 나머지는 `omd install-skills --force`로 regenerate.
-
-### 2026-04-28 10:25 — Subagent registration session caching (critical, fixed)
-- **Reported by:** user — Phase 1 시작 직전 `Error: Agent type 'omd-master' not found. Available agents: claude-code-guide, Explore, general-purpose, Plan, statusline-setup`. master + 7 sub-agent 모두 dispatch 불가.
-- **Root cause:** Claude Code는 *세션 시작 시점*에만 `.claude/agents/*.md`를 subagent로 로드. `omd install-skills`를 세션 *띄운 후*에 실행한 경우, 그 세션에는 로드 안 됨. 첫-사용자 100%가 부딪힐 함정.
-- **Fix applied:**
-  - `src/cli/install-skills.ts` outro에 노란색 ⚠ 경고 추가: "Already-running CLI session? Restart it ... Claude Code only loads .claude/agents/*.md at session start."
-  - `skills/omd-harness/SKILL.md` Step 0 추가: subagent registration verify, fail 시 사용자에게 재시작 안내 + general-purpose fallback 옵션 명시.
-  - 빌드 + npm link 즉시 반영.
-- **User mid-flight 우회:** 세션 종료 → `claude` 재실행 → `/omd-harness <task>` 재호출 (기존 run dir 자동 재사용).
-- **Verified:** outro 빌드 후 새 install에서 경고 표시되는지 다음 install 때 확인.
-
-### 2026-04-28 10:43 — Subagent frontmatter parsing 실패: HTML 주석이 `---` 앞에 있어서 Claude Code가 파일 무시 (CRITICAL, fixed)
-- **Reported by:** user — `/agents` Library 탭에 "No agents found" 표시 (built-in 5개만), 8 omd-* subagent가 *물리적으로 .claude/agents/에 있는데도* 인식 안 됨.
-- **Root cause:** `installAgentFile()`이 매 파일에 `<!-- omd:installed-skill — managed by ... -->` HTML 주석을 frontmatter (`---`) 앞에 prepend. Claude Code의 subagent 로더는 frontmatter가 *파일 첫 줄*이어야 인식. 주석 한 줄 = 모든 8 agent 무시.
-- **이 결함이 v2 마이그레이션 동안 안 잡힌 이유:** smoke test(`omd install-skills` + 파일 존재 확인 + frontmatter content 확인)는 통과했지만 *실제 Claude Code session에서 subagent로 등록되는지* 까지 검증 안 함. 통합 테스트 부재.
-- **Fix:**
-  - `renderClaudeAgent()` — managed marker를 HTML 주석 → frontmatter 안의 `omd_managed: true` 필드로 이동. Claude Code는 unknown frontmatter field를 무시하므로 안전.
-  - `installAgentFile()` — Claude 채널은 `headerForChannel` 안 쓰고 rendered 그대로. Codex는 TOML이라 leading `#` 주석 OK.
-  - Drift detection sentinel 변경: Claude는 `\nomd_managed:\s*true\b` 정규식, Codex는 `# omd:installed-agent` 그대로.
-- **Verified:** clean install → `head -5 .claude/agents/omd-master.md` → 첫 줄이 `---` ✅. 505 tests pass ✅.
-- **Lesson learned (queue for v3 hypothesis):** v3 또는 다음 patch에서 *integration test* 추가 — Claude Code session에서 `/agents` 출력을 mocking하거나 실제 Claude Code CLI 호출해서 subagent registration 검증.
-
-### 2026-04-28 10:55 — 모델 분배 quality-up (v2.1)
-- **Reported by:** user — "haiku가 왜 저렇게 많고, research같은건 opus 시켜야하는건 아니야? 사용자가 토큰을 조금 더 쓰더라도 성능에 만족감을 느껴야해."
-- **Decision:** cost-conservative → quality-first 재조정. 사용자 명시 의지("토큰 더 쓰더라도 만족감") 존중.
-- **Mapping:**
-  - omd-master: sonnet → **opus** (orchestrator, user-facing, 깊은 추론)
-  - omd-critic: sonnet → **opus** (root cause 추적, 표면 패치 차단)
-  - omd-ux-researcher: haiku → **sonnet** (semantic 매칭, Tier-1 DS 식별)
-  - omd-microcopy: haiku → **sonnet** (글쓰기 품질 직접 드러남)
-  - omd-persona-tester: haiku → **sonnet** (페르소나 character 유지, sycophancy 깨기)
-  - omd-asset-curator: haiku → **sonnet** (클리셰 stockphoto 회피 = taste 판단)
-  - omd-ui-junior: **sonnet** 유지
-  - omd-a11y-auditor: **haiku** 유지 (axe-core/lighthouse 결과 파싱, mechanical)
-- **Final 분포:** 2 opus + 5 sonnet + 1 haiku
-- **비용 영향:** v2 baseline ~$0.15/iteration → ~$0.50-0.70/iteration (3-iteration cap에서 ~$1.5-2/run)
-- **Verified:** `grep "^model:" agents/omd-*.md` → 8/8 정상
-
-### 2026-04-28 11:05 — master의 응답이 사용자에게 relay 안 됨, launcher가 메타 요약만 출력 (CRITICAL, fixed)
-- **Reported by:** user — `go` 답한 후 master spawn 22.7K tokens · 24s 동안 작업 → launcher가 "Phase 1 Discovery 체크포인트에서 멈췄습니다. 8개 질문에 답해주세요." 만 출력. 8개 질문 본문이 사라짐. user "뭐 이게 뭔데?" 혼란.
-- **Root cause:** omd-harness SKILL.md "Master 호출" 섹션이 launcher에게 master 응답을 relay하라고 *명시 안 함*. "스킬은 더 이상 일하지 않는다 — master가 user-facing 응답을 책임진다" 만 적혀있어서, launcher가 자기 판단으로 master output을 요약/메타 처리. master는 Agent return value로 반환했으나 launcher가 piping 안 함.
-- **Fix:**
-  - `skills/omd-harness/SKILL.md` — "Master 호출" 섹션에 **CRITICAL: 응답 relay** 블록 추가. ❌ 요약 / ❌ 메타 코멘트 / ❌ 자체 prose 추가 금지, ✅ master의 return text 그대로 1:1 출력 명시. 모든 spawn에 적용.
-  - `agents/omd-master.md` — Output discipline 섹션 끝에 **Sub-agent return value contract** 추가. master에게 "최종 응답은 user-facing prose여야 한다, 'Phase 1 stopped' 같은 상태문 X, 마지막 메시지가 곧 사용자가 보는 메시지" 명시.
-- **Lesson learned:** Claude Code Agent 툴은 sub-agent의 return text를 caller가 명시적으로 출력해야 user에게 보임. 자동 piping 안 됨. Skill 프롬프트는 *행동 규칙*을 명시해야지 "스킬은 일 안 한다" 같은 모호한 표현 금지.
-- **Verified:** 빌드 통과. 사용자가 install --force + reload + 재호출 시 master prose가 그대로 보일 것 (다음 검증 단계).
-
-### 2026-04-28 11:30 — Phase 1 8-question prose batch가 "고봉밥" — Picker UI로 전환 (CRITICAL UX, fixed)
-- **Reported by:** user — "질문은 너무 좋은데, 너무 고봉밥이라서 답변하기가 힘들어. 단계적으로 물어보거나(하나씩), 방향키 등으로 선택하거나 뭔가 고르게 하는 방식은 하기 힘들겠지?"
-- **Root cause:** Phase 1을 prose로 8개 한 번에 던짐 → 사용자 인지 부담. 답변 시 8개 모두 떠올려서 prose로 적어야 함.
-- **Solution explored:** Claude Code의 `AskUserQuestion` 툴 발견 (deferred tool list). 1-4 questions per call, 각 2-4 options + "Other" 자동 free-text fallback. Native picker UI.
-- **Fix:**
-  - `agents/omd-master.md` tools 필드에 `AskUserQuestion` 추가.
-  - Phase 1 protocol 재작성: **2 rounds × 4 questions via AskUserQuestion** (8 questions in 1 prose batch → 2 picker rounds).
-    - Round 1: 타겟 사용자 / 톤 / 핵심 동작 / 거부 default (multiSelect 활용)
-    - Round 2: 성공 기준 / 접근성 / 에셋 정책 / 참고 URL
-    - 각 옵션에 description (trade-off 한 줄)
-    - "Recommended" 표시는 첫 옵션 label에 `(Recommended)` (⭐ 이모지 X)
-  - User checkpoint #0/#1/#2/#3도 모두 `AskUserQuestion` 사용 (prose halt + go/fix/stop → picker UI)
-  - Fallback: AskUserQuestion 없으면 prose sequential mode (round당 1-2 질문).
-- **Token cost analysis:** AskUserQuestion은 단일 master spawn 내에서 inline tool call이라 추가 spawn 없음. 같은 1-spawn에서 2 picker rounds 모두 처리. 비용 변화 거의 없음 (오히려 prose 길이 줄어 약간 ↓).
-- **Verified:** lint + build + 505 tests pass.
-- **Migration impact:** master.md 변경 → install --force 필요. 8개 질문 형태 완전히 바뀜.
-
-### 2026-04-28 16:50 — Subagent의 AskUserQuestion 호출 불가 → file-based handoff 아키텍처 (CRITICAL, fixed)
-- **Reported by:** user — Phase 1에서 master가 prose 8개 다시 던짐. AskUserQuestion 호출 시도 안 됨. user 좌절: "지금 뭐 시작단계도 제대로 안되는데 뭘 자꾸 계속하래"
-- **Root cause:** `AskUserQuestion`은 Claude Code 메인 thread 전용 인터랙티브 툴. Subagent (Agent({subagent_type:"omd-master"})로 spawn된)는 headless 실행이라 user 입력 대기 못 함. master frontmatter에 tool 추가해도 호출 시 결과 없음/falls back to prose.
-- **Solution architecture (방향 A):** **file-based handoff loop** — subagent와 main-thread 사이 JSON 파일로 통신
-  - master subagent: `.handoff.json` + `<checkpoint_id>.questions.json` 작성 → 짧은 prose 반환
-  - launcher (skill, main thread): handoff 읽음 → user_prose 출력 → AskUserQuestion(questions) 호출 → answers.json 저장 → master 재spawn
-  - status=done까지 loop (safety cap 12 spawns)
-- **Fix applied:**
-  - `agents/omd-master.md`:
-    - `tools` 필드에서 `AskUserQuestion` 제거 (어차피 못 씀)
-    - 새 "Handoff protocol" 섹션 추가 — `.handoff.json` 스키마 (`status: ask_user|done|error`, `checkpoint_id`, `questions_file`, `user_prose`)
-    - Phase 1 protocol 재작성 — Round 1/2 모두 file-based handoff (master는 questions.json 작성, return은 짧은 status)
-  - `skills/omd-harness/SKILL.md`:
-    - "Master 호출" 섹션 완전 재작성 — handoff loop 의사코드 명시
-    - launcher가 main thread에서 AskUserQuestion 호출 (subagent 아니라 가능)
-    - 12 spawn safety cap, status별 분기 (done/error/ask_user)
-- **Migration impact:** master.md + SKILL.md 둘 다 변경 → install --force + 세션 reload 필요. 기존 run dir의 task.md만 보존, 진행 상태(.handoff.json) 없으면 처음부터 다시.
-- **Verified:** lint + build + 505 tests pass.
-- **Lesson learned (for v3 hypothesis):** subagent vs main-thread tool distinction은 Claude Code 플랫폼 핵심 제약. 새 agent 디자인 시 *어느 thread에서 무엇을 할 수 있나* 먼저 설계. v3에 integration test 추가 (실제 spawn해서 handoff loop 동작 확인).
-
-## Major / minor observations queued for batch fix
-
-### 2026-04-27 19:30 — install-skills auto-detect의 partial-leftover 문제 (major, queued)
-- **Reported by:** user — `.claude .codex .omd` 만 `rm -rf` 했는데 `.opencode/` 가 남아서 detector가 opencode만 감지 → claude-code/codex install 누락. "0 skill files written" 출력.
-- **Root cause:** `autoDetectTargets()` 가 한 번이라도 emit된 channel dir이 있으면 그것만 타겟으로. 파셜 잔재 시 의도와 다른 결과.
-- **현재 우회**: `--agent claude-code --agent codex` 명시 또는 `rm -rf .claude .codex .opencode .omd` 풀 정리.
-- **Proposed fix (v2.1 patch)**:
-  - 옵션 A: detection 로직을 "ANY channel 있으면 ALL channels install" 로 변경 (안전 + 사용자 누락 0)
-  - 옵션 B: auto-detect 결과를 install 시 prose로 알리기 + 사용자 확인 (`Detected: opencode. Also install for claude-code/codex? [Y/n]`)
-  - 옵션 A 권장 (idempotent, no prompt). 다음 v2 검증 끝나면 즉시 패치.
-
-## Hypotheses for v2 playbook (carried forward, queued for v3+)
-
-- **H1 — Question style toggle.** 자연 prose 기본 + `formal` 옵션 (라벨 (a)(b)(c) 명시) — 사용자 선호 분기 가능. `omd config harness.question_style`.
-- **H2 — Slash command discoverability.** Claude Code의 `/omd-harness` 자동 안내가 "skill: ✕ command: ✓"로 거부 → 첫 사용자에게 마찰. v2: install-skills outro에 "슬래시는 하이픈이에요 — `/omd-harness`" 명시. **Done in v2.**
-- **H3 — Stop-hook re-prompting** (settings.json hook). User checkpoint 자동 재진입. v3 candidate.
-- **H4 — Pure-skill `omd init prepare`/`omd remember` port.** delta_set 로직 + preferences 포맷을 스킬 프로즈에 인코드. 안정성 검증 후 진행. v3+ candidate.
-- **H5 — Tmux 다중 CLI fan-out.** Claude + Codex + Gemini 페인 동시 — oh-my-claudecode 패턴. v3 candidate.
-- **H6 — voice-fingerprint manifest 자동 갱신**: 빌드 타임 스크립트로 reference 추가/수정 시 자동 재생성. 현재는 일회성 batch.
-

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/README.md

@@ -1,46 +0,0 @@
-# v4 Self-Test Loop — autonomous validation
-
-**Date:** 2026-04-29
-**Goal:** v4 풀구현이 *진짜로* 작동하는지 자동 검증 + 발견된 critical 이슈 자체 fix.
-**Approach:** 4 persona × N iterations × audit/fix cycle. 토큰/시간 무시. 사용자에게 묻지 않음.
-
-## 구조
-
-```
-v4-self-test/
-├── README.md                       (이 파일)
-├── fixtures/                       — 4 persona별 mock 프로젝트
-│   ├── vibe-coder/                  (Next.js + Tailwind, mid-size)
-│   ├── junior-designer/             (Figma URL ref + 부분 코드)
-│   ├── founder/                     (empty + Stripe URL ref)
-│   └── senior-dev/                  (Next.js + opinionated tooling)
-├── scenarios/                       — 각 persona별 시나리오 walk-through
-│   ├── V-water-app.md
-│   ├── J-figma-import.md
-│   ├── F-stripe-clone.md
-│   └── S-prototype-cleanup.md
-├── iterations/
-│   ├── i1-audit/                    (1차 audit 결과)
-│   ├── i1-fixes/                    (1차 fix 적용 기록)
-│   ├── i2-audit/
-│   └── ...
-├── findings.md                      (누적 critical/major 이슈)
-└── postmortem.md                    (최종 회고)
-```
-
-## 사이클
-
-각 iteration:
-1. **Unit test 강화** — `test/v4/*.test.ts` 로 각 모듈 검증 + 발견 버그 fix
-2. **Audit subagent × 4 (parallel)** — 각 persona 입장에서 master/skill prompt + 코드 review, 시나리오 walk-through 시뮬레이션
-3. **Critic subagent** — 4 audit 결과 종합, severity 분류
-4. **Apply critical fixes** — 코드 수정 + 재빌드 + re-test
-5. **Re-audit** (loop) — N=3 또는 critical=0까지
-
-## 종료 조건
-
-- N=3 도달 OR
-- critical 이슈 0 + major 이슈 < 3 OR
-- 자가 진단 결과 "shippable for first-time user demo"
-</content>
-</invoke>

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/founder/README.md

@@ -1,7 +0,0 @@
-# billing-saas
-
-A B2B billing SaaS dashboard. Aiming for Stripe-like clarity but Korean market.
-
-Reference: https://stripe.com/atlas
-
-(empty repo — to be designed via OmD harness)

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/junior-designer/src/components/Hero.tsx

@@ -1 +0,0 @@
-export function Hero(){ return <div className="bg-orange-500">hero</div>; }

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/junior-designer/src/components/Project.tsx

@@ -1 +0,0 @@
-export function Project(){ return <article>project</article>; }

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/senior-dev/src/components/Accordion.tsx

@@ -1,4 +0,0 @@
-import { forwardRef } from 'react';
-export const Accordion = forwardRef<HTMLDivElement, { className?: string }>(function Accordion({ className = '' }, ref) {
-  return <div ref={ref} className={`px-3 py-2 rounded-md ${className}`} data-component="Accordion">Accordion</div>;
-});

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/senior-dev/src/components/Alert.tsx

@@ -1,4 +0,0 @@
-import { forwardRef } from 'react';
-export const Alert = forwardRef<HTMLDivElement, { className?: string }>(function Alert({ className = '' }, ref) {
-  return <div ref={ref} className={`px-3 py-2 rounded-md ${className}`} data-component="Alert">Alert</div>;
-});

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/senior-dev/src/components/Avatar.tsx

@@ -1,4 +0,0 @@
-import { forwardRef } from 'react';
-export const Avatar = forwardRef<HTMLDivElement, { className?: string }>(function Avatar({ className = '' }, ref) {
-  return <div ref={ref} className={`px-3 py-2 rounded-md ${className}`} data-component="Avatar">Avatar</div>;
-});

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/senior-dev/src/components/Badge.tsx

@@ -1,4 +0,0 @@
-import { forwardRef } from 'react';
-export const Badge = forwardRef<HTMLDivElement, { className?: string }>(function Badge({ className = '' }, ref) {
-  return <div ref={ref} className={`px-3 py-2 rounded-md ${className}`} data-component="Badge">Badge</div>;
-});

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/senior-dev/src/components/Breadcrumb.tsx

@@ -1,4 +0,0 @@
-import { forwardRef } from 'react';
-export const Breadcrumb = forwardRef<HTMLDivElement, { className?: string }>(function Breadcrumb({ className = '' }, ref) {
-  return <div ref={ref} className={`px-3 py-2 rounded-md ${className}`} data-component="Breadcrumb">Breadcrumb</div>;
-});

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/senior-dev/src/components/Button.tsx

@@ -1,4 +0,0 @@
-import { forwardRef } from 'react';
-export const Button = forwardRef<HTMLDivElement, { className?: string }>(function Button({ className = '' }, ref) {
-  return <div ref={ref} className={`px-3 py-2 rounded-md ${className}`} data-component="Button">Button</div>;
-});

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/senior-dev/src/components/Card.tsx

@@ -1,4 +0,0 @@
-import { forwardRef } from 'react';
-export const Card = forwardRef<HTMLDivElement, { className?: string }>(function Card({ className = '' }, ref) {
-  return <div ref={ref} className={`px-3 py-2 rounded-md ${className}`} data-component="Card">Card</div>;
-});

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/senior-dev/src/components/Combobox.tsx

@@ -1,4 +0,0 @@
-import { forwardRef } from 'react';
-export const Combobox = forwardRef<HTMLDivElement, { className?: string }>(function Combobox({ className = '' }, ref) {
-  return <div ref={ref} className={`px-3 py-2 rounded-md ${className}`} data-component="Combobox">Combobox</div>;
-});

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/senior-dev/src/components/DataTable.tsx

@@ -1,4 +0,0 @@
-import { forwardRef } from 'react';
-export const DataTable = forwardRef<HTMLDivElement, { className?: string }>(function DataTable({ className = '' }, ref) {
-  return <div ref={ref} className={`px-3 py-2 rounded-md ${className}`} data-component="DataTable">DataTable</div>;
-});

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/senior-dev/src/components/Dialog.tsx

@@ -1,4 +0,0 @@
-import { forwardRef } from 'react';
-export const Dialog = forwardRef<HTMLDivElement, { className?: string }>(function Dialog({ className = '' }, ref) {
-  return <div ref={ref} className={`px-3 py-2 rounded-md ${className}`} data-component="Dialog">Dialog</div>;
-});

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/senior-dev/src/components/Drawer.tsx

@@ -1,4 +0,0 @@
-import { forwardRef } from 'react';
-export const Drawer = forwardRef<HTMLDivElement, { className?: string }>(function Drawer({ className = '' }, ref) {
-  return <div ref={ref} className={`px-3 py-2 rounded-md ${className}`} data-component="Drawer">Drawer</div>;
-});

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/senior-dev/src/components/Field.tsx

@@ -1,4 +0,0 @@
-import { forwardRef } from 'react';
-export const Field = forwardRef<HTMLDivElement, { className?: string }>(function Field({ className = '' }, ref) {
-  return <div ref={ref} className={`px-3 py-2 rounded-md ${className}`} data-component="Field">Field</div>;
-});

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/senior-dev/src/components/Form.tsx

@@ -1,4 +0,0 @@
-import { forwardRef } from 'react';
-export const Form = forwardRef<HTMLDivElement, { className?: string }>(function Form({ className = '' }, ref) {
-  return <div ref={ref} className={`px-3 py-2 rounded-md ${className}`} data-component="Form">Form</div>;
-});

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/senior-dev/src/components/Input.tsx

@@ -1,4 +0,0 @@
-import { forwardRef } from 'react';
-export const Input = forwardRef<HTMLDivElement, { className?: string }>(function Input({ className = '' }, ref) {
-  return <div ref={ref} className={`px-3 py-2 rounded-md ${className}`} data-component="Input">Input</div>;
-});

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/senior-dev/src/components/Menu.tsx

@@ -1,4 +0,0 @@
-import { forwardRef } from 'react';
-export const Menu = forwardRef<HTMLDivElement, { className?: string }>(function Menu({ className = '' }, ref) {
-  return <div ref={ref} className={`px-3 py-2 rounded-md ${className}`} data-component="Menu">Menu</div>;
-});

package/.opencode/oh-my-design/skills/omd-lab-02-design-harness/runs/v4-self-test/fixtures/senior-dev/src/components/Modal.tsx

@@ -1,4 +0,0 @@
-import { forwardRef } from 'react';
-export const Modal = forwardRef<HTMLDivElement, { className?: string }>(function Modal({ className = '' }, ref) {
-  return <div ref={ref} className={`px-3 py-2 rounded-md ${className}`} data-component="Modal">Modal</div>;
-});