npm - product-playbook - Versions diffs - 1.0.0 - Mend

product-playbook 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (291) hide show

package/LICENSE +21 -0
package/README.es.md +518 -0
package/README.ja.md +519 -0
package/README.ko.md +518 -0
package/README.md +520 -0
package/README.zh-CN.md +518 -0
package/README.zh-TW.md +518 -0
package/SKILL.md +244 -0
package/commands/product-build.md +13 -0
package/commands/product-dev.md +21 -0
package/commands/product-full.md +13 -0
package/commands/product-prd.md +14 -0
package/commands/product-quick.md +13 -0
package/commands/product-report.md +12 -0
package/commands/product-revision.md +13 -0
package/i18n/en/SKILL.md +245 -0
package/i18n/en/commands/product-build.md +13 -0
package/i18n/en/commands/product-dev.md +21 -0
package/i18n/en/commands/product-full.md +13 -0
package/i18n/en/commands/product-prd.md +14 -0
package/i18n/en/commands/product-quick.md +13 -0
package/i18n/en/commands/product-report.md +12 -0
package/i18n/en/commands/product-revision.md +13 -0
package/i18n/en/references/00-opportunity-check.md +44 -0
package/i18n/en/references/01-strategy.md +90 -0
package/i18n/en/references/02a-persona.md +57 -0
package/i18n/en/references/02b-jtbd.md +125 -0
package/i18n/en/references/02c-ost-journey.md +65 -0
package/i18n/en/references/03-define.md +118 -0
package/i18n/en/references/04a-prfaq.md +112 -0
package/i18n/en/references/04b-solutions.md +269 -0
package/i18n/en/references/04c-mvp.md +21 -0
package/i18n/en/references/05a-northstar-aha.md +93 -0
package/i18n/en/references/05b-pmf-gtm.md +102 -0
package/i18n/en/references/05c-validation-spec.md +117 -0
package/i18n/en/references/06-html-report.md +128 -0
package/i18n/en/references/07a-handoff-core.md +152 -0
package/i18n/en/references/07b-tasks-tickets.md +215 -0
package/i18n/en/references/07c-architecture-setup.md +197 -0
package/i18n/en/references/08-security-checklist.md +221 -0
package/i18n/en/references/rules-build.md +152 -0
package/i18n/en/references/rules-change-propagation.md +74 -0
package/i18n/en/references/rules-commands.md +98 -0
package/i18n/en/references/rules-context.md +291 -0
package/i18n/en/references/rules-custom.md +63 -0
package/i18n/en/references/rules-document-tools.md +126 -0
package/i18n/en/references/rules-end-of-flow.md +150 -0
package/i18n/en/references/rules-export-document.md +346 -0
package/i18n/en/references/rules-file-integration.md +65 -0
package/i18n/en/references/rules-full.md +66 -0
package/i18n/en/references/rules-import-document.md +261 -0
package/i18n/en/references/rules-product-type.md +14 -0
package/i18n/en/references/rules-progress.md +60 -0
package/i18n/en/references/rules-quick.md +29 -0
package/i18n/en/references/rules-revision.md +64 -0
package/i18n/es/SKILL.md +245 -0
package/i18n/es/commands/product-build.md +13 -0
package/i18n/es/commands/product-dev.md +21 -0
package/i18n/es/commands/product-full.md +13 -0
package/i18n/es/commands/product-prd.md +14 -0
package/i18n/es/commands/product-quick.md +13 -0
package/i18n/es/commands/product-report.md +12 -0
package/i18n/es/commands/product-revision.md +13 -0
package/i18n/es/references/00-opportunity-check.md +44 -0
package/i18n/es/references/01-strategy.md +90 -0
package/i18n/es/references/02a-persona.md +57 -0
package/i18n/es/references/02b-jtbd.md +125 -0
package/i18n/es/references/02c-ost-journey.md +65 -0
package/i18n/es/references/03-define.md +118 -0
package/i18n/es/references/04a-prfaq.md +114 -0
package/i18n/es/references/04b-solutions.md +269 -0
package/i18n/es/references/04c-mvp.md +21 -0
package/i18n/es/references/05a-northstar-aha.md +93 -0
package/i18n/es/references/05b-pmf-gtm.md +102 -0
package/i18n/es/references/05c-validation-spec.md +117 -0
package/i18n/es/references/06-html-report.md +138 -0
package/i18n/es/references/07a-handoff-core.md +152 -0
package/i18n/es/references/07b-tasks-tickets.md +215 -0
package/i18n/es/references/07c-architecture-setup.md +197 -0
package/i18n/es/references/08-security-checklist.md +221 -0
package/i18n/es/references/rules-build.md +152 -0
package/i18n/es/references/rules-change-propagation.md +74 -0
package/i18n/es/references/rules-commands.md +98 -0
package/i18n/es/references/rules-context.md +291 -0
package/i18n/es/references/rules-custom.md +63 -0
package/i18n/es/references/rules-document-tools.md +126 -0
package/i18n/es/references/rules-end-of-flow.md +150 -0
package/i18n/es/references/rules-export-document.md +346 -0
package/i18n/es/references/rules-file-integration.md +65 -0
package/i18n/es/references/rules-full.md +66 -0
package/i18n/es/references/rules-import-document.md +261 -0
package/i18n/es/references/rules-product-type.md +14 -0
package/i18n/es/references/rules-progress.md +60 -0
package/i18n/es/references/rules-quick.md +29 -0
package/i18n/es/references/rules-revision.md +64 -0
package/i18n/ja/SKILL.md +245 -0
package/i18n/ja/commands/product-build.md +13 -0
package/i18n/ja/commands/product-dev.md +21 -0
package/i18n/ja/commands/product-full.md +13 -0
package/i18n/ja/commands/product-prd.md +14 -0
package/i18n/ja/commands/product-quick.md +13 -0
package/i18n/ja/commands/product-report.md +12 -0
package/i18n/ja/commands/product-revision.md +13 -0
package/i18n/ja/references/00-opportunity-check.md +44 -0
package/i18n/ja/references/01-strategy.md +90 -0
package/i18n/ja/references/02a-persona.md +57 -0
package/i18n/ja/references/02b-jtbd.md +125 -0
package/i18n/ja/references/02c-ost-journey.md +65 -0
package/i18n/ja/references/03-define.md +118 -0
package/i18n/ja/references/04a-prfaq.md +111 -0
package/i18n/ja/references/04b-solutions.md +269 -0
package/i18n/ja/references/04c-mvp.md +21 -0
package/i18n/ja/references/05a-northstar-aha.md +93 -0
package/i18n/ja/references/05b-pmf-gtm.md +102 -0
package/i18n/ja/references/05c-validation-spec.md +117 -0
package/i18n/ja/references/06-html-report.md +126 -0
package/i18n/ja/references/07a-handoff-core.md +152 -0
package/i18n/ja/references/07b-tasks-tickets.md +215 -0
package/i18n/ja/references/07c-architecture-setup.md +197 -0
package/i18n/ja/references/08-security-checklist.md +221 -0
package/i18n/ja/references/rules-build.md +152 -0
package/i18n/ja/references/rules-change-propagation.md +74 -0
package/i18n/ja/references/rules-commands.md +98 -0
package/i18n/ja/references/rules-context.md +291 -0
package/i18n/ja/references/rules-custom.md +63 -0
package/i18n/ja/references/rules-document-tools.md +126 -0
package/i18n/ja/references/rules-end-of-flow.md +150 -0
package/i18n/ja/references/rules-export-document.md +346 -0
package/i18n/ja/references/rules-file-integration.md +65 -0
package/i18n/ja/references/rules-full.md +66 -0
package/i18n/ja/references/rules-import-document.md +261 -0
package/i18n/ja/references/rules-product-type.md +14 -0
package/i18n/ja/references/rules-progress.md +60 -0
package/i18n/ja/references/rules-quick.md +29 -0
package/i18n/ja/references/rules-revision.md +64 -0
package/i18n/ko/SKILL.md +245 -0
package/i18n/ko/commands/product-build.md +13 -0
package/i18n/ko/commands/product-dev.md +21 -0
package/i18n/ko/commands/product-full.md +13 -0
package/i18n/ko/commands/product-prd.md +14 -0
package/i18n/ko/commands/product-quick.md +13 -0
package/i18n/ko/commands/product-report.md +12 -0
package/i18n/ko/commands/product-revision.md +13 -0
package/i18n/ko/references/00-opportunity-check.md +44 -0
package/i18n/ko/references/01-strategy.md +90 -0
package/i18n/ko/references/02a-persona.md +57 -0
package/i18n/ko/references/02b-jtbd.md +125 -0
package/i18n/ko/references/02c-ost-journey.md +65 -0
package/i18n/ko/references/03-define.md +118 -0
package/i18n/ko/references/04a-prfaq.md +112 -0
package/i18n/ko/references/04b-solutions.md +269 -0
package/i18n/ko/references/04c-mvp.md +21 -0
package/i18n/ko/references/05a-northstar-aha.md +93 -0
package/i18n/ko/references/05b-pmf-gtm.md +102 -0
package/i18n/ko/references/05c-validation-spec.md +117 -0
package/i18n/ko/references/06-html-report.md +126 -0
package/i18n/ko/references/07a-handoff-core.md +152 -0
package/i18n/ko/references/07b-tasks-tickets.md +215 -0
package/i18n/ko/references/07c-architecture-setup.md +197 -0
package/i18n/ko/references/08-security-checklist.md +221 -0
package/i18n/ko/references/rules-build.md +152 -0
package/i18n/ko/references/rules-change-propagation.md +74 -0
package/i18n/ko/references/rules-commands.md +98 -0
package/i18n/ko/references/rules-context.md +291 -0
package/i18n/ko/references/rules-custom.md +63 -0
package/i18n/ko/references/rules-document-tools.md +126 -0
package/i18n/ko/references/rules-end-of-flow.md +150 -0
package/i18n/ko/references/rules-export-document.md +346 -0
package/i18n/ko/references/rules-file-integration.md +65 -0
package/i18n/ko/references/rules-full.md +66 -0
package/i18n/ko/references/rules-import-document.md +261 -0
package/i18n/ko/references/rules-product-type.md +14 -0
package/i18n/ko/references/rules-progress.md +60 -0
package/i18n/ko/references/rules-quick.md +29 -0
package/i18n/ko/references/rules-revision.md +64 -0
package/i18n/zh-CN/SKILL.md +245 -0
package/i18n/zh-CN/commands/product-build.md +13 -0
package/i18n/zh-CN/commands/product-dev.md +21 -0
package/i18n/zh-CN/commands/product-full.md +13 -0
package/i18n/zh-CN/commands/product-prd.md +14 -0
package/i18n/zh-CN/commands/product-quick.md +13 -0
package/i18n/zh-CN/commands/product-report.md +12 -0
package/i18n/zh-CN/commands/product-revision.md +13 -0
package/i18n/zh-CN/references/00-opportunity-check.md +44 -0
package/i18n/zh-CN/references/01-strategy.md +90 -0
package/i18n/zh-CN/references/02a-persona.md +57 -0
package/i18n/zh-CN/references/02b-jtbd.md +125 -0
package/i18n/zh-CN/references/02c-ost-journey.md +65 -0
package/i18n/zh-CN/references/03-define.md +118 -0
package/i18n/zh-CN/references/04a-prfaq.md +106 -0
package/i18n/zh-CN/references/04b-solutions.md +269 -0
package/i18n/zh-CN/references/04c-mvp.md +21 -0
package/i18n/zh-CN/references/05a-northstar-aha.md +93 -0
package/i18n/zh-CN/references/05b-pmf-gtm.md +102 -0
package/i18n/zh-CN/references/05c-validation-spec.md +117 -0
package/i18n/zh-CN/references/06-html-report.md +123 -0
package/i18n/zh-CN/references/07a-handoff-core.md +152 -0
package/i18n/zh-CN/references/07b-tasks-tickets.md +215 -0
package/i18n/zh-CN/references/07c-architecture-setup.md +197 -0
package/i18n/zh-CN/references/08-security-checklist.md +221 -0
package/i18n/zh-CN/references/rules-build.md +152 -0
package/i18n/zh-CN/references/rules-change-propagation.md +74 -0
package/i18n/zh-CN/references/rules-commands.md +98 -0
package/i18n/zh-CN/references/rules-context.md +291 -0
package/i18n/zh-CN/references/rules-custom.md +63 -0
package/i18n/zh-CN/references/rules-document-tools.md +126 -0
package/i18n/zh-CN/references/rules-end-of-flow.md +150 -0
package/i18n/zh-CN/references/rules-export-document.md +346 -0
package/i18n/zh-CN/references/rules-file-integration.md +65 -0
package/i18n/zh-CN/references/rules-full.md +66 -0
package/i18n/zh-CN/references/rules-import-document.md +261 -0
package/i18n/zh-CN/references/rules-product-type.md +14 -0
package/i18n/zh-CN/references/rules-progress.md +60 -0
package/i18n/zh-CN/references/rules-quick.md +29 -0
package/i18n/zh-CN/references/rules-revision.md +64 -0
package/i18n/zh-TW/SKILL.md +244 -0
package/i18n/zh-TW/commands/product-build.md +13 -0
package/i18n/zh-TW/commands/product-dev.md +21 -0
package/i18n/zh-TW/commands/product-full.md +13 -0
package/i18n/zh-TW/commands/product-prd.md +14 -0
package/i18n/zh-TW/commands/product-quick.md +13 -0
package/i18n/zh-TW/commands/product-report.md +12 -0
package/i18n/zh-TW/commands/product-revision.md +13 -0
package/i18n/zh-TW/references/00-opportunity-check.md +44 -0
package/i18n/zh-TW/references/01-strategy.md +90 -0
package/i18n/zh-TW/references/02a-persona.md +57 -0
package/i18n/zh-TW/references/02b-jtbd.md +125 -0
package/i18n/zh-TW/references/02c-ost-journey.md +65 -0
package/i18n/zh-TW/references/03-define.md +118 -0
package/i18n/zh-TW/references/04a-prfaq.md +106 -0
package/i18n/zh-TW/references/04b-solutions.md +269 -0
package/i18n/zh-TW/references/04c-mvp.md +21 -0
package/i18n/zh-TW/references/05a-northstar-aha.md +93 -0
package/i18n/zh-TW/references/05b-pmf-gtm.md +102 -0
package/i18n/zh-TW/references/05c-validation-spec.md +117 -0
package/i18n/zh-TW/references/06-html-report.md +123 -0
package/i18n/zh-TW/references/07a-handoff-core.md +152 -0
package/i18n/zh-TW/references/07b-tasks-tickets.md +215 -0
package/i18n/zh-TW/references/07c-architecture-setup.md +197 -0
package/i18n/zh-TW/references/08-security-checklist.md +221 -0
package/i18n/zh-TW/references/rules-build.md +152 -0
package/i18n/zh-TW/references/rules-change-propagation.md +74 -0
package/i18n/zh-TW/references/rules-commands.md +98 -0
package/i18n/zh-TW/references/rules-context.md +291 -0
package/i18n/zh-TW/references/rules-custom.md +63 -0
package/i18n/zh-TW/references/rules-document-tools.md +126 -0
package/i18n/zh-TW/references/rules-end-of-flow.md +150 -0
package/i18n/zh-TW/references/rules-export-document.md +346 -0
package/i18n/zh-TW/references/rules-file-integration.md +65 -0
package/i18n/zh-TW/references/rules-full.md +66 -0
package/i18n/zh-TW/references/rules-import-document.md +261 -0
package/i18n/zh-TW/references/rules-product-type.md +14 -0
package/i18n/zh-TW/references/rules-progress.md +60 -0
package/i18n/zh-TW/references/rules-quick.md +29 -0
package/i18n/zh-TW/references/rules-revision.md +64 -0
package/install.sh +418 -0
package/package.json +41 -0
package/references/00-opportunity-check.md +44 -0
package/references/01-strategy.md +90 -0
package/references/02a-persona.md +57 -0
package/references/02b-jtbd.md +125 -0
package/references/02c-ost-journey.md +65 -0
package/references/03-define.md +118 -0
package/references/04a-prfaq.md +106 -0
package/references/04b-solutions.md +269 -0
package/references/04c-mvp.md +21 -0
package/references/05a-northstar-aha.md +93 -0
package/references/05b-pmf-gtm.md +102 -0
package/references/05c-validation-spec.md +117 -0
package/references/06-html-report.md +123 -0
package/references/07a-handoff-core.md +152 -0
package/references/07b-tasks-tickets.md +215 -0
package/references/07c-architecture-setup.md +197 -0
package/references/08-security-checklist.md +221 -0
package/references/rules-build.md +152 -0
package/references/rules-change-propagation.md +74 -0
package/references/rules-commands.md +98 -0
package/references/rules-context.md +291 -0
package/references/rules-custom.md +63 -0
package/references/rules-document-tools.md +126 -0
package/references/rules-end-of-flow.md +150 -0
package/references/rules-export-document.md +346 -0
package/references/rules-file-integration.md +65 -0
package/references/rules-full.md +66 -0
package/references/rules-import-document.md +261 -0
package/references/rules-product-type.md +14 -0
package/references/rules-progress.md +60 -0
package/references/rules-quick.md +29 -0
package/references/rules-revision.md +64 -0
package/references/templates/prd-style.css +464 -0
package/references/templates/report-style.css +114 -0

package/i18n/ko/references/rules-export-document.md ADDED Viewed

@@ -0,0 +1,346 @@
+# 다중 형식 문서 내보내기 규칙
+> 사용자가 `/export [형식]`을 트리거하거나 플로우 종료 후 내보내기 형식을 선택할 때 로드됩니다.
+> 최초 사용 시, 먼저 `rules-document-tools.md`를 로드하여 도구 설치 여부를 확인합니다.
+## 지원 내보내기 형식
+| 형식 | 명령 | 변환 경로 | 도구 |
+|------|------|----------|------|
+| PDF | `/export pdf` | HTML+CSS → Playwright → pikepdf 북마크 | Playwright MCP + pikepdf |
+| DOCX | `/export docx` | MD → Pandoc | pandoc + reference.docx |
+| PPTX | `/export pptx` | MD → Pandoc | pandoc |
+| HTML | `/export html` | 기존 `06-html-report.md` 규칙 | 내장 |
+| Markdown | `/export md` | 직접 출력 | 내장 |
+---
+## PDF 내보내기 (핵심 플로우)
+### 경로 선택
+PDF 내보내기에는 두 가지 경로가 있으며, 소스 콘텐츠에 따라 자동으로 선택됩니다:
+| 소스 | 경로 | 이유 |
+|------|------|------|
+| 기획 산출물 직접 내보내기 (PRD / 증분 업데이트 / 스펙) | **경로 A: setContent** | 외부 JS 의존성 없음, 모든 리소스 인라인 가능 |
+| HTML 기획 보고서 → PDF (Mermaid 다이어그램 / CDN 폰트 포함) | **경로 B: HTTP Server** | 외부 JS (mermaid.js) 및 CDN 폰트 로드 필요 |
+### 경로 A: 독립 문서 → PDF (setContent)
+적용 대상: PRD, 기능 확장 증분 업데이트, 스펙, 외부 JS가 없는 모든 콘텐츠.
+**1단계: HTML 콘텐츠 생성**
+Claude가 `references/templates/prd-style.css`를 읽고 완전한 HTML 문서를 생성합니다:
+```html
+<!DOCTYPE html>
+<html lang="zh-TW">
+<head>
+<meta charset="UTF-8">
+<style>
+/* prd-style.css의 전체 내용을 읽어 여기에 인라인 */
+</style>
+</head>
+<body>
+<!-- 표지 -->
+<div class="cover-page">
+  <h1>[문서 제목]</h1>
+  <div class="subtitle">[부제목 또는 한 줄 설명]</div>
+  <div class="version-badge">[버전 번호]</div>
+  <div class="meta-info">
+    <strong>PM</strong> [PM 이름]<br>
+    <strong>Date</strong> [ISO 날짜]<br>
+    <strong>Status</strong> [상태]
+  </div>
+</div>
+<!-- 범례 (증분 업데이트 문서에만 해당) -->
+<div class="diff-legend">
+  <div class="diff-legend-item"><div class="diff-legend-swatch swatch-new"></div> 이번 버전에서 신규</div>
+  <div class="diff-legend-item"><div class="diff-legend-swatch swatch-upd"></div> 이번 버전에서 수정</div>
+  <div class="diff-legend-item"><div class="diff-legend-swatch swatch-unchanged"></div> 변경 없음</div>
+</div>
+<!-- 목차 페이지 -->
+<div class="toc-page">
+  <h2>목차</h2>
+  <ul class="toc">
+    <!-- Claude가 h2 제목을 기반으로 목차 항목 자동 생성 -->
+    <li>
+      <span class="toc-title">[섹션명]</span>
+      <span class="toc-dots"></span>
+      <span class="toc-page-num">[페이지 번호]</span>
+    </li>
+  </ul>
+</div>
+<!-- 본문 내용 -->
+[본문 HTML]
+<!-- 푸터 -->
+<div class="doc-footer">
+  [문서 코드] [버전] ｜ [날짜] ｜ Generated by Product Playbook
+</div>
+</body>
+</html>
+```
+**중요 사항**:
+- CSS는 완전히 인라인되어야 함 (외부 링크 없음)
+- 폰트는 시스템 폰트 사용: `"PingFang TC", "Noto Sans TC", system-ui` (Playwright가 PDF에 자동 임베드)
+- `<script>` 태그나 외부 리소스 참조 없음
+- 목차 페이지 번호는 추정값 (PDF 생성 후 미세 조정 필요할 수 있음)
+**2단계: Playwright PDF 렌더링**
+HTML 콘텐츠를 `/tmp/export-{timestamp}.html`에 저장한 후 Playwright MCP 호출:
+```javascript
+// mcp__plugin_playwright_playwright__browser_run_code
+async (page) => {
+  const fs = require('fs');
+  const html = fs.readFileSync('/tmp/export-{timestamp}.html', 'utf8');
+  await page.setContent(html, { waitUntil: 'networkidle' });
+  await page.pdf({
+    path: '{output_path}',
+    format: 'A4',
+    margin: { top: '1.8cm', bottom: '1.8cm', left: '2cm', right: '2cm' },
+    printBackground: true,
+    displayHeaderFooter: true,
+    headerTemplate: '<div></div>',
+    footerTemplate: '<div style="font-size:8pt;color:#999;text-align:center;width:100%;">p.<span class="pageNumber"></span> / <span class="totalPages"></span></div>'
+  });
+  return 'PDF generated';
+}
+```
+> 참고: HTML 콘텐츠가 너무 크면 (>500KB), setContent가 타임아웃될 수 있습니다. 이 경우 경로 B (HTTP Server)로 전환합니다.
+**3단계: pikepdf 북마크 삽입**
+```python
+import pikepdf, re
+pdf = pikepdf.open('{output_path}')
+# HTML에서 h2 제목을 추출하여 북마크로 사용
+# Claude는 HTML 생성 시 각 h2의 예상 페이지 번호를 기록해야 함
+bookmarks = [
+    # (제목, 페이지 인덱스 0-based)
+    ("변경 이력", 2),
+    ("사용자 스토리", 4),
+    ("개발 아키텍처", 6),
+    # ... 실제 내용에 따라 생성
+]
+with pdf.open_outline() as outline:
+    for title, page_idx in bookmarks:
+        page_idx = min(page_idx, len(pdf.pages) - 1)
+        outline.root.append(
+            pikepdf.OutlineItem(title, page_idx)
+        )
+# PDF 메타데이터 설정
+with pdf.open_metadata() as meta:
+    meta['dc:title'] = '[문서 제목]'
+    meta['dc:creator'] = ['[PM 이름]']
+    meta['pdf:Producer'] = 'Product Playbook + Playwright'
+pdf.save('{output_path}')
+```
+**4단계: 사용자 알림**
+```
+✅ PDF 내보내기 완료: {output_path}
+  📄 {page_count} 페이지 ｜ {file_size}
+  📑 북마크 내비게이션 포함 ({bookmark_count}개 섹션)
+```
+### 경로 B: HTML 보고서 → PDF (HTTP Server)
+적용 대상: Mermaid 다이어그램, CDN 폰트, 인터랙티브 요소가 포함된 HTML 보고서.
+**1단계: HTML 보고서 이미 생성됨**
+HTML 보고서는 `06-html-report.md` 규칙에 의해 생성되어 `/tmp/report-{timestamp}.html`로 저장됩니다.
+**2단계: HTTP 서버 시작**
+```bash
+cd /tmp && python3 -m http.server 18899 &
+echo $!  # PID 기록
+```
+**3단계: Playwright 렌더링**
+```javascript
+// mcp__plugin_playwright_playwright__browser_run_code
+async (page) => {
+  await page.goto('http://localhost:18899/report-{timestamp}.html', {
+    waitUntil: 'networkidle',
+    timeout: 30000
+  });
+  // Mermaid 차트 렌더링 완료 대기
+  await page.waitForTimeout(3000);
+  // 모든 아코디언 (<details>) 요소 펼치기
+  await page.evaluate(() => {
+    document.querySelectorAll('details').forEach(d => d.open = true);
+  });
+  await page.pdf({
+    path: '{output_path}',
+    format: 'A4',
+    margin: { top: '1.8cm', bottom: '1.8cm', left: '2cm', right: '2cm' },
+    printBackground: true,
+    displayHeaderFooter: true,
+    headerTemplate: '<div></div>',
+    footerTemplate: '<div style="font-size:8pt;color:#999;text-align:center;width:100%;">p.<span class="pageNumber"></span> / <span class="totalPages"></span></div>'
+  });
+  return 'PDF generated';
+}
+```
+**4단계: HTTP 서버 종료 + pikepdf 북마크**
+```bash
+kill {SERVER_PID}
+```
+이후 경로 A와 동일한 pikepdf 북마크 삽입 단계를 수행합니다.
+### Playwright MCP 사용 불가 시 폴백
+Playwright MCP가 연결되지 않은 경우, Node.js를 직접 사용:
+```bash
+node -e "
+const { chromium } = require('playwright');
+const fs = require('fs');
+(async () => {
+  const browser = await chromium.launch({ headless: true });
+  const page = await browser.newPage();
+  const html = fs.readFileSync('/tmp/export-{timestamp}.html', 'utf8');
+  await page.setContent(html, { waitUntil: 'networkidle' });
+  await page.pdf({
+    path: '${OUTPUT_PATH}',
+    format: 'A4',
+    printBackground: true,
+    margin: { top: '1.8cm', bottom: '1.8cm', left: '2cm', right: '2cm' }
+  });
+  await browser.close();
+  console.log('PDF generated');
+})();
+"
+```
+---
+## DOCX 내보내기
+### 1단계: Markdown 생성
+Claude가 기획 산출물을 깔끔한 Markdown 형식으로 정리하여 `/tmp/export-{timestamp}.md`에 저장합니다.
+### 2단계: Pandoc 변환
+```bash
+pandoc /tmp/export-{timestamp}.md \
+  -o "{output_path}" \
+  --from markdown \
+  --to docx \
+  --reference-doc="~/.claude/skills/product-playbook/references/templates/reference.docx" \
+  --toc \
+  --toc-depth=2
+```
+reference.docx 템플릿이 없는 경우, `--reference-doc` 매개변수를 생략합니다 (Pandoc 기본 스타일 사용).
+### 3단계: 사용자 알림
+```
+✅ Word 문서 내보내기 완료: {output_path}
+  📄 목차 포함 ｜ {file_size}
+```
+---
+## PPTX 내보내기
+```bash
+pandoc /tmp/export-{timestamp}.md \
+  -o "{output_path}" \
+  --from markdown \
+  --to pptx \
+  --slide-level=2
+```
+> 팁: Pandoc PPTX 품질은 제한적입니다. PPTX를 아웃라인으로 사용하고, PowerPoint/Keynote에서 다듬는 것을 권장합니다.
+---
+## 증분 업데이트 문서 특수 처리
+기능 확장 또는 리비전 모드의 증분 업데이트 문서를 내보낼 때:
+### 차이 시각 표시 규칙
+1. **`[NEW]`로 표시된 단락**:
+   - `<span class="new">NEW</span>` 마커 사용
+   - 테이블 행에 `class="new-row"` 적용
+   - 단락에 `class="diff-added"` 적용
+2. **`[UPDATED]`로 표시된 단락**:
+   - `<span class="upd">UPDATED</span>` 마커 사용
+   - 테이블 행에 `class="upd-row"` 적용
+   - 원본 콘텐츠가 있는 경우, 원본에 `class="diff-removed"`, 새 콘텐츠에 `class="diff-added"` 적용
+3. **변경 없는 단락**: 정상 표시, 특별한 마커 없음
+4. **문서 시작 부분 범례**:
+```html
+<div class="diff-legend">
+  <div class="diff-legend-item">
+    <div class="diff-legend-swatch swatch-new"></div> 이번 버전에서 신규
+  </div>
+  <div class="diff-legend-item">
+    <div class="diff-legend-swatch swatch-upd"></div> 이번 버전에서 수정
+  </div>
+  <div class="diff-legend-item">
+    <div class="diff-legend-swatch swatch-unchanged"></div> 마커 없음 = 변경 없음
+  </div>
+</div>
+```
+---
+## 출력 경로 규칙
+기본적으로 `~/Downloads/`에 출력하며, 파일명 형식:
+```
+[문서 코드] [문서 제목] [버전].{ext}
+예시:
+[D-221] Virtual Account v1.0.14 Full Merged Version.pdf
+Product Planning Report - UPASS Virtual Account.docx
+```
+사용자가 경로를 지정하면, 사용자가 지정한 경로를 사용합니다.
+---
+## 품질 체크리스트
+내보내기 전에 Claude가 자체 점검:
+- [ ] HTML에 잔여 Markdown 구문 없음 (`**`, `##`, `|---|`)
+- [ ] 모든 테이블의 행/열 수가 원본 콘텐츠와 일치
+- [ ] `[NEW]` / `[UPDATED]` 마커가 해당 CSS 클래스에 올바르게 매핑
+- [ ] 표지 정보 (제목, 버전, PM, 날짜)가 정확
+- [ ] 목차 항목이 본문 h2 제목과 일치
+- [ ] CSS가 완전히 인라인됨 (경로 A) 또는 CDN 접근 가능 (경로 B)
+- [ ] 북마크 수가 h2 제목 수와 일치

package/i18n/ko/references/rules-file-integration.md ADDED Viewed

@@ -0,0 +1,65 @@
+# 📎 파일 통합 가이드
+> 사용자가 보충 자료를 업로드할 때 로드됩니다.
+## 직접 지원 파일 유형
+| 파일 유형 | 일반적인 시나리오 | 통합 방법 |
+|----------|----------------|----------|
+| **이미지** | 경쟁사 스크린샷, 화이트보드 사진, 손그림 여정 맵, 앱 인터페이스 스크린샷, 데이터 보고서 스크린샷 | 내용을 인식하고 해당 단계에 통합 |
+| **PDF** | 시장 보고서, 내부 문서, 사용자 리서치 보고서, 기존 PRD | `rules-import-document.md`를 로드하여 3계층 파싱 수행 (pymupdf 직접 추출 → Claude Vision 시맨틱 파싱 → Tesseract 폴백). 최초 사용 시 `rules-document-tools.md`를 로드하여 도구 확인. |
+| **CSV / Excel** | 사용자 행동 데이터, 리텐션 데이터, NPS 조사 결과, 매출 데이터 | 데이터를 분석하여 정량적 평가에 활용 |
+| **텍스트 파일** | 인터뷰 녹취록, 기존 요구사항 문서, 회의 노트 | Persona 단서, 페인포인트, JTBD 근거 추출 |
+| **DOCX** | 기존 PRD, 제품 스펙 문서, 사용자 리서치 보고서 | `rules-import-document.md`를 로드, Pandoc으로 Markdown 변환 후 통합. 최초 사용 시 `rules-document-tools.md`를 로드하여 도구 확인. |
+| **PPTX** | 기존 프레젠테이션, 제품 소개 슬라이드 | `rules-import-document.md`를 로드, Pandoc으로 Markdown 변환 후 통합. |
+## 직접 지원되지 않지만 가이드 가능
+| 파일 유형 | 가이드 |
+|----------|-------|
+| **비디오** | 사용자에게 핵심 장면을 설명하거나, 녹취/자막 파일을 제공하도록 요청 |
+| **Figma / Sketch** | 사용자에게 스크린샷을 찍어 업로드하도록 요청 |
+| **Protobuf / Swagger** | 사용자에게 JSON 또는 텍스트 형식으로 내보내도록 요청 |
+## 파일 → 단계 자동 매핑 테이블
+| 업로드 내용 | 자동 매핑 단계 | 통합 작업 |
+|------------|-------------|----------|
+| 경쟁사 앱 / 웹사이트 스크린샷 | 포지셔닝 | "경쟁 대안"으로 식별, 차별화 분석 |
+| 화이트보드 손그림 플로우차트 | Journey Map / OST | 플로우를 인식하고 구조화된 테이블로 변환 |
+| 사용자 인터뷰 녹취록 | Persona + JTBD | 페인포인트, 현재 우회 방법, 감정적 반응, Job 선언문 추출 |
+| 사용자 행동 데이터 (CSV) | 기회 평가 + North Star + PMF | 가정 기반 점수를 실제 데이터로 대체 |
+| NPS / 만족도 조사 | PMF + Sean Ellis Score | Score를 직접 계산; PMF 수준 판단 |
+| 기존 PRD / 요구사항 문서 | 리비전 모드 S1 + MVP | 기존 기능 목록과 의사결정 이력 추출 |
+| 시장 보고서 PDF | 기회 평가 + 전략 | 시장 규모, 트렌드, 경쟁 구도 추출 |
+| 매출 데이터 | 비즈니스 모델 + GTM | 매출 구조, 고객 분포, 채널 효과 분석 |
+| 앱 인터페이스 스크린샷 | Aha Moment + Journey | 현재 경험 경로 분석 |
+## 통합 규칙
+1. **능동적 식별**: 먼저 "당신이 [파일 유형]을 업로드하신 것을 확인했습니다. [핵심 정보]를 [단계명]에 통합하겠습니다."라고 설명
+2. **기존 산출물을 덮어쓰지 않음**: 업로드된 내용을 "보충 자료"로 표시하고, 산출물을 업데이트하며, 변경 전파 규칙을 트리거
+3. **출처 표시**: 산출물에 업로드된 파일에서 나온 내용을 주석 (예: "✦ 업로드된 사용자 리서치 보고서에서")
+4. **데이터 우선**: 실제 데이터가 이전 가정과 충돌할 때, 실제 데이터를 우선
+5. **단계 간 영향**: 단일 파일이 여러 단계에 영향을 미칠 수 있음 — 영향받는 모든 단계를 한 번에 나열
+## 📎 원본 문서 식별 및 증분 업데이트
+사용자가 **기능 확장** 또는 **리비전 모드**에서 파일을 업로드할 때, 해당 파일이 "원본 문서"(새로운 기획 산출물을 기반으로 증분 업데이트해야 할 문서)인지 판단합니다:
+### 식별 기준
+- 파일 유형: PRD, 제품 스펙, 아키텍처 문서, 요구사항 문서, 설계 문서
+- 사용자가 명시적으로 언급: "이것이 현재 PRD입니다", "이 문서를 업데이트해 주세요", "이 스펙을 기반으로 확장해 주세요" 등
+- 기능 확장 또는 리비전 모드의 S1(컨텍스트 수집) 단계에서 업로드
+### 원본 문서가 식별된 경우
+1. 표시: "📎 원본 문서 감지됨 — 최종 산출물은 이 파일을 기반으로 한 증분 업데이트가 됩니다"
+2. 문서 구조 분석 (섹션 제목, 서식 규칙, 네이밍 패턴)
+3. 일관된 산출물을 위해 문서의 서식과 스타일 기록
+4. S1 단계에서, 문서를 사용하여 기존 시스템 컨텍스트 사전 입력 (기술 스택, 모듈, 기능)
+### 증분 산출물 규칙 (최종 산출물 단계에서 적용)
+- 새로운 콘텐츠는 해당 섹션에 삽입하고 `[NEW]`로 표시
+- 수정된 콘텐츠는 `[UPDATED]`로 표시하고, 원본 콘텐츠는 주석으로 보존
+- 새 기능과 관련 없는 섹션은 그대로 유지
+- 산출물 문서는 원본 파일의 서식, 스타일 및 네이밍 규칙을 유지

package/i18n/ko/references/rules-full.md ADDED Viewed

@@ -0,0 +1,66 @@
+# 📦 풀 모드 단계 시퀀스 (20단계 + 최종 산출물)
+> 이 파일은 풀 모드의 권위 있는 단계 정의입니다. SKILL.md 코어 디스패처에 의해 로드됩니다.
+## 단계 시퀀스
+```
+Phase 0: 사전 요건
+  S1.  기회 평가 + DHM → references/00-opportunity-check.md 읽기
+  S2.  Strategy Blocks + Rumelt 전략 핵심 → references/01-strategy.md 읽기
+Phase 1: 디스커버리
+  S3.  Persona 테이블 → references/02a-persona.md 읽기
+  S4.  Persona 카드 → references/02a-persona.md 읽기
+  S5.  JTBD 분석 → references/02b-jtbd.md 읽기
+  S6.  Opportunity Solution Tree (OST) → references/02c-ost-journey.md 읽기
+  S7.  User Journey Map → references/02c-ost-journey.md 읽기
+Phase 2: Define
+  S8.  페인포인트 요약 테이블 → references/03-define.md 읽기
+  S9.  April Dunford 포지셔닝 → references/03-define.md 읽기
+  S10. HMW 재구성 → references/03-define.md 읽기
+  S11. 기회 평가 테이블 → references/03-define.md 읽기
+Phase 3: Develop
+  S12. PR-FAQ → references/04a-prfaq.md 읽기
+  S13. 병렬 프로토타입 → references/04b-solutions.md 읽기
+  S14. Pre-mortem → references/04b-solutions.md 읽기
+  S15. GEM + RICE 우선순위 → references/04b-solutions.md 읽기
+  S16. User Story → references/04b-solutions.md 읽기
+  S17. MVP + Not Doing List → references/04c-mvp.md 읽기
+Phase 4: Deliver
+  S18. North Star + 3계층 시그널 + Aha Moment → references/05a-northstar-aha.md 읽기
+  S19. PMF 수준 평가 + GTM 전략 + 비즈니스 모델 → references/05b-pmf-gtm.md 읽기
+  S20. 가설 검증 계획 → references/05c-validation-spec.md 읽기
+────
+최종 산출물 → 제품 스펙 요약 (references/05c-validation-spec.md → 4.6) + 최적 진입점 분석
+```
+> 풀 모드에서, 대상 독자가 경영진 또는 크로스펑셔널 팀인 경우 S18 앞에 섹션 4.1 Empowered Teams가 추가됩니다; 그 외에는 건너뛰기.
+## 레퍼런스 로딩 지침
+각 단계에 진입할 때만 해당 레퍼런스 파일을 읽으세요 (모든 파일을 사전 로드하지 마세요):
+| 단계 | 레퍼런스 파일 |
+|------|-------------|
+| S1 | `references/00-opportunity-check.md` |
+| S2 | `references/01-strategy.md` |
+| S3-S4 | `references/02a-persona.md` |
+| S5 | `references/02b-jtbd.md` |
+| S6-S7 | `references/02c-ost-journey.md` |
+| S8-S11 | `references/03-define.md` |
+| S12 | `references/04a-prfaq.md` |
+| S13-S16 | `references/04b-solutions.md` |
+| S17 | `references/04c-mvp.md` |
+| S18 | `references/05a-northstar-aha.md` |
+| S19 | `references/05b-pmf-gtm.md` |
+| S20 + 최종 산출물 | `references/05c-validation-spec.md` |
+## 최종 산출물 형식
+**최적 진입점 분석** (전체 로직 체인) + **제품 스펙 요약**
+완료 후, `references/rules-end-of-flow.md`에 따라 플로우 종료 규칙을 실행하세요.