feat(v1.1.0): Gate H1 becomes preview-selection + design-tweak

MOTIVATION (from first real run r-20260422-184337):
  User ran PreviewDD on "회의록 자동 정리 + action item 추출".
  4-Panel composite winner was P02 Scrum Master Slack bot.
  User wanted P19 legal-depo-advocate — NOT in any panel's top-N.
  v1.0.0 offered no way to pick alternative; Gate H1 was design-only.

  The 26 advocates don't just vary in design — they vary in product:
    P02 → Slack bot for Scrum Masters
    P10 → REST API SDK for indie hackers
    P08 → Self-hosted appliance for legal teams
    P19 → Desktop case-management for litigation paralegals
  Picking is choosing a PRODUCT, not a screen.

WHAT CHANGED:

commands/design.md — rewritten
  Unified AskUserQuestion with 4 options:
    1. 🏆 Recommended (composite winner)
    2. 💡 Alternative A (e.g., TP single winner, API/SDK angle)
    3. 🔬 Alternative B (e.g., RP single winner, privacy/offline angle)
    4. 🎨 Show all 26 (gallery.html → browser)
  Alternative pick → chosen_preview.panel-recommended.json backup,
  and Mitigation Designer regeneration (different product context).

agents/meta/chief-engineer-pm.md §3 — rewritten
  Full selection procedure documented.
  Explicit reference to LESSON 0.7.

memory/LESSONS.md — 0.7 added
  "Panel 추천 ≠ 사용자 의지" (category 1 PreviewDD, 핵심 UX 결함).

manifests — version 1.0.0 → 1.1.0 (plugin.json + marketplace.json)
scripts/verify-plugin.sh — accepts any SemVer + parity check
CHANGELOG.md — [1.1.0] section

REAL RUN ARTIFACTS PRESERVED (as example):
  runs/r-20260422-184337/chosen_preview.panel-recommended.json (P02)
  runs/r-20260422-184337/chosen_preview.json (user-overridden to P19)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: ComBba

.claude-plugin/marketplace.json

@@ -7,14 +7,14 @@
   },
   "metadata": {
     "description": "Two-Weeks-Team marketplace hosting the Preview Forge plugin — a 143-agent engineering swarm implementing the 3-DD Methodology (PreviewDD → SpecDD → TestDD) for Claude Code.",
-    "version": "1.0.0",
+    "version": "1.1.0",
     "homepage": "https://github.com/Two-Weeks-Team/PreviewForgeForClaudeCode"
   },
   "plugins": [
     {
       "name": "pf",
       "description": "Preview Forge — 한 줄 아이디어 → 143명의 Opus 4.7 가상 엔지니어링 조직이 PreviewDD · SpecDD · TestDD 3 사이클로 풀스택 앱을 freeze까지. /pf:* 14 slash commands. 인간은 디자인·배포 2 클릭만.",
-      "version": "1.0.0",
+      "version": "1.1.0",
       "author": {
         "name": "Two-Weeks-Team"
       },

CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] — 2026-04-22 (in progress)
+
+### Fixed — UX gap from first real run
+
+- **Gate H1 is now preview-selection + design-tweak (was design-only)**
+  - 첫 real run(r-20260422-184337)에서 사용자가 panel top-3 밖의 P19(legal-depo)를
+    선택. v1.0.0은 panel 추천만 자동 lock하고 agency를 주지 않았음.
+  - `commands/design.md` rewritten: AskUserQuestion 4옵션 (Recommended / Alt A /
+    Alt B / Gallery of 26).
+  - `agents/meta/chief-engineer-pm.md` §3 rewritten: full selection procedure.
+  - Alternative 선택 시 mitigations 재생성 의무화 (제품 context 달라짐).
+  - `chosen_preview.panel-recommended.json`으로 panel 원본 백업.
+
+### Added
+- `memory/LESSONS.md` 0.7: "Panel 추천 ≠ 사용자 의지" (category 1 PreviewDD, 핵심 결함)
+
+### Real run artifact (preserved as example)
+- `runs/r-20260422-184337/chosen_preview.panel-recommended.json` (P02 Slack bot)
+- `runs/r-20260422-184337/chosen_preview.json` (user-overridden to P19 legal-depo)
+
+
 ## [1.0.0] — 2026-04-22
 
 Plugin scaffold complete. Ready for `/plugin install pf@two-weeks-team` via

plugins/preview-forge/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pf",
   "description": "한 줄 아이디어 → 143명 Opus 4.7 가상 엔지니어링 조직이 PreviewDD → SpecDD → TestDD 3-DD 사이클로 풀스택 앱을 freeze까지. 내장 Design Studio(Claude Design fallback) + Memory Tool + Reflexion 자가학습. Built with Opus 4.7 hackathon.",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "author": {
     "name": "Two-Weeks-Team",
     "email": "app.2weeks@gmail.com",

plugins/preview-forge/agents/meta/chief-engineer-pm.md

@@ -34,8 +34,27 @@ Standup 결과를 Blackboard에 `standup.<cycle>.<ts>` key로 기록.
 - 조정 결과를 Blackboard `decision.<topic>`에 기록
 
 ### 3. Gate H1 / H2 관장
-- **H1** (PreviewDD → SpecDD): 사용자 응답을 AskUserQuestion으로 수집, `design-approved.json` 생성 후 SPEC_LEAD에 전달
-- **H2** (TestDD freeze → 배포): 500점 리포트 + 스크린샷 + 배포 대상을 AskUserQuestion 옵션으로 제시, 승인 시 `/pf:export` 워크플로 트리거
+
+**H1 (PreviewDD → SpecDD): Preview 선택 + Design tweak 통합**
+
+**중요**: Gate H1은 design-only가 아닙니다. 사용자가 **preview 자체를 다른 걸로 고를 수 있어야** 합니다. 26 advocate는 각자 다른 제품(target_persona·primary_surface·unique_value)이므로, panel 추천만으로는 사용자 의지를 대체할 수 없음 (LESSON 0.7 참조).
+
+절차:
+1. 4-Panel meta-tally에서 composite 1위(`panel_recommended`)와 각 panel 단독 우승자(`TP_winner` · `BP_winner` · `UP_winner` · `RP_winner`) 추출
+2. 중복 제거 후 구별되는 3 후보 선정 (예: Recommended + TP 단독 + RP 단독)
+3. AskUserQuestion 4옵션 제시:
+   - **① 🏆 Recommended (composite 1위)**: `target_persona` · `primary_surface` · `one_line_pitch` · 4 panel 점수
+   - **② 💡 Alternative A**: 특정 panel 단독 우승자 (예: TP winner = API-first)
+   - **③ 🔬 Alternative B**: 다른 panel 단독 우승자 (예: RP winner = Privacy-focused)
+   - **④ 🎨 Show all 26 (gallery)**: `runs/<id>/mockups/gallery.html` 생성 → 브라우저 오픈 → 두 번째 AskUserQuestion으로 실제 pick
+4. 사용자 선택 반영:
+   - ①/②/③: 해당 P<NN>을 `chosen_preview.json`에 lock (기존 panel 추천은 `chosen_preview.panel-recommended.json`으로 백업)
+   - ④: gallery 표시 후 재선택
+5. **Alternative 선택 시 mitigations 재생성 필수**: panel이 쓴 mitigations는 panel 추천 product context 기반이므로 MD(Mitigation Designer)를 alternative context로 재호출
+6. 2차 AskUserQuestion: "Claude Design(Pro/Max)으로 열까 / 내장 Studio로 tweak하고 끝낼까"
+7. design 완료 시 `design-approved.json` 생성 → SPEC_LEAD에 전달
+
+**H2 (TestDD freeze → 배포)**: 500점 리포트 + 스크린샷 + 배포 대상을 AskUserQuestion 옵션으로 제시, 승인 시 `/pf:export` 워크플로 트리거
 
 ### 4. Memory 파일 관리 (쓰기 권한 독점)
 

plugins/preview-forge/commands/design.md

@@ -1,26 +1,69 @@
 ---
-description: Open Gate H1 — Claude Design main or built-in Design Studio fallback
+description: Gate H1 — Preview selection + Design tweak (unified AskUserQuestion)
 ---
 
-# /pf:design — Open Gate H1 — Claude Design main or built-in Design Studio fallback
+# /pf:design — Gate H1
 
-**Layer-0 정책**: Pro/Max 기본 포함. 별도 API 키 불필요.
+**Layer-0**: Claude Code Pro/Max 기본 포함.
 
-## Usage
+## When this runs
 
-```
-/pf:design
-```
+Automatically after PreviewDD Stage 3 (4-Panel meta-tally) completes.
+Can also be invoked manually: `/pf:design` re-opens the selection UX on
+the current run.
 
-## 인자
+## v1.1.0 flow (unified: select + tweak)
 
-_(인자 없음)_
+**Click 1 of 2** (the other is Gate H2 deploy approval).
 
-## 동작
+M3 Dev PM collects the 4-Panel output and runs a single AskUserQuestion
+with 4 options:
 
-Stage 4 spec lock 직후 자동 호출되지만, 수동 재호출도 가능. AskUserQuestion으로 Claude Design vs 내장 Studio 선택. Claude Design 선택 시 prompt 템플릿 준비, 사용자에게 claude.ai/design 탭 열도록 안내.
+- **① 🏆 Recommended**: composite 1위 advocate
+  - `target_persona` · `primary_surface` · `one_line_pitch` · 4 panel 점수 표시
+  - → 이대로 Claude Design(or 내장 Studio)로 진입
 
-## 관련
+- **② 💡 Alternative A**: 특정 panel 단독 우승자 1
+  - 예: TP 단독 우승자가 Recommended와 다른 경우 (API-first · SDK angle)
 
-- 본 명령은 plugin `preview-forge`의 일부입니다.
-- 상세 스펙: [preview-forge-proposal.html](../../../preview-forge-proposal.html)
+- **③ 🔬 Alternative B**: 특정 panel 단독 우승자 2
+  - 예: RP 단독 우승자 (Privacy-focused · Offline-first angle)
+
+- **④ 🎨 Show me all 26 (gallery)**
+  - 26 mockup HTML을 로컬 `runs/<id>/mockups/gallery.html` 로 엮어 브라우저 오픈
+  - 사용자가 보고 나면 두 번째 AskUserQuestion으로 pick (4옵션: 3 카드 + "다시 fresh roll")
+
+## What happens after the click
+
+| 사용자 선택 | 다음 동작 |
+|---|---|
+| Option 1 (Recommended) | `chosen_preview.json`에 P<NN> lock + Claude Design / Studio로 진입 |
+| Option 2 / 3 (Alternative) | chosen_preview에 반영 + **기존 mitigations는 다른 제품 context이므로 MD(Mitigation Designer) 재생성 요청** → Claude Design / Studio |
+| Option 4 (Gallery) | 27-mockup HTML grid 생성 → default browser 오픈 → 사용자가 본 후 두 번째 AskUserQuestion → chosen_preview 반영 |
+| 모든 경우 | 2차 AskUserQuestion — "Claude Design에서 열까(Pro/Max) / 내장 Studio로 tweak" |
+
+## Override semantics
+
+사용자가 panel 추천 아닌 alternative 선택 시:
+- 원본 `chosen_preview.json`은 `chosen_preview.panel-recommended.json`으로 백업
+- 새 chosen_preview에 `chosen_via: "user_override"` + `selection_metadata.reason` 기록
+- Blackboard에 `user-override` 이벤트 추가 (tier 0, dept meta)
+- **Mitigations는 새 제품 context로 MD를 재호출**해서 재생성
+  (예: P02 Slack bot 대비 P19 desktop app은 보안·데이터 거주성 우선순위가 완전히 다름)
+
+## allowed_scope (M3 Dev PM 관점)
+
+- Read: `runs/<id>/previews.json` · `panels/*.json` · `mockups/*.html` · `mitigations.json`
+- Write: `runs/<id>/{chosen_preview.json,chosen_preview.json.lock,chosen_preview.panel-recommended.json,design-approved.json}`
+- Task: MD (mitigations 재생성), Claude Design integration (optional)
+
+## Fallback
+
+Claude Design API 장애 · 사용자가 offline 선택 시 → 내장 Design Studio
+(`plugins/preview-forge/design-studio/` Next.js route) 자동 전환.
+
+## Related
+
+- Panel outputs: `runs/<id>/panels/{tp,bp,up,rp}-tally.json`, `meta-tally.json`
+- 26 mockup files: `runs/<id>/mockups/P01-P26.html`
+- LESSON 0.7: "Panel 추천 ≠ 사용자 의지" (`memory/LESSONS.md`)

plugins/preview-forge/memory/LESSONS.md

@@ -9,6 +9,17 @@
 
 ## 0. 플러그인 개발 자체에서 배운 것 (bootstrap)
 
+### 0.7 Panel 추천 ≠ 사용자 의지 — Preview 선택은 사용자가 해야 (category 1 PreviewDD, 핵심 UX 결함)
+- **문제**: v1.0.0의 PreviewDD는 4-Panel meta-tally로 1개 자동 선정 → `chosen_preview.json` 즉시 lock → Gate H1은 design tweak만. 사용자는 **선택 자체에 개입 불가**, "143 agent가 정해버린" 느낌. 실제 첫 run에서 composite 1위는 P02 Slack bot이었으나 사용자는 P19(legal depo paralegal, 소송 증언녹취 도구)를 의도적으로 선택 — 4 패널 어디에도 top-N 진입 못한 niche. panel 관점은 수량화 가능한 축을 재는 도구이지 사용자 의지의 대체물이 아님
+- **원인**: "인간의 2-click" 마케팅에 집중하다 보니 이상적 경로에서 Gate H1이 design-only가 됨. 하지만 26 advocate는 **디자인만 다른 게 아니라 target_persona·primary_surface·unique_value·killer_feature가 완전히 다른 제품** — 선택 = 제품 방향 결정
+- **해결**: v1.1.0에서 Gate H1을 **"Preview 선택 + Design tweak" 통합 AskUserQuestion**으로 재설계. 4 옵션 구성:
+    1. **추천** (composite 1위, Recommended)
+    2. **대안 A** (특정 panel 단독 우승자, 다른 축 강조)
+    3. **대안 B** (다른 panel 단독 우승자)
+    4. **전체 gallery** — 26 mockup HTML grid를 별도 브라우저로 열어 고르기
+  click 1번 안에 선택+진입 통합. 2-click narrative 유지
+- **참조**: `runs/r-20260422-184337/chosen_preview.panel-recommended.json` (P02 백업) vs `chosen_preview.json` (P19 override), v1.1.0 commit, 첫 실제 run 피드백 2026-04-22
+
 ### 0.6 `claude --print` 서브프로세스는 /pf:new 자동 실행 불가 (category 6)
 - **문제**: 테스트 목적으로 `claude --print "/pf:new ..."`를 bash 서브프로세스로 실행 시도 시, Claude Code의 기본 권한 정책이 모든 Bash/Edit/Write 호출마다 사용자 승인을 요구. 143 agent 파이프라인 중간에서 정지
 - **원인**: Claude Code의 안전 정책 — 비대화형 모드에서도 파일 시스템 변경·bash 실행은 명시 승인 필요. `/pf:new`는 본질적으로 수백 개의 도구 호출을 연쇄하므로 서브프로세스 자동화 불가

scripts/verify-plugin.sh

@@ -29,8 +29,18 @@ bad() { echo "  ✗ $1" >&2; fail=$((fail + 1)); }
 echo "[1/5] Manifests"
 python3 -c "import json; d=json.load(open('.claude-plugin/marketplace.json')); assert d['plugins'][0]['name']=='pf'" && \
   ok "marketplace.json: plugin 'pf' declared" || bad "marketplace.json invalid"
-python3 -c "import json; d=json.load(open('$PLUGIN_DIR/.claude-plugin/plugin.json')); assert d['name']=='pf' and d['version']=='1.0.0'" && \
-  ok "plugin.json: name=pf v1.0.0" || bad "plugin.json invalid"
+python3 -c "
+import json, re
+d = json.load(open('$PLUGIN_DIR/.claude-plugin/plugin.json'))
+assert d['name']=='pf', 'name must be pf'
+assert re.match(r'^\d+\.\d+\.\d+', d['version']), 'version must be SemVer'
+# also ensure marketplace version matches
+m = json.load(open('.claude-plugin/marketplace.json'))
+pf = next(p for p in m['plugins'] if p['name']=='pf')
+assert pf['version'] == d['version'], f'version mismatch: marketplace {pf[\"version\"]} vs plugin {d[\"version\"]}'
+print(d['version'])
+" >/tmp/pf_version 2>/dev/null && \
+  ok "plugin.json: name=pf v$(cat /tmp/pf_version)  (marketplace parity ✓)" || bad "plugin.json invalid"
 echo
 
 echo "[2/5] Agents (143 target)"