product-playbook 1.0.0

package/i18n/ja/references/rules-import-document.md

@@ -0,0 +1,261 @@
+# ドキュメントインポート解析ルール
+
+> ユーザーが PDF / DOCX / PPTX ファイルをアップロード、または `/parse [file]` をトリガーした時に読み込みます。
+> 初回使用時は先に `rules-document-tools.md` を読み込んでツールがインストール済みか確認してください。
+> 本ルールは `rules-file-integration.md` と連携して使用します — そちらが「いつトリガーするか」を定義し、本ファイルが「どう解析するか」を定義します。
+
+---
+
+## 解析目標
+
+あらゆる形式の入力ドキュメントを**構造化 Markdown** に変換し、後続フローで使用：
+- Feature Extension / Revision モードの S1 コンテキスト収集
+- インクリメンタル更新の元ドキュメントベース
+- 一般的なドキュメントコンテンツ抽出
+
+---
+
+## PDF 解析：三層戦略 + ページ単位検出
+
+### 概要
+
+```
+入力 PDF
+  │
+  ▼
+pymupdf ページ単位テキスト抽出（ゼロコスト）
+  │
+  ├── そのページのテキスト > 30 文字 → ✅ 直接 Markdown に変換（層 1）
+  │
+  └── そのページのテキスト ≤ 30 文字（空白 / ベクターパス / スキャン文書）
+        │
+        ├── デフォルト → Claude Vision セマンティック解析（層 2）
+        │
+        └── Vision 利用不可 / Token 予算不足 → Tesseract OCR（層 3）
+```
+
+### ステップ 1：ページ単位タイプ検出
+
+**重要な原則**：「ページ」単位で検出し、ドキュメント全体ではない。1つの PDF にデジタルテキストページとスキャン画像ページが混在する場合がある。
+
+```python
+import fitz  # pymupdf
+
+doc = fitz.open(pdf_path)
+total_pages = len(doc)
+page_results = {}
+
+for i in range(total_pages):
+    page = doc[i]
+    text = page.get_text("text").strip()
+
+    if len(text) > 30:
+        # 層 1：デジタルテキスト、直接抽出
+        page_results[i] = {"type": "digital", "text": text}
+    else:
+        # Vision または OCR が必要
+        page_results[i] = {"type": "needs_vision", "text": None}
+
+digital_count = sum(1 for p in page_results.values() if p["type"] == "digital")
+vision_count = total_pages - digital_count
+
+print(f"PDF 分析：{total_pages} ページ、{digital_count} ページ直接抽出可能、{vision_count} ページ視覚解析が必要")
+```
+
+### ステップ 2：大容量ファイル処理戦略
+
+| 条件 | 戦略 |
+|------|------|
+| 全ページが digital（vision_count = 0）| 全ページを直接抽出、ゼロコスト |
+| vision_count ≤ 20 | Claude Vision で視覚解析が必要な全ページを一括読み取り |
+| vision_count > 20 | バッチ処理（各バッチ ≤ 20 ページ）、結果をマージ |
+| 総ページ数 > 50 かつ vision_count > 20 | 全文解析かページ範囲指定かユーザーに確認 |
+
+**大容量ファイル（>50 ページ）のユーザー確認プロンプト**：
+
+```
+📄 この PDF は全 {total_pages} ページです：
+  • {digital_count} ページはテキスト直接抽出可能（無料）
+  • {vision_count} ページは視覚解析が必要（Vision Token を消費）
+
+選択してください：
+  1️⃣ 全文解析（完全だが Token 消費が多い）
+  2️⃣ 特定ページのみ解析（ページ範囲を入力、例：1-10,15,20-25）
+  3️⃣ 直接抽出可能なページのみ抽出（スキャン/ベクターページをスキップ）
+```
+
+### ステップ 3：層 1 — pymupdf 直接抽出
+
+```python
+def extract_digital_pages(doc, page_results):
+    """全デジタルテキストページを抽出"""
+    markdown_parts = []
+    for i, result in sorted(page_results.items()):
+        if result["type"] == "digital":
+            markdown_parts.append(f"<!-- Page {i+1} -->\n{result['text']}")
+    return "\n\n".join(markdown_parts)
+```
+
+### ステップ 4：層 2 — Claude Vision セマンティック解析
+
+`needs_vision` タイプのページについて、まず pymupdf で PNG 画像にレンダリングし、Claude の Read ツールで読み取り。
+
+**画像にレンダリング**：
+```python
+def render_pages_to_png(doc, page_indices, dpi=300):
+    """指定ページを PNG にレンダリング"""
+    output_files = []
+    for i in page_indices:
+        page = doc[i]
+        pix = page.get_pixmap(dpi=dpi)
+        output_path = f"/tmp/pdf-page-{i+1:04d}.png"
+        pix.save(output_path)
+        output_files.append((i, output_path))
+    return output_files
+```
+
+**Claude Vision 解析プロンプト**：
+
+視覚解析が必要な各ページ（またはバッチ）について、Read ツールで PNG を読み込んだ後、以下のプロンプトで変換：
+
+```
+あなたは PDF ドキュメントの第 {page_num}/{total_pages} ページを読んでいます。
+このページの内容を正確に Markdown 形式に変換してください。
+
+厳格ルール：
+1. 表 → Markdown table（全カラム、行数、配置を保持）
+2. 見出し → # / ## / ### で元のレベルに対応
+3. 番号付きリスト → 1. 2. 3.（元の番号を保持）
+4. 箇条書き → - または •
+5. 太字/斜体 → **太字** / *斜体*
+6. 図表/画像 → > [図表：内容の簡潔な説明]
+7. ヘッダー、フッター、ページ番号 → 無視
+8. 数字、日付、人名、アカウント → 100% 正確でなければならない、推測しない
+9. 原文にない内容を追加しない
+10. 翻訳しない — 原文の言語を保持
+```
+
+> **なぜ OCR より優れているか**：Claude は表の「セマンティック構造」を理解します（最初の行がヘッダー、どのカラムが揃っているか）。Tesseract は文字単位の認識後にルールで表を再構築するだけで、しばしば失敗します。
+
+### ステップ 5：層 3 — Tesseract OCR Fallback
+
+以下の場合のみ使用：
+- ユーザーが Token 節約を明示的にリクエスト
+- Claude Vision が利用不可（API 制限等）
+- オフライン環境
+
+```python
+import subprocess
+from PIL import Image
+
+def ocr_page(png_path, lang="chi_tra+eng"):
+    """Tesseract OCR 単一ページ"""
+    # macOS の tesseract は PNG を直接読めない場合がある — TIFF に変換するか stdin を使用
+    tiff_path = png_path.replace('.png', '.tiff')
+    Image.open(png_path).save(tiff_path)
+
+    result = subprocess.run(
+        ['tesseract', 'stdin', 'stdout', '-l', lang],
+        stdin=open(tiff_path, 'rb'),
+        capture_output=True, text=True, timeout=120
+    )
+    return result.stdout
+```
+
+**Tesseract 注意事項（実戦経験）**：
+- macOS 上の tesseract は PNG ファイルを直接読めない場合がある — `stdin` パイプを使用するか先に TIFF に変換
+- 推奨解像度 300dpi
+- `chi_tra+eng` 言語パックで繁体中国語と英語を同時認識
+- OCR 結果は後処理が必要：改行の結合、表構造の修復
+
+### ステップ 6：全ページをマージ
+
+```python
+def merge_all_pages(digital_md, vision_md_list):
+    """ページ順に全ページの Markdown をマージ"""
+    all_pages = {}
+    # digital pages
+    for page_num, md in digital_md.items():
+        all_pages[page_num] = md
+    # vision/ocr pages
+    for page_num, md in vision_md_list.items():
+        all_pages[page_num] = md
+
+    # ページ番号順にソートしてマージ
+    final_md = []
+    for i in sorted(all_pages.keys()):
+        final_md.append(all_pages[i])
+
+    return "\n\n---\n\n".join(final_md)
+```
+
+### ステップ 7：出力してユーザーに通知
+
+```
+📄 PDF 解析完了：
+  • 総ページ数：{total_pages}
+  • 直接抽出：{digital_count} ページ（pymupdf）
+  • 視覚解析：{vision_count} ページ（Claude Vision）
+  • 出力：{output_path}（Markdown、{文字数} 文字）
+```
+
+---
+
+## DOCX 解析
+
+```bash
+pandoc "{input_path}" -t markdown -o "/tmp/parsed-{timestamp}.md" --wrap=none
+```
+
+**後処理**：
+- Pandoc が生成する余分な空行を削除
+- 表フォーマットが正しいことを確認
+
+---
+
+## PPTX 解析
+
+```bash
+pandoc "{input_path}" -t markdown -o "/tmp/parsed-{timestamp}.md" --wrap=none
+```
+
+> Pandoc は各スライドを `##` 見出しセクションに変換します。
+
+---
+
+## HTML 解析
+
+```bash
+pandoc "{input_path}" -f html -t markdown -o "/tmp/parsed-{timestamp}.md" --wrap=none
+```
+
+---
+
+## 画像解析
+
+Claude Read ツールで直接画像を読み取り、Vision 解析プロンプトに従って Markdown に変換。
+
+---
+
+## rules-file-integration.md との連携
+
+`rules-file-integration.md` が以下のシナリオを検出した場合、本ルールを読み込みます：
+
+| シナリオ | アクション |
+|------|------|
+| ユーザーが Feature Extension S1 で PDF をアップロード | 本ルールを読み込み → PDF を解析 → 既存システム背景を抽出 |
+| ユーザーが Revision S1 で旧バージョン PRD をアップロード | 本ルールを読み込み → PDF を解析 → リビジョンベースとして使用 |
+| ユーザーが `/parse` コマンドを使用 | 本ルールを読み込み → 指定ファイルを解析 → Markdown を出力 |
+| ユーザーが市場レポート PDF をアップロード | 本ルールを読み込み → 主要情報を抽出 → 対応するステップに統合 |
+
+### 元ドキュメント識別
+
+解析完了後、そのファイルが「元ドキュメント」（PRD、仕様書等）であると判断した場合、自動マーク：
+
+```
+📎 元ドキュメントを検出しました — 最終出力はこのファイルに基づくインクリメンタル更新になります。
+  ドキュメント構造：{セクション数} セクション、{テーブル数} テーブル
+  フォーマット規則：[識別されたフォーマット特徴]
+```
+
+ドキュメント構造を記録し、`rules-export-document.md` が最終出力時に使用できるようにします。

package/i18n/ja/references/rules-product-type.md

@@ -0,0 +1,14 @@
+# 🏢 B2B / B2C差異調整
+
+> プロダクトタイプ確認後に読み込みます。Claudeは各フレームワーク内で以下の調整を自動適用します。
+
+| フレームワーク | B2C調整 | B2B調整 |
+|-----------|----------------|----------------|
+| **ペルソナ** | 個人のモチベーション/習慣でセグメント | 「購買意思決定者」と「実際のエンドユーザー」を2つのペルソナタイプとして区別；「組織規模」と「調達プロセス」フィールドを追加 |
+| **JTBD** | 個人の感情的・社会的ジョブにフォーカス | 「組織レベルのジョブ」を追加：会社のどんな目標達成に貢献するか？組織内で個人はどんなジョブを達成するか？ |
+| **PMF評価** | 主にDAU/MAU、リテンション率、Sean Ellis Scoreに基づく | 主に「有料顧客 + 拡張率 + NPS」に基づく；レベル1 = 有料顧客3-5社 |
+| **Aha Moment** | 初回使用時にコア価値を体験 | オンボーディング/トライアル期間まで出現しない可能性；「Time-to-Value」メトリクスを設計 |
+| **MVP** | 完全な軽量プロダクトが可能 | Pilot（特定顧客向けのカスタマイズデプロイ）が必要な場合あり |
+| **GTM** | 主にProduct-Led Growth（PLG）またはコミュニティ駆動 | 主にセールス駆動またはパートナーチャネル駆動 |
+| **プライシング** | Freemium / サブスクリプション / 従量課金 | 年間契約 / シートベース / 従量課金 / カスタム見積 |
+| **North Star** | ユーザーアクティビティまたはコアアクション完了数 | ARR、Net Revenue Retention、アクティブアカウント |

package/i18n/ja/references/rules-progress.md

@@ -0,0 +1,60 @@
+# 🔁 進捗の永続化と中断リカバリー
+
+> ユーザーが「一時停止」「保存」と言った時、またはスキルが起動時に進捗をチェックする時に読み込みます。
+
+## 進捗ファイルフォーマット
+
+各ステップ完了後、プロジェクトディレクトリに`.product-playbook-progress.md`を作成または更新：
+
+```
+# Product Playbook Progress Save
+
+- モード：[クイックモード / フルモード / ...]
+- プロダクトタイプ：[B2C / B2B / ...]
+- プロダクト説明：[ユーザーのプロダクト説明]
+- 現在の進捗：S[X] / S[Y]
+- 最終更新：[タイムスタンプ]
+
+## 完了ステップ
+
+### S1：[ステップ名] ✅
+[このステップのコア出力 — リカバリー時にやり直す必要がないよう十分な詳細を保持]
+
+### S2：[ステップ名] ✅
+[同上]
+
+## 未着手ステップ
+- S3：[ステップ名]
+- S4：[ステップ名]
+- ...
+```
+
+### 機能拡張モードの例
+```markdown
+モード：機能拡張
+ステップ：S2/S4
+S1：問題 + 既存システムのコンテキスト ✅
+S2：3つの並行ソリューション + AI推奨 ▶️
+S3：リスク評価 ⬜
+S4：実行スコープ ⬜
+```
+
+## トリガールール
+
+1. **自動保存**：各ステップが完了しユーザーに確認された後、即座に進捗ファイルを更新
+2. **起動時チェック**：スキルがトリガーされた際、まず`.product-playbook-progress.md`が存在するか確認。存在する場合、表示：
+```
+未完了のプロダクト企画進捗を検出しました（[モード名]、S[X]/S[Y]）：
+  1️⃣ 続行 — S[X]から再開
+  2️⃣ 最初から — 古い進捗をクリアして最初から開始
+（1または2を入力）
+```
+3. **一時停止コマンド**：ユーザーが「一時停止」「他のことをする」「保存」と言った場合、進捗ファイルが更新されたことを確認し回答：「進捗を.product-playbook-progress.mdに保存しました（S[X]/S[Y]）。次回このプロジェクトでスキルを起動する際に自動的に検出されます。」
+4. **完了時のクリーンアップ**：フロー全体が完了し最終ドキュメントが作成された後、進捗ファイルを削除するかユーザーに確認
+6. **バージョン管理リマインダー**：`.product-playbook-progress.md`が初めて作成された際、ユーザーにリマインド：「⚠️ `.product-playbook-progress.md`を`.gitignore`に追加することをお勧めします — このファイルには機密プロダクト戦略情報が含まれる可能性があります。」
+5. **中断保存**：フロー中に無関係なプロンプトが検出された場合（SKILL.mdフロー中断処理ルール参照）、現在のステップが完了していなくても進捗を保存。保存フォーマットで現在のステップには✅ではなく🔶（進行中）を使用し、部分的に作成されたコンテンツを保持：
+```
+### S[X]：[ステップ名] 🔶（進行中、部分完了）
+[部分的に作成されたコンテンツ]
+⚠️ このステップは未完了 — リカバリー時はここから再開
+```

package/i18n/ja/references/rules-quick.md

@@ -0,0 +1,29 @@
+# 🚀 クイックモード ステップ順序（3ステップ + 最終出力）
+
+> このファイルはクイックモードの正式なステップ定義です。SKILL.mdコアディスパッチャーにより読み込まれます。
+
+## ステップ順序
+
+```
+S1. JTBD Statement → references/02b-jtbd.md を読み込み
+S2. PR-FAQ → references/04a-prfaq.md を読み込み
+S3. North Star Metric + Aha Moment → references/05a-northstar-aha.md を読み込み
+────
+最終出力 → 1ページの方向性サマリー
+```
+
+## リファレンス読み込み指示
+
+各ステップに入る時に対応するリファレンスファイルを読み込み：
+
+| ステップ | リファレンスファイル |
+|------|---------------|
+| S1 | `references/02b-jtbd.md` |
+| S2 | `references/04a-prfaq.md` |
+| S3 | `references/05a-northstar-aha.md` |
+
+## 最終出力フォーマット
+
+**1ページの方向性サマリー**：問題 → ソリューション → 成功の定義、の3部構成。クイックブリーフィングやチームシンクに適しています。
+
+完了後、`references/rules-end-of-flow.md`に従ってエンドオブフロールールを実行してください。クイックモードではプレゼンテーションが必要かのみ確認 — PRDや開発ハンドオフパッケージは提案しません（内容が十分包括的ではないため）。

package/i18n/ja/references/rules-revision.md

@@ -0,0 +1,64 @@
+# 🔄 リビジョンモード ステップ順序（12ステップ + 最終出力）
+
+> このファイルはリビジョンモードの正式なステップ定義です。SKILL.mdコアディスパッチャーにより読み込まれます。
+
+## ステップ順序
+
+```
+Phase 0：現状分析
+  S1.  既存プロダクトレビュー（ユーザーデータ概要 + コアメトリクス + 既知の問題 + セキュリティステータス）
+  S2.  既存ユーザーJTBDの再検証（うまくいっているジョブは？いないジョブは？）
+
+Phase 1：問題の収束
+  S3.  ユーザーペインポイント収集（リテンション/チャーン分析 + ユーザーフィードバック統合 + 行動データ）
+  S4.  ペインポイントサマリー表 → references/03-define.md → 2.1 を読み込み
+  S5.  ポジショニング再評価 → references/03-define.md → 2.2 を読み込み（フォーカス：ポジショニング調整が必要か？）
+  S6.  HMW質問リフレーミング → references/03-define.md → 2.3 を読み込み
+  S7.  機会評価表 → references/03-define.md → 2.4 を読み込み
+
+Phase 2：ソリューション設計
+  S8.  PR-FAQ → references/04a-prfaq.md を読み込み（リビジョン後の体験を記述）
+  S9.  Pre-mortem → references/04b-solutions.md → 3.3 を読み込み
+  S10. MVPスコープ + Not Doing List → references/04c-mvp.md を読み込み（フォーカス：変更すること / 変更しないこと）
+
+Phase 3：バリデーション
+  S11. North Star + Aha Moment → references/05a-northstar-aha.md を読み込み（リビジョン前後のメトリクス比較）
+  S12. 仮説検証プラン → references/05c-validation-spec.md を読み込み
+────
+最終出力 → プロダクトスペックサマリー（リビジョン版）
+```
+
+### S1 プレステップ：プロダクトコンテキスト読み込み
+
+S1に入る前に、`references/rules-context.md`を読み込み、`.product-context.md`を確認：
+
+- **完全なコンテキストあり（シナリオ1）**：PMFレベル、North Star、既知のペインポイント、セキュリティステータス、最新3件のDecision Historyエントリを自動反映。S1のガイダンスを**差分モード**に切り替え：「前回の評価では、PMFレベルは[X]、North Star Metricは[Y]でした。変化はありますか？最新のDAU/MAUとリテンション数値はどうですか？」— 以前収集した決定履歴と既知のペインポイントは再収集不要。
+- **コンテキストなし（シナリオ2）**：Context Bootstrap（`rules-context.md`セクション4、ラウンド1 + 3）をトリガーし、以下の標準S1データ収集に進む。
+- **部分的コンテキスト（シナリオ3）**：Decision Historyから機能変更履歴を読み込み（どのモジュールが変更され、どのリスクが特定されたかを把握）、全体的なプロダクト戦略とメトリクスについては確認（過去の作業は機能拡張のみで全体像が不足）。
+
+### S1 標準ガイダンス
+
+> リビジョンモードのS1はユーザーに既存プロダクトデータの提供を積極的に求めます：DAU/MAU、リテンション率、主要ユーザーフィードバック、過去のバージョン決定など。コンテキストが一部の回答を事前入力している場合は、再収集ではなく確認。
+> S1では現在のセキュリティステータスも収集：既存の認証/認可メカニズム、既知のセキュリティ脆弱性や技術的負債、最近のセキュリティインシデント。この情報はリビジョンのリスク評価とPre-mortemに影響します。
+
+### ファストパス
+
+S1でユーザーが十分なデータ（ユーザーフィードバック、メトリクス、ペインポイントを含む）を提供した場合、S4-S7（ペインポイント → ポジショニング → HMW → 機会評価）を単一の会話ターンで作成可能、4回ではなく1回の確認のみ。トリガー条件：S3で収集したペインポイントリストに既に明確な優先順位付けとデータの裏付けがある。ハードゲートルールは変更なし — 各ステップの出力は完全に提示する必要がある；確認のリズムのみ加速。
+
+## リファレンス読み込み指示
+
+| ステップ | リファレンスファイル |
+|------|---------------|
+| S1-S3 | 外部リファレンス不要（ユーザーにデータを直接提供するようガイド） |
+| S4-S7 | `references/03-define.md` |
+| S8 | `references/04a-prfaq.md` |
+| S9 | `references/04b-solutions.md` |
+| S10 | `references/04c-mvp.md` |
+| S11 | `references/05a-northstar-aha.md` |
+| S12 + 最終出力 | `references/05c-validation-spec.md` |
+
+## 最終出力フォーマット
+
+**リビジョンプロダクトスペックサマリー**：Before/After比較 + 変更すること / 変更しないこと + 成功メトリクス
+
+完了後、`references/rules-end-of-flow.md`に従ってエンドオブフロールールを実行してください。