zugzbot 1.0.20 → 1.0.22

package/.opencode/oh-my-design/skills/omd-experiment-gallery/SKILL.md

@@ -1,164 +0,0 @@
----
-name: omd:experiment-gallery
-description: "N개 brand experiment를 한 화면에서 비교하는 gallery index.html을 생성. 각 카드는 brand name, wow rating, multi-turn refinement deltas, iframe scaled preview, standalone link 포함. '결과물 한 번에 보여줘', '갤러리 만들어', '5개 비교 뷰', 'experiment 결과 정리' 류 트리거. omd:harness가 N개 brand batch 작업 끝낸 직후 자동 호출되거나 사용자가 명시적으로 호출."
----
-
-# omd:experiment-gallery — N-brand comparison index
-
-## 왜 이 스킬
-
-여러 brand experiment를 돌리고 나면 결과물 검수가 산만 — 각 폴더 따로 열고 비교하기 번거로움. 이 skill은 **단일 `index.html`** 에 N개 결과를 iframe으로 박아서 한 화면에서 wow ratings + deltas + 실제 렌더를 동시 확인.
-
-## 트리거
-
-- 명시: "결과물 한 번에 보여줘", "갤러리 만들어", "N개 비교 뷰"
-- 묵시: 사용자가 omd:harness로 ≥2개 brand experiment를 한 batch에서 끝낸 직후 ("이제 비교해보자" 라는 흐름)
-- 다른 skill 안에서 호출: omd:batch-launch가 5개 brand 끝낸 후 Phase 5로 호출
-
-## 입력
-
-다음 둘 중 하나:
-
-1. **명시 디렉토리 list**: 사용자가 `/tmp/omd-gallery/{brand1,brand2,brand3}` 같은 list 제공
-2. **부모 디렉토리 + glob**: `/tmp/omd-gallery/*` 또는 `web/experiments/2026-05/*` 등 — skill이 자동 enumerate
-
-각 brand 디렉토리는 다음 파일들 있어야 함 (있으면 사용, 없으면 fallback):
-- `landing.html` (필수) — iframe src
-- `DESIGN.md` (선택) — brand display name 추출
-- `assets/_reference/<id>/structure.json` (선택) — composition 메타
-- `assets/_reference/<id>/.live-inspect-proof.json` (선택) — live tag 표시
-- `screenshots/after.png` (선택) — fallback preview
-- `experiment-meta.json` (선택, 권장) — wow rating + round-2 deltas + 카테고리 — sub-agent가 작성
-
-## experiment-meta.json 스키마 (sub-agent가 작성)
-
-각 experiment sub-agent는 work 종료 직전 다음 파일을 작성:
-
-```json
-{
-  "brand_id": "toss",
-  "brand_korean": "토스",
-  "brand_category": "Fintech",
-  "brand_color_hex": "#3182f6",
-  "wow_rating": 7.5,
-  "lines": 603,
-  "live_inspect": { "ran": true, "raw_samples": 7, "method": "playwright|harness" },
-  "round2_deltas": [
-    "Reveal failsafe — 2s forwards animation",
-    "Stat-card narrative upgrade",
-    "CTA copy 구체화 (시간 약속)",
-    "Hero shimmer (accent text gradient)",
-    "Dark marquee band rhythm break",
-    "Chart stroke-dashoffset draw-in"
-  ],
-  "ip_compliance": {
-    "your_logo_placeholders": 2,
-    "your_product_name_placeholders": 4,
-    "brand_logo_embed_count": 0,
-    "verbatim_brand_copy": 0
-  },
-  "honest_gaps": [
-    "Hero composition은 single character + flat card (3D ornament 부재)",
-    "Carousel은 dot만 회전 (slide content 미스왑)"
-  ]
-}
-```
-
-skill이 이 파일을 읽어 gallery 카드의 wow / lines / deltas 영역 채움. 없으면 brand_id만으로 minimal 카드.
-
-## 출력
-
-### 1. `<output-dir>/index.html` (메인 산출물)
-
-다음 구조:
-
-- 헤더: title (사용자가 batch 명령에서 받은 raw — "한국 brand 5선" 등), kicker (date · brand 수), meta (version · skill chain · mode)
-- main grid: brand 1개당 card 1개
-  - card head: brand mark (CSS-generated initial chip 또는 DiceBear shapes if brand has known color) + 한글명 + id + wow rating
-  - frame-wrap: aspect-ratio 16:10 iframe (scale 50%로 200%×200% iframe rendering — 모바일은 100%)
-  - card foot: voice note 1줄 + tags chips + round-2 deltas ol
-- footer summary: 모든 brand wow/lines/proof/round-2 핵심 1줄 테이블
-- system-note: 적용된 skill 버전의 시스템 fix들 한 단락
-
-### 2. CSS 스타일 가이드
-
-- typography: Pretendard from jsdelivr (SIL OFL). 디스플레이는 본문 헤더에만 (`clamp(36px,4.4vw,56px) / weight 800 / letter-spacing -0.04em`)
-- 다크 surface (`#0b0d10`) — gallery는 dark mode가 정석 (검토 환경 자체가 광원이 되도록)
-- accent: gradient `linear-gradient(135deg, #7c5cfc 0%, #fa2e5f 50%, #04c584 100%)` — Stripe-like
-- card: `bg #13161b`, border `#252b35`, hover `border #7c5cfc` + `translateY -2px`
-- 반응형: ≥1100px 2-col grid, <1100px 1-col
-
-### 3. iframe scaling
-
-```css
-.frame-wrap { aspect-ratio: 16/10; background: #fff; overflow: hidden; position: relative; }
-.frame-wrap iframe {
-  position: absolute; top: 0; left: 0;
-  width: 200%; height: 200%;
-  transform: scale(.5); transform-origin: top left;
-  border: 0;
-}
-.open-link {
-  position: absolute; top: 12px; right: 12px;
-  background: rgba(11,13,16,.7); color: #fff;
-  padding: 6px 12px; border-radius: 999px;
-  font-size: 11px; backdrop-filter: blur(8px);
-}
-```
-
-200% × scale(.5)는 모바일 viewport에서도 데스크탑 layout 그대로 렌더하기 위함 (iframe 본인은 1280-1920px 가정).
-
-### 4. 정적 vs 서버 모드
-
-- iframe src는 **상대 경로** (`./toss/landing.html`) — 정적 file:// open 안 됨 (CORS), `python3 -m http.server <port>` 추천
-- skill 끝에 사용자에게 "서버 띄우는 명령" 출력:
-  ```
-  cd <output-dir> && python3 -m http.server 8770
-  open http://localhost:8770/index.html
-  ```
-
-## 실행 절차
-
-1. **입력 검증**: 디렉토리 list parsed, 각 디렉토리에 `landing.html` 존재 확인. 없으면 그 brand는 skip + 사용자에게 알림.
-
-2. **meta 수집**: 각 brand 디렉토리에서:
-   - `experiment-meta.json` 있으면 그대로 사용
-   - 없으면 `DESIGN.md` frontmatter에서 `brand` 추출, `landing.html`에서 `<title>` 추출 → minimal card
-   - `structure.json`이 있으면 hero.type / cta.dominant_shape 정도를 tag로 추가
-   - `.live-inspect-proof.json` 존재 → "live ✓" tag, raw_samples 수 표시
-
-3. **brand mark 생성**: brand_color_hex가 있으면 색칩 div에 첫 글자. 없으면 회색 fallback.
-
-4. **gallery HTML 작성**: 위 CSS + 카드 구조로 출력. `<output-dir>/index.html`에 write.
-
-5. **사용자 요약**:
-   ```
-   ✓ Gallery 생성: <output-dir>/index.html
-     - 카드 N개 · wow 평균 X.X · live-inspect 통과 Y/N
-     - 서버 띄우는 법: cd <output-dir> && python3 -m http.server 8770
-     - 열기: http://localhost:8770/index.html
-   ```
-
-## 멀티턴 self-feedback 옵션 (v1.3.6 신설)
-
-`browser-harness` 또는 `mcp__playwright__*` 가용 시, gallery 생성 후 **gallery 자체에 self-critique 라운드**:
-
-1. gallery index.html을 browser-harness로 열어 screenshot
-2. 각 brand 카드의 iframe rendering이 정상인지 (빈 화면 / 깨진 layout / 누락 자산) 시각 grading
-3. 발견된 문제 brand에 대해 **issue.md** 작성 (`<output-dir>/issues.md`):
-   ```markdown
-   # Gallery issues — auto-detected via browser-harness
-   - toss: hero section reveals empty (IntersectionObserver fired but skill rule 10 safety net missing) — re-run with v1.3.6
-   - karrot: product card photo 3 fails to load (Loremflickr 503) — fallback to Picsum needed
-   ```
-4. 사용자에게 issues.md 안내 + 자동 fix 진행 여부 묻기
-
-## 안티패턴 (절대 금지)
-
-- ❌ Brand 디렉토리 안의 자산을 gallery에 직접 복사 (iframe으로만 reference)
-- ❌ Brand creative work 재구성 (각 brand의 own landing.html이 self-contained — gallery는 그 wrapper일 뿐)
-- ❌ wow rating 임의 부여 (sub-agent의 honest assessment가 출처)
-
-## 한 줄 요약
-
-**N개 brand experiment → 1개 index.html. iframe scaled, wow rating, round-2 deltas, system-fix summary. 재사용 무한.**

package/.opencode/oh-my-design/skills/omd-final-qa/SKILL.md

@@ -1,182 +0,0 @@
----
-name: omd:final-qa
-description: "출간 ready 직전 read-only critic. 8-item rubric 강제. 'looks good' rubber-stamp 금지. 라인 ref 필수. 2-round revision hard cap. '최종 QA', '출간 검수', 'rubric으로 평가' 류 트리거."
-user-invocable: true
----
-
-# omd:final-qa
-
-artifact가 사용자에게 handoff 되기 전 마지막 게이트. **read-only**. 절대 수정하지 않고, verdict + actionable feedback만 emit.
-
-## 0. 입력
-
-- `artifact_paths`: 모든 locale 파일 (예: `index.ko.md`, `index.en.md`)
-- `design_md_path`: brand DESIGN.md
-- `prior_reviews`: designer-review 보고서 경로 (있으면)
-- `voice_preset`: kr-writer가 사용한 preset_id
-- `round`: 1 또는 2 (orchestrator가 주입)
-
-## 1. Rubric (9 items, 모두 closed checklist)
-
-각 항목은 **PASS / FAIL** 이진. 회색 zone 없음. 1개라도 FAIL이면 verdict = REVISION (round 1) 또는 BLOCK (round 2).
-
-### [1] Brand consistency
-- DESIGN.md의 §Color/§Typography/§Spacing 토큰이 artifact에 사용됨
-- DESIGN.md에 없는 hex/font/spacing 직접 사용 0건
-- 검증: artifact 내 모든 토큰값 추출 → DESIGN.md set과 diff
-
-### [2] Typography hierarchy
-- h1 1개, h2 ≥2개, h3는 h2 자식으로만
-- 빈 level skip 0건 (h1→h3 금지)
-- 본문 weight 일관
-
-### [3] Voice register
-- 선언된 `voice_preset` 룰 준수 (예: toss-tech-design이면 `-요` 종결 100%)
-- 금지 어미 0건 (preset spec 참조)
-- 평균 문장 길이가 preset 범위 내
-
-### [4] Image / figure
-- 모든 `<img>` / `![]()`에 alt 텍스트 존재
-- caption (figcaption 또는 figure 옆 짧은 설명) 존재
-- alt와 caption이 다름 (alt=설명, caption=맥락)
-- src 경로 valid (파일 존재)
-
-### [5] Cross-locale parity
-- KR이 N H2 → 다른 locale도 N H2
-- KR이 N figure → 다른 locale도 N figure
-- frontmatter `source_revision` 최신
-
-### [6] Accessibility
-- 대비비 AA 충족 (text/bg 4.5:1, large 3:1)
-- focus state 정의됨 (CSS 또는 컴포넌트)
-- semantic HTML (button vs div, nav, main, article)
-- 한국어 본문에 `lang="ko"`
-
-### [7] Performance
-- 이미지가 적정 크기 (>500KB 단일 이미지 = FAIL)
-- 코드 블록에 lang 태그 (` ```ts `, ` ```python `)
-- 외부 폰트 로드 시 `font-display: swap`
-
-### [8] Links
-- 모든 hyperlink HTTP 200 (브로큰 0건). 외부 링크 체크는 best-effort.
-- 외부 링크에 indicator (icon 또는 `target="_blank" rel="noopener"`)
-- relative path 일관
-
-> 한국어 표기/맞춤법은 이 rubric의 자동 항목이 아니다. 자동 검사가 필요하면
-> 외부 서비스(예: 부산대 한국어 맞춤법 검사기)를 작성자가 별도로 돌린다 —
-> 번들된 결정론적 도구는 없다.
-
-## 2. Anti-rubber-stamp guardrails
-
-- "looks good", "전반적으로 OK", "전체적으로 괜찮음" 등 문구 hard-banned. 사용 시 self-reject.
-- 각 PASS도 **왜 PASS인지 1줄 evidence** 필수.
-- 각 FAIL은 **라인 ref + verbatim quote + fix direction** 필수.
-- DESIGN.md를 강제 재read. 캐시된 기억 사용 금지. Report 헤더에 `design_md_read_at` ISO timestamp 명시.
-
-## 3. 2-round hard cap
-
-```
-round 1:
-  rubric FAIL → verdict = REVISION
-  → orchestrator가 writer로 송환
-round 2:
-  rubric FAIL → verdict = BLOCK
-  → orchestrator가 사용자 escalation
-```
-
-3번째 round 금지. 사용자가 강제 통과 결정 시 known-issues로 frontmatter 기록 후 ship.
-
-## 4. 출력 형식
-
-`<work_dir>/.reviews/final-qa-round-<N>.md`:
-
-```markdown
-# Final QA — round <N>
-
-**Date:** <ISO>
-**Artifacts:** <list>
-**DESIGN.md read at:** <ISO>
-**Voice preset:** <preset_id>
-
-## Rubric
-
-| # | Item | Verdict | Evidence |
-|---|---|---|---|
-| 1 | Brand consistency | PASS | DESIGN.md 12 tokens 모두 사용. 추가 hex 0건. |
-| 2 | Typography hierarchy | FAIL | `index.ko.md:88` h2 → h4 skip. h3 누락. |
-| 3 | Voice register | PASS | 종결어미 `-요` 198/198 (100%). |
-| 4 | Image / figure | FAIL | `index.ko.md:34` alt 텍스트 누락. |
-| 5 | Cross-locale parity | PASS | KR 6 H2 = EN 6 H2. |
-| 6 | Accessibility | PASS | 대비비 7.1:1. focus-visible 정의됨. |
-| 7 | Performance | PASS | 모든 이미지 < 200KB. |
-| 8 | Links | PASS | 23 link, broken 0. |
-
-## Failed items detail
-
-### [2] Typography hierarchy — h-level skip
-- Location: `index.ko.md:88`
-- Evidence: `## 가져가도 좋은 것` → 다음에 `#### 1. 토큰` (h4)
-- Fix: h3로 변경
-
-### [4] alt 텍스트
-- Location: `index.ko.md:34`
-- Evidence: `![](./images/karrot-hero.png "당근 메인")`
-- Fix: alt 채움. 예: `![당근 메인 화면 스크린샷](./images/karrot-hero.png "당근 메인")`
-
-## Verdict
-
-**REVISION** (round 1) — 2 items FAIL. Writer로 송환.
-
-다음 round에서 동일 항목 FAIL 시 BLOCK.
-```
-
-## 5. Anti-patterns
-
-- ❌ "looks good" / "괜찮음" 류 응답 — hard ban
-- ❌ Evidence 없는 PASS
-- ❌ Line ref 없는 FAIL
-- ❌ Severity / verdict 회피 (애매한 "약간 우려" 금지 → PASS 또는 FAIL)
-- ❌ 직접 수정 시도 (read-only 원칙)
-- ❌ Rubric 추가/삭제 (8 items은 고정. 추가는 별도 PR로 SKILL.md 갱신.)
-- ❌ DESIGN.md를 한 번 읽고 round 2에서 재사용
-
-## 6. Rubric 확장 (메타)
-
-새 rubric item 추가는:
-1. 이 SKILL.md에 [9] 이상으로 추가
-2. 한국어 closed PASS/FAIL 정의
-3. orchestrator의 round-cap에 영향 없음 (rubric 늘어도 cap=2 유지)
-
-## 7. Cross-skill 의존
-
-- `omd-designer-review` 보고서 ← `prior_reviews`로 참조 (해소 여부 확인)
-- `omd-locale-adapter` 결과물 ← rubric [5]에서 검증
-
-## 8. 취향 캡처 — QA → taste loop (최종 phase)
-
-verdict를 emit한 **후에**, 이번 run의 rubric FAIL들을 한 번 스캔해 반복 위반을 취향 후보로 제안한다. read-only 원칙은 그대로 — artifact·DESIGN.md는 절대 건드리지 않으며, 이 스킬이 트리거할 수 있는 **유일한 쓰기**는 사용자가 명시적으로 동의한 뒤의 preference append이고, 그것도 `omd:remember`의 canonical 절차 그대로다.
-
-### 후보 조건 (둘 중 하나)
-
-1. **반복 rubric 위반** — 같은 rubric item의 FAIL이 이번 run에서 2회 이상 (여러 artifact/locale에 걸쳐, 또는 round 1·2 연속 동일 item). item을 axis로 환원: [1] Brand consistency → 위반 토큰 종류에 따라 color/spacing/radius, [2] Typography hierarchy → typo, [3] Voice register → voice
-2. **기존 pending preference와 매칭** — `.omd/preferences.md`가 존재하면 read해서, FAIL이 `status: pending` 엔트리의 scope와 같은 축이면 1회여도 후보
-
-`.omd/preferences.md`가 없으면 조건 2는 생략 — 파일을 만들지 않는다. a11y/performance/links([6]-[8])는 취향이 아니라 hard rule — 후보에서 제외.
-
-### 제안 (run당 질문 1개 max)
-
-후보가 1개 이상이면 **단 한 번** 묻는다: "이 패턴, 취향으로 기록할까요?"
-
-- **Claude Code**: AskUserQuestion — 후보 여러 개는 multiSelect 옵션으로 배칭 (후보당 한 줄: axis + FAIL 횟수 + 요약)
-- **다른 채널**: 같은 내용을 산문 질문 하나로
-
-동의된 후보는 **omd:remember 스킬의 기록 절차를 그대로 수행**해 기록 (직접 포맷 모방 금지 — writer는 omd:remember 하나) — `signal: review` / `confidence: inferred` / `status: pending`, `source_context`는 이번 QA report 경로 (예: `.reviews/final-qa-round-1.md`).
-
-### 금지
-
-- 질문 없는 자동 기록 절대 불가 — review 추론은 사용자 동의가 전제
-- **자동 fold 금지** — `status: pending` 기록까지만. DESIGN.md 반영은 omd:learn의 평소 임계/게이트가 결정
-- run당 질문 2개 이상 금지, 거절된 후보의 같은 세션 재제안 금지
-- 이 phase가 verdict나 round cap에 영향을 주면 안 됨 (rubric 8 items 고정 유지)
-
-> **수동 검증**: KR/EN 두 artifact에서 rubric [3] Voice register가 모두 FAIL인 QA를 돌리면, verdict 출력 후 "이 패턴, 취향으로 기록할까요?" 질문이 정확히 1회 뜨고, 동의 시 `.omd/preferences.md`에 `scope: voice` / `signal: review` / `confidence: inferred` / `status: pending` 엔트리가 append되어야 한다 (artifact·DESIGN.md는 변경 없음).