product-playbook 1.0.0

package/i18n/ja/references/07c-architecture-setup.md

@@ -0,0 +1,197 @@
+# 開発ハンドオフ — ARCHITECTURE.md + setup.sh
+
+## 📄 ARCHITECTURE.mdテンプレート
+
+```markdown
+# [プロダクト名] — 技術アーキテクチャ
+
+## ディレクトリ構造
+
+[技術スタックに基づいて対応するディレクトリ構造を生成]
+
+## データベース設計
+
+[PRDのDBスキーマから統合 — CREATE TABLE SQLまたはORMモデル定義に変換]
+
+### ERダイアグラム
+
+[Mermaid erDiagram]
+
+### 主要テーブル説明
+
+| テーブル | 説明 | 主要フィールド | インデックス推奨 |
+|-------|------------|------------|----------------------|
+| | | | |
+
+## API設計
+
+[User Storiesと機能仕様に基づいてRESTful APIエンドポイントまたはGraphQLスキーマを定義]
+
+### エンドポイントリスト
+
+| メソッド | パス | 説明 | 対応タスク |
+|--------|------|------------|-------------------|
+| GET | /api/v1/[resource] | [説明] | T1.1 |
+| POST | /api/v1/[resource] | [説明] | T1.2 |
+
+### 認証
+
+[JWT / Session / OAuthなど]
+
+## サードパーティサービス
+
+| サービス | 目的 | 対応機能 |
+|---------|---------|----------------------|
+| | | |
+
+## セキュリティアーキテクチャ
+
+### CORS設定
+
+| 設定 | 値 | 備考 |
+|---------|-------|-------|
+| Allowed Origins | [本番ドメイン、localhost:port] | ワイルドカード*は使用しない |
+| Allowed Methods | GET、POST、PUT、DELETE | 実際のAPIニーズに基づく |
+| Allowed Headers | Content-Type、Authorization | |
+| Credentials | true/false | 認証方法による |
+
+### セキュリティヘッダー
+
+[references/08-security-checklist.md §5からプロダクト要件に基づいて適用するヘッダーを選択]
+
+### Rate Limiting戦略
+
+| エンドポイントタイプ | 制限 | 識別方法 |
+|--------------|-------|----------------------|
+| 一般API | [X] req/min | IP + User ID |
+| ログイン/登録 | [X] req/min | IP |
+| ファイルアップロード | [X] req/min | User ID |
+
+### 機密データ取り扱い
+
+- シークレット管理：[.env + プラットフォーム環境変数 / Secrets Manager]
+- ロギングルール：パスワード、トークン、個人データを決してログに記録しない
+- データ暗号化：[転送中のTLS / 保存時の暗号化要件]
+
+> 完全なセキュリティチェックリストは`references/08-security-checklist.md`にあります
+```
+
+---
+
+## 📄 .gitignoreテンプレート
+
+```gitignore
+# 環境変数とシークレット
+.env
+.env.local
+.env.*.local
+*.pem
+*.key
+
+# プロダクト企画進捗（機密ビジネス情報を含む可能性あり）
+.product-playbook-progress.md
+
+# IDEとOS
+.idea/
+.vscode/
+*.swp
+.DS_Store
+Thumbs.db
+
+# 依存関係
+node_modules/
+__pycache__/
+*.pyc
+venv/
+
+# ビルド出力
+dist/
+build/
+.next/
+```
+
+---
+
+## 📄 setup.shテンプレート
+
+```bash
+#!/bin/bash
+# [プロダクト名] — プロジェクト初期化スクリプト
+# 使用方法：chmod +x scripts/setup.sh && ./scripts/setup.sh
+
+set -e
+
+echo "🚀 [プロダクト名]を初期化中..."
+
+# ===== 前提条件の確認 =====
+command -v [node/python/etc] >/dev/null 2>&1 || { echo "❌ [ランタイム]が必要です"; exit 1; }
+
+# ===== 依存関係のインストール =====
+echo "📦 依存関係をインストール中..."
+[npm install / pip install -r requirements.txt / etc]
+
+# ===== 環境設定 =====
+if [ ! -f .env ]; then
+  echo "📝 .envファイルを作成中..."
+  cp .env.example .env
+  echo "⚠️  .envを編集し、必要な環境変数を入力してください"
+fi
+
+# ===== データベース初期化 =====
+echo "🗄️  データベースを初期化中..."
+[migration commands]
+
+echo ""
+echo "✅ 初期化完了！"
+echo ""
+echo "次のステップ："
+echo "  1. .envを編集して環境変数を入力"
+echo "  2. 開発サーバーを起動：[起動コマンド]"
+echo "  3. 開発を開始：claude \"CLAUDE.mdとTASKS.mdを読んで、Phase 1の実行を開始してください\""
+```
+
+---
+
+## ユーザーガイダンステキスト
+
+### Claude Chat / Cowork内
+
+ハンドオフパッケージの作成後、以下のガイダンスを表示：
+
+```
+📦 開発ハンドオフパッケージの準備ができました！以下のファイルが含まれています：
+
+  CLAUDE.md        → Claude Codeのプロジェクトメモリ（プロダクトコンテキスト + 技術仕様）
+  TASKS.md         → 開発タスクリスト（4フェーズ、合計[N]タスク）
+  TICKETS.md       → チケットリスト（[N]チケット、Jira/Asana/Linearで直接作成可能）
+  docs/PRD.md      → 完全なPRD
+  docs/ARCHITECTURE.md → 技術アーキテクチャ（DBスキーマ + API + ディレクトリ構造）
+  docs/PRODUCT-SPEC.md → プロダクトスペックサマリー
+  scripts/setup.sh → ワンクリック初期化スクリプト
+
+🔗 開発の始め方：
+
+  1. ダウンロードしてプロジェクトフォルダに展開
+  2. ターミナルを開いてプロジェクトフォルダに移動
+  3. Claude Codeを起動：
+     $ claude
+  4. Claude Codeに指示：
+     > CLAUDE.mdとTASKS.mdを読んで、Phase 0の実行を開始してください
+
+💡 ヒント：
+  - Claude CodeはCLAUDE.mdを自動的に読み込むので、プロダクトコンテキスト全体を既に把握しています
+  - 各フェーズ完了後、次のフェーズに進むか確認します
+  - 機能スコープを調整したい場合は、TASKS.mdを直接編集してください
+  - CLAUDE.mdの「明示的にやらないこと」リストがClaude Codeのスコープ外の開発を防ぎます
+```
+
+### 出力前の最終確認
+
+```
+開発ハンドオフパッケージを作成する前に、いくつか確認させてください：
+
+1. 技術スタック：[確認済み / 確認が必要]
+2. プロダクト名（プロジェクトフォルダ名用）：[確認済み / 確認が必要]
+3. その他の技術的制約や好みはありますか？
+   - 例：特定のORMの使用が必須、特定ブラウザのサポートが必要、既存のCI/CDなど
+```

package/i18n/ja/references/08-security-checklist.md

@@ -0,0 +1,221 @@
+# セキュリティチェックリスト
+
+> 開発ハンドオフパッケージを作成する前に読み込みます。プロダクト企画フェーズで重要なセキュリティ要件が考慮され、セキュリティが後付けにならないことを保証します。
+
+## 🔐 セキュリティアーキテクチャ クイックチェック
+
+開発ハンドオフパッケージを作成する前に、以下の各セキュリティ側面を確認してください。各項目を✅（企画でカバー済み）または❌（追加が必要）で記入。
+
+### 1. 認証＆認可
+
+```
+| チェック項目 | ステータス | 備考 |
+|-----------|--------|-------|
+| 認証方法が決定（JWT / Session / OAuth / Passkey） | | |
+| トークンのストレージがセキュア（HttpOnly Cookie、localStorageではない） | | |
+| トークンの有効期限とリフレッシュメカニズムが設計済み | | |
+| パスワードストレージがbcrypt / argon2を使用（MD5/SHAではない） | | |
+| 権限モデルが定義済み（RBAC / ABAC / シンプルロール） | | |
+| すべてのAPIエンドポイントに対応する認可チェックあり | | |
+| ログイン失敗にブルートフォース保護あり（ロックアウト / 段階的遅延） | | |
+```
+
+**JWTベストプラクティス（JWTを使用する場合）：**
+- 短命のAccess Token（15-30分）+ 長命のRefresh Tokenを使用
+- Refresh TokenをHttpOnly Secure Cookieに保存
+- Token Revocationを実装（ログアウト時にRefresh Tokenを無効化）
+- JWTペイロードに機密情報を保存しない
+
+### 2. CORSポリシー（Cross-Origin Resource Sharing）
+
+```
+| チェック項目 | ステータス | 備考 |
+|-----------|--------|-------|
+| Allowed Originリストが定義済み（ワイルドカード*は不可） | | |
+| 必要なHTTPメソッドのみ許可 | | |
+| Access-Control-Allow-Credentialsが設定済み | | |
+| Preflightキャッシュ期間が妥当（Access-Control-Max-Age） | | |
+```
+
+**CORS設定テンプレート：**
+```
+Allowed Origins：
+  - 本番：https://[your-domain.com]
+  - 開発：http://localhost:[port]
+
+Allowed Methods：GET、POST、PUT、DELETE、PATCH
+Allowed Headers：Content-Type、Authorization
+Credentials：true（Cookie認証を使用する場合）
+Max-Age：86400（24時間）
+```
+
+### 3. 入力バリデーション＆サニタイゼーション
+
+```
+| チェック項目 | ステータス | 備考 |
+|-----------|--------|-------|
+| すべてのAPI入力にサーバーサイドバリデーションあり | | |
+| SQLインジェクション防止にパラメタライズドクエリを使用 | | |
+| ユーザー入力のHTML出力前にエンコード（XSS防止） | | |
+| ファイルアップロードにタイプ / サイズ制限あり | | |
+| URL / リダイレクト先にホワイトリストバリデーション（Open Redirect防止） | | |
+```
+
+**バリデーション原則：**
+- フロントエンドバリデーションはUX；バックエンドバリデーションはセキュリティ — 両方必要だが、バックエンドバリデーションは非交渉
+- Schema Validation Library（例：Zod、Joi、Pydantic）で統一バリデーションロジックを使用
+- 期待するフォーマットに一致しない入力はリジェクト — ユーザー入力を「修正」しようとしない
+
+### 4. CSRF保護（Cross-Site Request Forgery）
+
+```
+| チェック項目 | ステータス | 備考 |
+|-----------|--------|-------|
+| 状態変更操作がPOST/PUT/DELETEを使用（GETではない） | | |
+| CSRF Tokenを実装またはSameSite Cookieを使用 | | |
+| 重要な操作に二次確認あり | | |
+```
+
+### 5. セキュリティヘッダー
+
+```
+| ヘッダー | 目的 | 推奨値 |
+|--------|---------|-------------------|
+| Content-Security-Policy (CSP) | XSS、データインジェクション防止 | default-src 'self'; script-src 'self' |
+| X-Content-Type-Options | MIMEスニッフィング防止 | nosniff |
+| X-Frame-Options | クリックジャッキング防止 | DENY または SAMEORIGIN |
+| Strict-Transport-Security (HSTS) | HTTPS強制 | max-age=31536000; includeSubDomains |
+| X-XSS-Protection | ブラウザXSSフィルター | 0（CSPに頼る方が信頼性が高い） |
+| Referrer-Policy | リファラー情報の制御 | strict-origin-when-cross-origin |
+| Permissions-Policy | ブラウザ機能の制限 | camera=(), microphone=(), geolocation=() |
+```
+
+### 6. APIセキュリティ＆Rate Limiting
+
+```
+| チェック項目 | ステータス | 備考 |
+|-----------|--------|-------|
+| APIにグローバルRate Limitingあり（例：100 req/min/IP） | | |
+| 機密エンドポイントにより厳しい制限（ログイン 5 req/min、登録 3 req/min） | | |
+| APIエラーレスポンスが内部詳細を漏洩しない（スタックトレース、SQL文） | | |
+| APIバージョニング戦略が決定（/api/v1/） | | |
+| 大量データエンドポイントにページネーション制限あり | | |
+```
+
+**Rate Limiting設計推奨：**
+```
+| エンドポイントタイプ | 推奨制限 | 識別方法 |
+|--------------|-------------------|----------------------|
+| 一般API | 100 req/min | IP + User ID |
+| ログイン/登録 | 5 req/min | IP |
+| パスワードリセット | 3 req/hour | IP + Email |
+| ファイルアップロード | 10 req/min | User ID |
+| 検索/クエリ | 30 req/min | IP + User ID |
+```
+
+### 7. アンチスクレイピング＆ボット対策
+
+```
+| チェック項目 | ステータス | 備考 |
+|-----------|--------|-------|
+| robots.txtが設定済み（機密パスを制限） | | |
+| 重要フォームにボット保護あり（reCAPTCHA / hCaptcha / Honeypot） | | |
+| APIにUser-Agentチェックあり（オプション） | | |
+| 機密操作に行動分析あり（オプション、上級） | | |
+```
+
+**多層防御戦略：**
+1. **基本層**：Rate Limiting + robots.txt — すべてのプロダクトが持つべき
+2. **標準層**：+ CAPTCHA（登録/ログイン）+ Honeypotフィールド — B2Cプロダクトに推奨
+3. **上級層**：+ 行動分析 + IP評判 + Device Fingerprint — 高リスクプロダクト
+
+### 8. 機密データ保護
+
+```
+| チェック項目 | ステータス | 備考 |
+|-----------|--------|-------|
+| 機密データが転送中に暗号化（HTTPS/TLS） | | |
+| 機密データが保存時に暗号化（要求される場合） | | |
+| シークレットとキーがコードに保存されていない | | |
+| .envと機密ファイルが.gitignoreに追加済み | | |
+| ログにパスワード、トークン、クレジットカード番号を記録しない | | |
+| 明確なデータ保持・削除ポリシー（該当する場合はGDPR） | | |
+```
+
+**シークレット管理推奨：**
+- 開発：`.env`ファイル（バージョン管理外）+ `.env.example`（キー名のみ、値なし）
+- 本番：プラットフォーム提供の環境変数管理を使用（Vercel Environment Variables / Railway Variables / AWS Secrets Manager）
+- コミットメッセージ、PR説明、Issueでシークレットに言及しない
+
+### 9. .gitignoreセキュリティテンプレート
+
+```gitignore
+# 環境変数とシークレット
+.env
+.env.local
+.env.*.local
+*.pem
+*.key
+
+# プロダクト企画進捗（機密ビジネス情報を含む可能性あり）
+.product-playbook-progress.md
+
+# IDEとOS
+.idea/
+.vscode/
+*.swp
+.DS_Store
+Thumbs.db
+
+# 依存関係
+node_modules/
+__pycache__/
+*.pyc
+venv/
+
+# ビルド出力
+dist/
+build/
+.next/
+```
+
+---
+
+## 🏷️ OWASP Top 10クイックリファレンス
+
+| # | リスク | このプロダクトに該当？ | 対応チェック |
+|---|------|--------------------------|-------------------|
+| A01 | 不適切なアクセス制御 | [はい/いいえ] | §1 認証＆認可 |
+| A02 | 暗号化の失敗 | [はい/いいえ] | §8 機密データ保護 |
+| A03 | インジェクション（SQL / XSS / コマンド） | [はい/いいえ] | §3 入力バリデーション |
+| A04 | 安全でない設計 | [はい/いいえ] | 全体アーキテクチャ設計 |
+| A05 | セキュリティ設定ミス | [はい/いいえ] | §5 ヘッダー + §2 CORS |
+| A06 | 脆弱なコンポーネント | [はい/いいえ] | 依存関係管理（npm audit / pip audit） |
+| A07 | 認証の失敗 | [はい/いいえ] | §1 認証＆認可 |
+| A08 | データ整合性の失敗 | [はい/いいえ] | §3 入力バリデーション + §8 データ保護 |
+| A09 | ロギング＆モニタリングの失敗 | [はい/いいえ] | §8 ロギングルール |
+| A10 | SSRF（Server-Side Request Forgery） | [はい/いいえ] | §3 URLホワイトリストバリデーション |
+
+---
+
+## 📎 統合タイミング
+
+| トリガー | 統合アクション |
+|---------|-------------------|
+| 開発ハンドオフパッケージ作成前 | セキュリティクイックチェックを実行、結果をCLAUDE.md「リスクアラート」とARCHITECTURE.md「セキュリティアーキテクチャ」セクションに統合 |
+| PRD作成時 | セキュリティチェック結果をPRD §6「技術的考慮事項 → セキュリティ要件」に統合 |
+| Pre-mortemステップ | セキュリティ失敗シナリオの検討を促す |
+| リビジョンモード S1 | 既存プロダクトの現在のセキュリティ態勢の提供を促す |
+
+## 品質セルフチェック
+
+```
+| チェック項目 | ✅/❌ |
+|-----------|------|
+| 認証方法が明示的に選択され、「TBD」のままではない | |
+| 少なくとも3つのセキュリティヘッダーが計画済み | |
+| Rate Limiting戦略がプロダクト特性に合わせてカスタマイズ（テンプレートのコピーではない） | |
+| .gitignoreがすべての機密ファイルを含む | |
+| 「該当」とマークされたOWASP Top 10のすべての項目に対応措置あり | |
+| セキュリティ対策の複雑さがプロダクトステージに合致（MVPに完璧なセキュリティは不要だが、基本は非交渉） | |
+```

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

@@ -0,0 +1,152 @@
+# ⚡ ビルドモード ステップ順序（7ステップ + 最終出力）
+
+> このファイルはビルドモードの正式なステップ定義です。SKILL.mdコアディスパッチャーにより読み込まれます。
+
+> ⚠️ 必須リマインダー：「ユーザーリサーチフェーズをスキップすることは、ソリューションが仮定に基づいて構築されることを意味します。実行後できるだけ早くContinuous Discoveryを実施して検証することをお勧めします。」
+
+## ステップ順序
+
+```
+S1. 問題ステートメントの確認（一文で）
+S2. PR-FAQ → references/04a-prfaq.md を読み込み
+S3. 並行ソリューション → references/04b-solutions.md → 3.2 を読み込み
+S4. Pre-mortem → references/04b-solutions.md → 3.3 を読み込み
+S5. GEM + RICE優先順位付け → references/04b-solutions.md → 3.4 + 3.5 を読み込み
+S6. MVP + Not Doing List → references/04c-mvp.md を読み込み
+S7. North Star + Aha Moment → references/05a-northstar-aha.md を読み込み
+────
+最終出力 → エンジニア向け実行サマリー
+```
+
+## リファレンス読み込み指示
+
+| ステップ | リファレンスファイル |
+|------|---------------|
+| S1 | 外部リファレンス不要（ユーザーに問題を記述するよう直接ガイド） |
+| S2 | `references/04a-prfaq.md` |
+| S3-S5 | `references/04b-solutions.md` |
+| S6 | `references/04c-mvp.md` |
+| S7 | `references/05a-northstar-aha.md` |
+
+## 最終出力フォーマット
+
+**エンジニア向け実行サマリー**：ソリューション決定 → MVP境界 → 成功メトリクス → 主要リスク
+
+完了後、`references/rules-end-of-flow.md`に従ってエンドオブフロールールを実行してください。
+
+---
+
+## 🔧 機能拡張クイックパス（4ステップ）
+
+> ユーザーが**既存プロダクトに単一機能を追加**している場合、自動的にこのパスに切り替わります。
+> トリガー条件：ユーザーの説明に「機能を追加」「新機能」「XX機能を追加」「既存システムに」「既存プロダクトに」などの表現が含まれる場合。
+
+**フルビルドモード（7ステップ）との違い**：既存プロダクトにはすでにNorth Star、Aha Moment、プロダクトポジショニングがあるため、再定義の必要はありません。単一機能にはPR-FAQプレスリリースや完全なGEM+RICEの再優先順位付けは不要です。フォーカスは「何を追加するか、どう追加するか、既存機能が壊れないか」です。
+
+### 機能拡張ステップ順序
+
+```
+S1. 問題 + 既存システムコンテキスト
+S2. 3つの並行ソリューション + メリット/デメリット + AI推奨 → references/04b-solutions.md → 3.2 を読み込み
+S3. リスク評価（リグレッション + 互換性） → references/04b-solutions.md → 3.3 を読み込み
+S4. 実行スコープ（やること / 触らないこと / 受入基準） → references/04c-mvp.md を読み込み
+────
+最終出力 → 機能開発仕様
+```
+
+### S1 プレステップ：プロダクトコンテキスト読み込み
+
+S1に入る前に、`references/rules-context.md`を読み込み、`.product-context.md`を確認：
+
+- **完全なコンテキストあり（シナリオ1）**：プロダクト名、技術スタック、キーモジュール、最新3件のDecision Historyエントリーを自動で読み込み。S1のガイダンスを**確認スタイル**に変更：「プロダクトは[名前]で、[技術スタック]を使用し、キーモジュールには[モジュールリスト]があります。どの機能を追加しますか？影響を受けるモジュールは？」（質問2と質問3の一部が事前入力 — 確認のみ必要）
+- **コンテキストなし（シナリオ2）**：Context Bootstrap（`rules-context.md`セクション4）をトリガーし、以下の標準S1に進む
+- **部分的コンテキスト（シナリオ3）**：既知の技術スタックとモジュールを読み込み（Decision Historyからマージ）、不足部分を収集。例：「[既知のモジュール]以外に、影響を受ける可能性のあるモジュールはありますか？」
+
+### S1 ガイダンス内容（問題 + 既存システムコンテキスト）
+
+Claudeは以下の情報を収集する必要があります（段階的にガイド — すべての質問を一度にしない。コンテキストが事前入力した回答がある場合は、再収集ではなく確認）：
+
+```
+1. どの機能を追加したいですか？どんな問題を解決しますか？
+2. 現在のプロダクトアーキテクチャ概要（技術スタック、キーモジュール）← コンテキストが事前入力可能
+3. この機能はどの既存モジュールに影響しますか？← コンテキストが部分的に事前入力可能
+4. この要件を裏付けるユーザーフィードバックやデータはありますか？
+```
+
+### S2 ガイダンス内容（3つの並行ソリューション + AI推奨）
+
+```
+| HMW | ソリューションA（保守的 / 最小変更） | ソリューションB（バランス型） | ソリューションC（大胆 / リファクタ） |
+|-----|-------------------------------------------|----------------------|----------------------------|
+| [問題] | | | |
+
+| ソリューション | メリット | デメリット | 影響範囲 | 実装複雑度 |
+|----------|------|------|-------------|--------------------------|
+| A | | | | |
+| B | | | | |
+| C | | | | |
+
+🤖 AI推奨：ソリューション[X]
+理由：[影響範囲、複雑度、リスクに基づく総合判断]
+```
+
+### S3 ガイダンス内容（リスク評価 — リグレッション＆互換性にフォーカス）
+
+```
+| リスクタイプ | 具体的なリスク | 可能性 | 緩和策 |
+|-----------|--------------|------------|------------|
+| リグレッションリスク | [既存機能が影響を受ける可能性のある領域] | | |
+| 互換性リスク | [既存アーキテクチャ/データ/APIとのコンフリクト] | | |
+| パフォーマンスリスク | [新機能のシステムパフォーマンスへの影響] | | |
+| セキュリティリスク | [新機能が導入するセキュリティ上の考慮事項] | | |
+```
+
+### S4 ガイダンス内容（実行スコープ）
+
+```
+**やること（Scope）**：
+- [追加する具体的な機能項目]
+- [修正が必要な既存モジュール]
+
+**触らないこと**：
+- [明示的に変更しないモジュールと機能]
+- [触らない理由]
+
+**受入基準**：
+- [ ] [具体的なテスト可能な条件]
+- [ ] [リグレッションテスト：既存機能が影響を受けないことを確認]
+```
+
+### 機能拡張 最終出力フォーマット
+
+**機能開発仕様**：問題ステートメント → 選択したソリューション + 根拠 → 影響範囲 → 実行スコープ + 受入基準 → リスクリスト
+
+### インクリメンタルドキュメント出力（ソースドキュメントがある場合）
+
+ユーザーがプロセス中にソースドキュメント（PRD、仕様書など）をアップロードした場合：
+
+1. **インクリメンタル版**（ソースドキュメントがある場合のデフォルト）：
+   - 元のドキュメント構造にセクションを挿入/修正
+   - 元ファイルのフォーマット、スタイル、命名規則を維持
+   - 新規コンテンツに `[NEW]` マークを付与
+   - 変更コンテンツに `[UPDATED]` マークを付与し、元の内容を参考として保持
+   - 新機能に関係のないセクションは一切変更しない
+
+2. **スタンドアロン版**（ソースドキュメントがない場合）：
+   - 標準の機能開発仕様フォーマットを使用（上記で定義済み）
+
+3. **生成前にユーザーに確認**：
+   「[ドキュメントタイプ]がアップロードされたことを検出しました。出力方法はどちらをご希望ですか？
+    A) 元のドキュメントにインクリメンタル更新（推奨）
+    B) スタンドアロンの機能開発仕様」
+
+### リファレンス読み込み指示
+
+| ステップ | リファレンスファイル |
+|------|---------------|
+| S1 | 外部リファレンス不要 |
+| S2 | `references/04b-solutions.md` → 3.2 |
+| S3 | `references/04b-solutions.md` → 3.3 |
+| S4 | `references/04c-mvp.md` |
+
+完了後、`references/rules-end-of-flow.md`に従ってエンドオブフロールールを実行してください。

package/i18n/ja/references/rules-change-propagation.md

@@ -0,0 +1,74 @@
+# 🔄 変更伝播ルール
+
+> ユーザーが完了済みステップを修正した場合に読み込みます。
+
+## 📍 進捗インジケーター（各ステップで必ず表示）
+
+いずれかのステップを実行する際、Claudeはレスポンスの一番最初に進捗バーを表示する必要があります。以下のフォーマットで：
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📍 [実行モード] ｜ 進捗 S[現在のステップ番号] / S[総ステップ数]
+✅ S1: [ステップ名]（完了）
+✅ S2: [ステップ名]（完了）
+▶️ S3: [ステップ名]（進行中）
+⬜ S4: [ステップ名]（未着手）
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+この進捗インジケーターは以下の場面で表示する必要があります：
+- 新しいステップに入る時
+- ユーザーがステップに戻って修正する時
+- ステップを完了し、次のステップに進む前にユーザー確認を促す時
+
+## トリガー方法
+- 「ペルソナに戻る」「JTBDに戻る」「HMWに戻る」「PR-FAQに戻る」その他のステップ名
+- 「[ステップ名]を修正したい」「[ステップ名] — 変更したい」
+- 既に作成されたテーブルやコンテンツを直接参照して「これを変更して...」
+
+## 修正後の必須アクション
+
+いずれかのステップが修正された場合、Claudeは**以下のチェックを積極的に実行する必要があります**：
+
+```
+修正レイヤー               影響を受ける下流（再確認または更新が必要）
+─────────────────────────────────────────────────
+ペルソナ / JTBD            → HMW、機会評価表、ポジショニング、PR-FAQ、North Star、プロダクトスペックサマリー
+HMW / 機会評価             → PR-FAQ、並行ソリューション、MVP、North Star、プロダクトスペックサマリー
+ポジショニング             → PR-FAQ、プロダクトスペックサマリー
+PR-FAQ / ソリューション    → Pre-mortem、GEM/RICE、MVP、Aha Moment、プロダクトスペックサマリー
+MVP / Not Doing List       → User Story、DBスキーマ（既に生成済みの場合）、プロダクトスペックサマリー
+North Star / メトリクス    → 仮説検証プラン、プロダクトスペックサマリー
+プロダクトスペックサマリー → HTMLレポート、PRD（既に生成済みの場合）
+```
+
+### 機能拡張の依存関係：
+```
+機能拡張の依存関係：
+─────────────────────────────────────────────────────
+S1（問題 + コンテキスト）  → S2（ソリューション）、S3（リスク）、S4（実行スコープ）
+S2（選択したソリューション）→ S3（リスク）、S4（実行スコープ）
+S3（リスク評価）           → S4（実行スコープ）
+```
+
+## 実行プロセス
+
+1. **影響範囲をユーザーに通知**：「[ステップ]を修正しました。これは[下流ステップのリスト]に影響します。それぞれ更新します。」
+2. **下流項目を確認または自動更新**：
+   - 下流の変更が軽微（文言の調整）→ 直接更新し、何が変わったか説明
+   - 下流の変更が大幅（方向性の転換）→ 新しい方向性についてユーザーに確認を求めてから更新
+3. **プロダクトスペックサマリーを再統合**
+4. **HTMLレポートまたはPRDが既に生成されている場合**：直接再生成し、バージョンスナップショットを出力：
+
+```
+📋 バージョンスナップショット v[旧バージョン] → v[新バージョン]
+修正ステップ：[ステップ名]
+修正前の主要内容：[1-3文]
+修正後の主要内容：[1-3文]
+トリガーされた下流更新：[どのステップも調整されたか]
+```
+
+## 原則
+- 修正がサイレントに行われてはならない — 影響範囲は必ず明示的に伝える
+- ユーザーには「このステップのみ修正し、下流は今のところそのまま」を選ぶ権利がある。Claudeはどの部分が古くなっているかマーク（⚠️ 要更新ラベルを付加）
+- 修正履歴は会話内で追跡可能に維持