product-playbook 1.0.0

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

@@ -0,0 +1,98 @@
+# 🔧 フレームワークメニュー + 補助コマンド
+
+> ユーザーが「フレームワーク一覧」「利用可能なフレームワークを見せて」とリクエストした時、または補助コマンドを使用した時に読み込みます。
+
+## フレームワークの指定
+
+**2つのトリガー方法：**
+
+**方法A（ユーザーが直接フレームワーク名を指定）：** そのフレームワークのガイドフローに直接進む — 再確認不要。
+
+**方法B（ユーザーが「フレームワークを選びたい」「全フレームワーク一覧」など）：** 以下のメニューを提示：
+
+```
+📚 利用可能なフレームワーク — 番号または名前を入力：
+
+【ユーザー理解】
+ 1. JTBD（Jobs to Be Done）— ユーザーが本当に達成したいジョブを特定
+ 2. ペルソナ — 利用目的/タスク/モチベーション駆動のユーザープロフィール構築
+ 3. ユーザージャーニーマップ — 完全なユーザー体験ジャーニーをマッピング
+ 4. Continuous Discovery — ユーザーとの週次対話の習慣を構築
+
+【問題定義】
+ 5. OST / Opportunity Solution Tree — 機会とソリューションを体系的にリンク
+ 6. ポジショニング / April Dunford — 真の競争領域と差別化を発見
+ 7. HMW — ペインポイントをデザイン質問にリフレーミング
+
+【ソリューション設計】
+ 8. Working Backwards / PR-FAQ — ユーザーアウトカムから逆算してソリューションを設計
+ 9. Pre-mortem — 失敗が起きる前に予測し防止
+10. GEM — Growth / Engagement / Monetization 3次元優先順位付け
+11. RICE — 定量的な機能優先順位付け
+12. MVP — 最小実行可能プロダクトのスコープ定義
+
+【戦略レイヤー】
+13. Strategy / Strategy Blocks — Mission → Vision → Strategy の階層
+14. DHMモデル — Delight / Hard to copy / Margin-enhancing の機会評価
+15. LNOフレームワーク — Leverage / Neutral / Overhead の時間配分
+16. Empowered Teams — エンパワードチーム vs フィーチャーチーム
+
+【測定レイヤー】
+17. North Star / North Star Metric — コアユーザー価値を表す単一メトリクスを定義
+18. PMF — 4段階のProduct-Market Fit評価
+19. Sean Ellis Score — PMF熱狂度の定量化
+
+【ビジネスレイヤー】
+20. ビジネスモデル＆プライシング — 収益モデル選択と価値ベースプライシングアラインメント
+21. GTM戦略 — Go-to-Marketローンチと顧客獲得戦略
+
+【開発ハンドオフ】
+22. 開発ハンドオフ — CLAUDE.md + TASKS.md + TICKETS.md を生成してClaude Codeで開発ハンドオフ
+
+フレームワーク番号または名前を入力（複数選択可、カンマ区切り）：
+```
+
+## ディスカバリーをスキップ / ビルドに直行
+
+ユーザーが「ユーザーリサーチをスキップ」「問題はもう分かっている」「Developに直行」と言った場合、`references/rules-build.md`を読み込み、ビルドモードのステップ順序に従ってください。
+
+> ユーザーにリマインド：「ユーザーリサーチフェーズをスキップすることは、ソリューションが仮定に基づいて構築されることを意味します。実行後できるだけ早くContinuous Discoveryを実施して検証することをお勧めします。」
+
+## 機能拡張モードのトリガー
+
+- 「機能を追加」/「新しい機能を追加したい」/「既存プロダクトに新機能」→ 機能拡張モードをトリガー（`references/rules-build.md` → 機能拡張クイックパスを読み込み）
+
+## 補助コマンド
+
+| コマンド | 動作 |
+|---------|----------|
+| `「[フレームワーク]に切り替え」` | 即座に切り替え、完了済み内容を保持 |
+| `「ターゲットオーディエンスを変更したい」` | フレームワーク優先度とプレゼンテーションスタイルを再調整 |
+| `「このステップをスキップ」` | 必要性をリマインドした後、決定を尊重して次のステップへ |
+| `「[ステップ/フレームワーク名]に戻る」` | 指定ステップに戻り再ガイド（`references/rules-change-propagation.md`参照） |
+| `「簡潔に」` / `「詳しく」` | 要点に凝縮 / 詳細な分析を追加 |
+| `「レポートを生成」` | `references/06-html-report.md`を読み込み、HTML企画レポートを作成 |
+| `「PRDを生成」` / `「エンジニアドキュメントを生成」` | `references/04b-solutions.md`を読み込み、PR-FAQ + MVP + User Story + Pre-mortemを統合し、**自動的にフローチャート（Mermaid） + DBスキーマ（Mermaid ERD） + UIワイヤーフレーム（HTML）も生成** |
+| `「フローチャートを生成」` / `「フローチャートを描いて」` | Mermaid構文でフローチャートを出力（単独トリガー） |
+| `「DBスキーマを生成」` / `「データベースを設計」` | Mermaid ERD構文でDBスキーマを出力（単独トリガー） |
+| `「UIワイヤーフレームを生成」` / `「ワイヤーフレームを描いて」` | HTML/SVGで低忠実度UIワイヤーフレームを出力（単独トリガー） |
+| `「プレゼンを生成」` / `「PPTを作って」` | システムのpptxスキルを呼び出し |
+| `「このドキュメントを[オーディエンス]向けにアレンジ」` | 指定オーディエンス向けにフレームワークハイライトと言語を再編成 |
+| `「15分しかない」` | 最も重要な3つの意思決定質問またはアクションを提供 |
+| `「完成度評価を実行」` | どの領域が堅実で、どの領域にリスクがあるか評価 |
+| `「仮定を見つけて」` | すべての未検証コア仮定を特定 |
+| `「Pre-mortemを実行」` | 任意のソリューションに対して即座にPre-mortemを実行 |
+| `「異なるオーディエンス向けバージョンを生成」` | 複数オーディエンス向けのサマリーを自動作成 |
+| `「このプロダクトのPMFレベルは？」` | PMFレベルを判定し、次のマイルストーンを説明 |
+| `「ボトルネックを見つけて」` | Aha Moment達成の最大の障害を分析 |
+| `「これはリビジョンで、新プロダクトではない」` | リビジョンモードに切り替え（`references/rules-revision.md`を読み込み） |
+| `「上司を説得して承認してもらいたい」` | ボスモードに切り替え — ビジネス価値とリソースロジックを強調 |
+| `「開発を始めて」` / `「開発ハンドオフパッケージを生成」` | `references/07a-handoff-core.md`を読み込み、技術スタックを確認、完全な開発ハンドオフパッケージを生成 |
+| `「プロジェクトをセットアップ」` / `「Claude Codeに接続」` | 上記と同じ |
+| `「一時停止」` / `「保存」` / `「他のことをする」` | `references/rules-progress.md`に従い進捗を保存 |
+| `「続行」` / `「企画に戻る」` | `references/rules-progress.md`に従い再開 |
+| `「進捗をクリア」` / `「最初からやり直す」` | 進捗ファイルを削除しゼロから開始 |
+| `/export [format]` | 指定フォーマットでエクスポート。format = `pdf` / `docx` / `pptx` / `html` / `md`。`references/rules-export-document.md` を読み込み、初回使用時はまず `references/rules-document-tools.md` を読み込みツールを確認。 |
+| `/parse [file]` | アップロードされたドキュメントを Markdown に解析。PDF / DOCX / PPTX / 画像に対応。`references/rules-import-document.md` を読み込み、初回使用時はまず `references/rules-document-tools.md` を読み込みツールを確認。 |
+
+**コンテキスト対応コマンドヒント**：各ステップ完了後、現在の進捗に基づいて最も関連性の高い利用可能なコマンドを2-3個積極的に提案してください。

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

@@ -0,0 +1,291 @@
+# 📦 プロダクトコンテキスト蓄積ルール
+
+> このファイルは`.product-context.md`のフォーマット、読み書きルール、シナリオ処理、コンフリクト解決を定義します。
+> SKILL.md起動フローまたは各モードのS1プレステップにより読み込まれます。
+
+## 1. ファイル位置＆ライフサイクル
+
+- **パス**：プロジェクトルートディレクトリの`.product-context.md`（`.product-playbook-progress.md`と同じレベル）
+- **永続保持**：このファイルはフロー終了時に**削除されません** — セッションを跨いで永続し蓄積されます
+- **初回作成時**、ユーザーにリマインド：「⚠️ `.product-context.md`を`.gitignore`に追加することをお勧めします — このファイルには機密プロダクト戦略情報が含まれる可能性があります。」
+
+---
+
+## 2. ファイルフォーマット
+
+```markdown
+# Product Context
+<!-- Auto-maintained by product-playbook. Do not delete. -->
+<!-- last-updated: [ISOタイムスタンプ] -->
+
+## Identity
+- **プロダクト名**: [名前]
+- **プロダクトタイプ**: [B2C / B2B / B2B2C / 社内ツール]
+- **ワンライナー**: [一文の説明]
+- **ターゲットオーディエンス**: [プライマリペルソナのサマリー]
+
+## Core Strategy
+- **コアJTBD**: [ターゲット顧客] + [コンテキスト]で + [ジョブ]をしたい
+  - 機能面: [...]
+  - 感情面: [...]
+  - 社会面: [...]
+- **ポジショニング（April Dunford）**:
+  - 実際の競合代替品: [...]
+  - ユニーク属性: [...]
+  - コア価値: [...]
+  - ターゲット市場: [...]
+  - 市場カテゴリー: [...]
+- **North Star Metric**: [メトリクス名 + 定義]
+- **Aha Moment**: [説明]
+
+## Architecture & Tech Stack
+- **技術スタック**: [言語、フレームワーク、インフラ]
+- **キーモジュール**: [キーモジュールのリスト]
+- **データモデルハイライト**: [コアデータエンティティ（判明している場合）]
+
+## Decision History
+<!-- Append-only. フロー完了ごとに1エントリを追加。 -->
+
+### [ISO日付] - [フロータイプ: Full/Quick/Revision/Feature Extension/Custom/Build]
+- **スコープ**: [企画/変更スコープ]
+- **主要決定**: [主要な決定事項]
+- **特定されたリスク**: [リスク]
+- **MVP境界**: [やること / やらないこと]
+- **成功メトリクス**: [成功メトリクス + 目標値]
+
+## Language Preference
+- **インストール言語**: [.langファイルから自動検出またはユーザーの言語]
+- **ユーザーの希望言語**: [ユーザーがコミュニケーションに使用する言語]
+
+## Accumulated Insights
+- **既知のペインポイント**: [ペインポイントリスト（出典付き）]
+- **ユーザーフィードバックテーマ**: [セッション横断のフィードバックテーマ]
+- **PMFステータス**: [直近の評価レベル + 日付]
+- **セキュリティ態勢**: [認証/認可方法、既知の脆弱性]
+- **技術的負債**: [セッション横断で蓄積された技術的負債]
+```
+
+---
+
+## 3. 3シナリオ検出
+
+起動時（進捗ファイルチェック後、モード選択前）に`.product-context.md`の状態を検出：
+
+| 条件 | シナリオ | アクション |
+|-----------|----------|--------|
+| ファイルが存在し、`Core Strategy`セクションに実際の内容がある（空/プレースホルダーではない） | **シナリオ1：完全なコンテキスト** | サイレントに読み込み。表示：「📦 **[プロダクト名]**のプロダクトコンテキストを検出しました — 今回の企画セッションのベースラインとして使用します。」 |
+| ファイルが存在しない | **シナリオ2：コンテキストなし** | この状態を記録。機能拡張またはリビジョンモード開始時にContext Bootstrapをトリガー（セクション4参照） |
+| ファイルが存在し、`Core Strategy`は空またはプレースホルダーのみだが、`Decision History`に少なくとも1エントリある | **シナリオ3：部分的コンテキスト** | 既知情報のサマリーを表示し、補完オプションを提示（セクション5参照） |
+
+**検出ロジック**：
+1. ファイルは存在するか？
+2. `Identity`セクションにProduct nameがあるか（プレースホルダーではなく）？
+3. `Core Strategy`セクションにCore JTBDがあるか（プレースホルダーではなく）？→ はい = シナリオ1
+4. `Decision History`セクションに`###`エントリがあるか？→ はいだが3がいいえ = シナリオ3
+
+---
+
+## 4. Context Bootstrap（シナリオ2のみ）
+
+ユーザーが**機能拡張**または**リビジョンモード**に入るが`.product-context.md`がない場合、モードのS1の前に「ステップ0」を挿入。
+
+**プレゼンテーション**：
+```
+📦 このプロジェクトでプロダクト企画ツールを使用するのは今回が初めてです。その後のフローをより効率的にするため、
+まず基本的なプロダクト情報を収集します（約2-3分）。自動的に保存され、今後のセッションで利用できます。
+```
+
+### 段階的収集（すべての質問を一度にしない）
+
+**ラウンド1（すべてのモードで必須）**：
+- プロダクト名は？
+- 一文で何をするか説明してください。
+- プロダクトタイプは？（B2C / B2B / B2B2C / 社内ツール）
+
+**ラウンド2（機能拡張で必須、リビジョンではオプション）**：
+- 使用している技術スタックは？（言語、フレームワーク、データベース、インフラ）
+- キーモジュールまたはサービスは？
+
+**ラウンド3（リビジョンで必須、機能拡張ではオプション）**：
+- DAU/MAUまたはリテンション率のデータはありますか？
+- 最も一般的なユーザーフィードバックや不満は？
+- 既知のセキュリティ問題や技術的負債はありますか？
+
+### 技術スタック自動検出
+
+ユーザーの口頭入力に加え、Bootstrapは**プロジェクトファイルを読み取って**検出を支援できます（読み取りのみ — ハードゲートには違反しない）：
+
+| ファイル | 検出内容 |
+|------|------------------|
+| `package.json` | Node.jsエコシステム、フレームワーク、依存関係 |
+| `Cargo.toml` | Rust |
+| `go.mod` | Go |
+| `requirements.txt` / `pyproject.toml` | Python |
+| `Dockerfile` / `docker-compose.yml` | コンテナ化アーキテクチャ |
+| プロジェクトルートディレクトリ構造（`src/`、`app/`、`lib/`など） | モジュール推論 |
+
+検出後、**確認スタイル**で提示：
+```
+プロジェクトが使用しているものを検出しました：
+- 技術スタック：Next.js 14 + TypeScript + PostgreSQL + Redis
+- キーモジュール：auth/、billing/、dashboard/、api/
+これで正しいですか？追加や修正はありますか？
+```
+
+ユーザーが確認した後にのみ`.product-context.md`に書き込み。
+
+### Bootstrap完了後
+
+収集した情報を`.product-context.md`に書き込み、未収集セクションは空のまま（プレースホルダーを使用）にし、モードの正式なS1に進む。
+
+---
+
+## 5. 部分的コンテキストの処理（シナリオ3）
+
+`.product-context.md`が存在するがCore Strategyが空で、Decision Historyエントリのみがある場合：
+
+**プレゼンテーション**：
+```
+📦 過去[N]回の企画セッションの記録があります：
+- 技術スタック：[Decision Historyからマージした既知のスタック]
+- 過去に修正したモジュール：[Decision Historyからマージした影響モジュール]
+- コアプロダクト戦略はまだ記録されていません。
+
+どうしますか？
+  1️⃣ 直接開始（既知情報を使用、戦略セクションをスキップ）
+  2️⃣ まず戦略情報を記入（JTBD、ポジショニング、North Star Metric）
+  3️⃣ この情報は正しくない — 修正させてください
+```
+
+**自動再構築の試み**：すべてのDecision Historyエントリをスキャンし、`影響モジュール`、`スコープ`、`主要決定`から繰り返し登場するプロダクト名、技術スタック、モジュール名を抽出し、`Architecture & Tech Stack`に自動記入。`<!-- inferred from decision history -->`でマークし、推論元を示す。
+
+---
+
+## 6. コンテキスト自動読み込みルール
+
+各モードのS1プレステップでコンテキストを読み込む際、**関連セクションのみを注入** — ファイル全体の内容をユーザーに表示しない：
+
+| モード + ステップ | 注入コンテキストセクション |
+|-------------|--------------------------|
+| 機能拡張 S1 | Identity、Architecture & Tech Stack、最新3件のDecision Historyエントリ |
+| リビジョン S1 | Identity、Core Strategy、Accumulated Insights（ペインポイント、PMF、セキュリティ）、最新3件のDecision Historyエントリ |
+| Full/Quick/Build S1 | Identityのみ（プロダクト名、タイプ、ワンライナー） |
+| 任意モードのPre-mortem | Security posture + Technical debt（Accumulated Insightsから） |
+
+**肥大化制御**：Decision Historyはデフォルトで最新3件のエントリのみ注入。ユーザーは追加をリクエスト可能。
+
+---
+
+## 7. 空セクションスキップルール
+
+コンテキストファイルが存在するが一部セクションが空の場合、**モード**に基づいてスキップまたは収集を判断：
+
+| セクション | 機能拡張 | リビジョンモード | Full/Quick/Build |
+|---------|------------------|---------------|-----------------|
+| Identity | 必須（欠落時はBootstrap） | 必須（欠落時はBootstrap） | フロー自体がこれを生成 — 事前読み込み不要 |
+| Core Strategy | **スキップ可能** | 必須（欠落時はS1内でクイックQ&A収集） | フロー自体がこれを生成 |
+| Architecture & Tech Stack | 必須（欠落時はBootstrapまたは自動検出） | スキップ可能 | フロー自体がこれを生成 |
+| Decision History | スキップ可能 | あれば含める、なければスキップ | フロー自体がこれを生成 |
+| Accumulated Insights | スキップ可能 | あれば含める、なければスキップ | フロー自体がこれを生成 |
+
+| 機能拡張 | Identity（確認のみ）、Architecture & Tech Stack（必須）、Core Strategy（スキップ可能） |
+
+**原則**：空セクションは**フローをブロックしない**。現在のモードで「必須」のセクションが空の場合のみ、収集をトリガー。
+
+---
+
+## 8. コンテキスト自動書き込みルール（フロー終了時の抽出）
+
+フロー終了時（`rules-end-of-flow.md`の終了条件チェックと同期して）、自動的にコンテキストを抽出：
+
+| フロータイプ | 書き込み/更新セクション |
+|-----------|-------------------------|
+| Quick | Identity、Core Strategy（JTBD + North Star）、Decision Historyに追加 |
+| Full | **すべてのセクション**（Identity/Strategy/Insightsを上書き、Historyに追加） |
+| Revision | Core Strategyを更新（リポジショニングした場合）、Insightsを更新、Historyに追加 |
+| Feature Extension | Architectureをマージ、Decision Historyに追加（機能固有テンプレート） |
+| Custom | 完了したステップに対応するセクションを更新 |
+| Build（7ステップ） | Identity、Core Strategy（部分的）、Historyに追加 |
+
+### 書き込み戦略
+
+| セクション | 戦略 | 備考 |
+|---------|----------|-------|
+| Identity | **最新で上書き** | 常に最新のフローのデータで上書き |
+| Core Strategy | **最新で上書き** | 同上。リビジョン後の戦略がリビジョン前の戦略を置き換え |
+| Architecture & Tech Stack | **マージ** | 新モジュールは追加、古いものは削除しない。新技術項目は追加 |
+| Decision History | **追加のみ** | 過去のエントリを決して削除しない。フロー完了ごとに1エントリ追加 |
+| Accumulated Insights | **マージ＆重複排除** | ペインポイントとフィードバックテーマは重複排除して追加。PMFとSecurityは最新値で上書き |
+
+### Decision History追加テンプレート
+
+**一般テンプレート**：
+```markdown
+### [ISO日付] - [フロータイプ]
+- **スコープ**: [...]
+- **主要決定**: [...]
+- **特定されたリスク**: [...]
+- **MVP境界**: [...]
+- **成功メトリクス**: [...]
+```
+
+**機能拡張テンプレート**：
+```markdown
+### [ISO日付] - Feature Extension: [機能名]
+- **問題**: [一文の問題ステートメント]
+- **選択したソリューション**: [選択したソリューション + 根拠]
+- **影響モジュール**: [影響モジュール]
+- **スコープ**: [やること / 触らないこと]
+- **受入基準**: [受入基準]
+```
+
+### 完了通知
+
+```
+✅ プロダクトコンテキストが`.product-context.md`に更新されました — 次回の企画セッションで自動的に読み込まれます。
+```
+
+---
+
+## 9. コンフリクト解決
+
+### ユーザーが既存コンテキストを修正
+
+完全に許可。ユーザーが提供した修正は対応セクションを直接上書き（最新優先）。
+
+### ユーザー提供データとコードベースのコンフリクト
+
+S1プレステップで`.product-context.md`とプロジェクトファイル（例：`package.json`）の両方を読み取り、不一致が見つかった場合：
+
+```
+⚠️ 不一致が検出されました：
+- コンテキストの記録：[コンテキストからの値]
+- プロジェクトコードベース：[コードから検出された値]
+どちらが正しいですか？
+  1️⃣ コードベースを正とする（コンテキストを更新）
+  2️⃣ コンテキストを正とする（移行中の可能性）
+  3️⃣ 両方とも不完全 — 説明させてください
+```
+
+**処理原則**：
+- **自動上書きしない** — ユーザーに判断を委ねる
+- ユーザーの選択後に`.product-context.md`を更新
+- 「移行中」が選択された場合、Architectureセクションに注記：`[移行中] React → Vue 3`
+- コンフリクトをDecision Historyに記録
+
+### フローからの新データがコンテキストを上書き
+
+フロー中に生成されたデータがコンテキストの古いデータと異なる場合（例：リビジョンモードでJTBDを再定義）、**フローデータが優先**。フロー終了時に自動的に上書きされます。
+
+---
+
+## 10. 言語設定
+
+`.product-context.md`が作成または更新される際、`Language Preference`セクションに言語設定を記録します：
+
+- **インストール言語**：スキルインストールディレクトリの`.lang`ファイルから検出、またはユーザーのロケールから取得。
+- **ユーザーの希望言語**：セッション中にユーザーがコミュニケーションに使用する言語。
+
+**読み込みルール**：既存の`.product-context.md`を読み込む際、言語設定が記録されている場合、その言語でセッションを継続します。
+
+**書き込みタイミング**：言語設定はContext Bootstrap（セクション4）時、またはコンテキストファイルを初めて作成するフロー終了時に書き込まれます。ユーザーがセッション中に明示的に言語を切り替えた場合に更新されます。

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

@@ -0,0 +1,63 @@
+# ✏️ カスタムモード ステップ順序
+
+> このファイルはカスタムモードの正式なステップ定義です。SKILL.mdコアディスパッチャーにより読み込まれます。
+
+ユーザーが選択した完成度レベルに基づく：
+
+## 🔴 低（リーン）— 4ステップ
+
+```
+S1. JTBD statement → references/02b-jtbd.md を読み込み
+S2. 1つのHMW → references/03-define.md → 2.3 を読み込み
+S3. PR-FAQ → references/04a-prfaq.md を読み込み
+S4. North Star → references/05a-northstar-aha.md を読み込み
+（各ステップはユーザーの希望で別のフレームワークに入れ替え可能）
+────
+最終出力 → プロダクトスペックサマリー（未実行フィールドは「未実行」と記載）
+```
+
+## 🟡 中（スタンダード）— 10ステップ
+
+```
+S1.  ペルソナ表 + ペルソナカード → references/02a-persona.md を読み込み
+S2.  JTBD分析 → references/02b-jtbd.md を読み込み
+S3.  ペインポイントサマリー表 → references/03-define.md を読み込み
+S4.  HMW質問リフレーミング → references/03-define.md を読み込み
+S5.  April Dunfordポジショニング → references/03-define.md を読み込み
+S6.  PR-FAQ → references/04a-prfaq.md を読み込み
+S7.  並行ソリューション + MVP + Not Doing List → references/04b-solutions.md + references/04c-mvp.md を読み込み
+S8.  North Star + 3層シグナル + Aha Moment → references/05a-northstar-aha.md を読み込み
+S9.  PMFレベル評価 → references/05b-pmf-gtm.md を読み込み
+S10. プロダクトスペックサマリー → references/05c-validation-spec.md を読み込み
+```
+
+## 🟢 高（包括的）— 16ステップ
+
+```
+S1.  Strategy Blocks + Rumelt → references/01-strategy.md を読み込み
+S2.  ペルソナ表 + ペルソナカード → references/02a-persona.md を読み込み
+S3.  JTBD分析 → references/02b-jtbd.md を読み込み
+S4.  OST Opportunity Solution Tree → references/02c-ost-journey.md を読み込み
+S5.  ユーザージャーニーマップ → references/02c-ost-journey.md を読み込み
+S6.  ペインポイントサマリー表 → references/03-define.md を読み込み
+S7.  HMW + April Dunfordポジショニング → references/03-define.md を読み込み
+S8.  機会評価表 → references/03-define.md を読み込み
+S9.  PR-FAQ → references/04a-prfaq.md を読み込み
+S10. 並行プロトタイプ → references/04b-solutions.md を読み込み
+S11. Pre-mortem → references/04b-solutions.md を読み込み
+S12. GEM + RICE → references/04b-solutions.md を読み込み
+S13. MVP + Not Doing List → references/04c-mvp.md を読み込み
+S14. North Star + 3層シグナル + Aha Moment → references/05a-northstar-aha.md を読み込み
+S15. 仮説検証プラン → references/05c-validation-spec.md を読み込み
+S16. プロダクトスペックサマリー → references/05c-validation-spec.md を読み込み
+```
+
+## リファレンス読み込みルール
+
+各ステップに入る時にのみ対応するリファレンスファイルを読み込みます（すべてのファイルを事前読み込みしない）。上記の各ステップにリファレンスパスが注記されています。
+
+## 最終出力フォーマット
+
+**プロダクトスペックサマリー**（完了したステップのみ統合；未実行フィールドは「未実行」と記載）
+
+完了後、`references/rules-end-of-flow.md`に従ってエンドオブフロールールを実行してください。

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

@@ -0,0 +1,126 @@
+# ドキュメント変換ツール依存管理
+
+> `/export` または `/parse` コマンドが初めてトリガーされた時に読み込みます。
+
+## 依存レイヤー
+
+| レイヤー | ツール | 用途 | インストール方法 | サイズ |
+|------|------|------|---------|------|
+| **コア（インストール不要）** | Claude Read tool (Vision) | PDF セマンティック解析 | 内蔵 | 0 |
+| **コア（インストール不要）** | Playwright MCP | PDF レンダリング | 内蔵 | 0 |
+| **基本** | pymupdf (fitz) | PDF テキスト抽出 + 画像レンダリング | `pip3 install --break-system-packages pymupdf` | ~23MB |
+| **基本** | pikepdf | PDF ブックマーク注入 + メタデータ | `pip3 install --break-system-packages pikepdf` | ~5MB |
+| **拡張** | pandoc | DOCX / PPTX 変換 | `brew install pandoc` | ~50MB |
+| **Fallback** | tesseract + chi_tra | オフライン OCR（Vision が利用不可の場合） | `brew install tesseract tesseract-lang` | ~150MB |
+| **高度** | python-docx | 高品質 DOCX 出力 | `pip3 install --break-system-packages python-docx` | ~5MB |
+
+## 起動検出フロー
+
+ユーザーが初めてドキュメント変換機能をトリガーした際、以下の順序で検出し、必要に応じてインストールします：
+
+### ステップ 1：必要なツールを判断
+
+| ユーザー操作 | 必要なツール |
+|-----------|-----------|
+| `/export pdf` | pymupdf + pikepdf + Playwright MCP |
+| `/export docx` または `/export pptx` | pandoc |
+| `/parse [PDF ファイル]` | pymupdf（+ Claude Vision または tesseract） |
+| `/parse [DOCX/PPTX ファイル]` | pandoc |
+
+### ステップ 2：インストール済みツールを検出
+
+以下の Bash コマンドを実行（サイレント検出、出力非表示）：
+
+```bash
+# pymupdf
+python3 -c "import fitz; print(fitz.version)" 2>/dev/null && echo "pymupdf: OK" || echo "pymupdf: MISSING"
+
+# pikepdf
+python3 -c "import pikepdf; print(pikepdf.__version__)" 2>/dev/null && echo "pikepdf: OK" || echo "pikepdf: MISSING"
+
+# pandoc
+which pandoc >/dev/null 2>&1 && echo "pandoc: OK" || echo "pandoc: MISSING"
+
+# tesseract（明示的に必要な場合のみ検出）
+which tesseract >/dev/null 2>&1 && tesseract --list-langs 2>&1 | grep -q chi_tra && echo "tesseract: OK" || echo "tesseract: MISSING"
+```
+
+### ステップ 3：不足ツールを自動インストール
+
+不足ツールが検出された場合、以下のメッセージを表示し自動インストール：
+
+```
+📦 ドキュメント変換に以下のツールのインストールが必要です：
+  ☐ [ツール名]（[用途]、[サイズ]）
+  ...
+インストール中、お待ちください...
+```
+
+インストールコマンドを順次実行：
+
+```bash
+# pymupdf + pikepdf（一括インストール）
+pip3 install --break-system-packages pymupdf pikepdf
+
+# pandoc
+brew install pandoc
+
+# tesseract（オフライン OCR が必要な場合のみ）
+brew install tesseract tesseract-lang
+```
+
+インストール完了後に表示：
+```
+✅ ツールのインストールが完了しました。処理を続行します...
+```
+
+### ステップ 4：Playwright MCP の検出
+
+Playwright MCP は PDF レンダリングのコア依存です。検出方法：
+
+1. `mcp__plugin_playwright_playwright__browser_run_code` の呼び出しを試行
+2. MCP が利用可能 → 通常使用
+3. MCP が利用不可（未接続）→ 以下を表示：
+
+```
+⚠️ Playwright MCP が接続されていません。PDF レンダリングには Playwright ブラウザが必要です。
+以下のいずれかを実行してください：
+  1. Playwright MCP を起動（推奨）
+  2. または ! npx playwright install chromium を実行してローカル Chromium をインストール
+```
+
+**Playwright Fallback**（MCP が利用不可の場合）：
+
+ユーザーがローカル Chromium をインストールした場合、Bash で Node.js スクリプトを実行して PDF レンダリング：
+```bash
+node -e "
+const { chromium } = require('playwright');
+(async () => {
+  const browser = await chromium.launch();
+  const page = await browser.newPage();
+  await page.setContent(require('fs').readFileSync('/tmp/export.html', 'utf8'));
+  await page.pdf({ path: '${OUTPUT_PATH}', format: 'A4', printBackground: true,
+    margin: { top: '1.8cm', bottom: '1.8cm', left: '2cm', right: '2cm' } });
+  await browser.close();
+})();
+"
+```
+
+## ツール状態キャッシュ
+
+初回検出結果をメモリに記録（毎回の重複検出を回避）：
+- 同一会話セッション内で、インストール確認済みのツールは再検出しない
+- インストール失敗の場合、エラーメッセージを記録し、次回トリガー時にリトライ
+
+## プラットフォーム互換性
+
+| プラットフォーム | pymupdf | pikepdf | pandoc | tesseract | Playwright |
+|------|---------|---------|--------|-----------|------------|
+| macOS (Homebrew) | ✅ pip3 | ✅ pip3 | ✅ brew | ✅ brew | ✅ MCP/npx |
+| Linux (apt) | ✅ pip3 | ✅ pip3 | ✅ apt | ✅ apt | ✅ MCP/npx |
+| Windows (WSL) | ✅ pip3 | ✅ pip3 | ✅ choco | ✅ choco | ✅ MCP/npx |
+
+ユーザーの OS に応じて対応するパッケージマネージャーを自動選択。検出方法：
+```bash
+[[ "$(uname)" == "Darwin" ]] && echo "macOS" || echo "Linux"
+```