yodogawa 2.1.3 → 2.2.0

package/templates/project/04-design/08-infrastructure.md

@@ -1,180 +1,180 @@
-# インフラ設計
-
-<!--
-何を書くか: インフラ構成図、環境構成、主要な運用方針
-
-目的:
-  - インフラ構成の全体像を可視化
-  - 環境ごとの違いを明確化
-  - 基本的な運用方針の記録
-
-重要性:
-  - 高レベルなインフラ構成の全体像を把握
-  - 詳細な実装（スペック、ネットワーク設定、監視設定）は Infrastructure as Code で管理
-
-記載のポイント:
-  - インフラ構成図で視覚的に表現（Multi-AZ構成など）
-  - 環境ごとの違い（開発、ステージング、本番）
-  - バックアップ・監視の基本方針
-
-更新頻度:
-  - プロジェクト初期にインフラ設計を作成
-  - インフラ構成変更時に更新
--->
-
----
-
-## インフラ構成図
-
-<!--
-Mermaid を使用してインフラ全体の構成を可視化
-
-記載のベストプラクティス:
-  1. 物理的な構成を表現（サーバー、ネットワーク、ストレージ）
-  2. 冗長化構成を明記（Multi-AZ、フェイルオーバー）
-  3. ネットワークセグメントを分離（パブリック、プライベート、DMZ）
-  4. セキュリティグループ、ファイアウォールルールを図示
-  5. 外部サービスとの接続も記載
-
-よくあるコンポーネント:
-  - インターネット: 外部ネットワーク
-  - CDN: CloudFront, Cloudflare, Fastly
-  - DNS: Route 53, Cloudflare DNS
-  - Load Balancer: ALB, NLB, ELB
-  - アプリケーションサーバー: EC2, ECS, Lambda
-  - データベース: RDS, Aurora, DynamoDB
-  - キャッシュ: ElastiCache (Redis, Memcached)
-  - ストレージ: S3, EBS, EFS
-  - VPN: VPC Peering, VPN Gateway
-  - 監視: CloudWatch, Datadog, New Relic
-
-Mermaid の記法:
-  - subgraph でネットワークセグメントをグループ化
-  - VPC, Subnet, Availability Zone を表現
--->
-
-```mermaid
-graph TB
-    Internet[インターネット]
-
-    subgraph "AWS Cloud"
-        Route53[Route 53<br/>DNS]
-        CDN[CloudFront<br/>CDN]
-
-        subgraph "VPC"
-            subgraph "Availability Zone A"
-                subgraph "Public Subnet A"
-                    NAT_A[NAT Gateway A]
-                end
-                subgraph "Private Subnet A"
-                    APP1[App Server 1<br/>EC2]
-                    Cache_A[Redis<br/>ElastiCache]
-                end
-                subgraph "Data Subnet A"
-                    DB_Primary[PostgreSQL<br/>RDS Primary]
-                end
-            end
-
-            subgraph "Availability Zone B"
-                subgraph "Public Subnet B"
-                    NAT_B[NAT Gateway B]
-                end
-                subgraph "Private Subnet B"
-                    APP2[App Server 2<br/>EC2]
-                    Cache_B[Redis<br/>ElastiCache]
-                end
-                subgraph "Data Subnet B"
-                    DB_Replica[PostgreSQL<br/>RDS Replica]
-                end
-            end
-
-            ALB[Application<br/>Load Balancer]
-        end
-
-        S3[S3<br/>Object Storage]
-        CloudWatch[CloudWatch<br/>Monitoring & Logs]
-    end
-
-    Internet --> Route53
-    Route53 --> CDN
-    CDN --> ALB
-    ALB --> APP1
-    ALB --> APP2
-
-    APP1 --> DB_Primary
-    APP2 --> DB_Primary
-    APP1 --> DB_Replica
-    APP2 --> DB_Replica
-
-    APP1 --> Cache_A
-    APP2 --> Cache_B
-
-    APP1 --> S3
-    APP2 --> S3
-
-    APP1 --> NAT_A
-    APP2 --> NAT_B
-    NAT_A --> Internet
-    NAT_B --> Internet
-
-    APP1 -.logs.-> CloudWatch
-    APP2 -.logs.-> CloudWatch
-    DB_Primary -.metrics.-> CloudWatch
-    DB_Replica -.metrics.-> CloudWatch
-```
-
-**補足**:
-<!-- 例:
-- Multi-AZ 構成で可用性を確保（AZ-A と AZ-B で冗長化）
-- Public Subnet: インターネットゲートウェイへの経路あり（NAT Gateway）
-- Private Subnet: アプリケーションサーバー（外部から直接アクセス不可）
-- Data Subnet: データベース（Private Subnet からのみアクセス可能）
-- RDS は Primary と Read Replica で読み取り負荷を分散
-- Redis は各 AZ に配置しレプリケーション構成
-- CloudWatch で全リソースの監視とログ集約
--->
-
----
-
-## 環境構成
-
-<!--
-開発、ステージング、本番環境の違いを明記
-
-環境ごとの特徴:
-  - 開発環境: ローカル開発、最小構成
-  - ステージング環境: 本番に近い構成、テスト用
-  - 本番環境: 高可用性、冗長化構成
-
-詳細なスペック（インスタンスタイプ、ストレージ容量など）は
-Infrastructure as Code（Terraform/CloudFormation）で管理します。
--->
-
-| 環境 | ホスティング | データベース | 特徴 |
-|------|-------------|-------------|------|
-| **開発** | <!-- ローカル（Docker） --> | <!-- PostgreSQL (Docker) --> | <!-- 最小構成、コスト最小化 --> |
-| **ステージング** | <!-- AWS EC2 --> | <!-- RDS PostgreSQL<br/>Single-AZ --> | <!-- 本番に近い構成だが小規模 --> |
-| **本番** | <!-- AWS EC2<br/>Auto Scaling --> | <!-- RDS PostgreSQL<br/>Multi-AZ + Read Replica --> | <!-- Multi-AZ 冗長化、高可用性 --> |
-
----
-
-## 主要な運用方針
-
-<!--
-バックアップ、監視、セキュリティの基本方針を簡潔に記載
-
-詳細な設定（監視閾値、ログ設定、ネットワーク設定など）は
-Infrastructure as Code とランブックで管理します。
-
-記載すべき内容:
-  - バックアップ方針
-  - 監視方針
-  - セキュリティ基本方針
--->
-
-| 項目 | 内容 |
-|------|------|
-| **バックアップ** | <!-- 例: RDS 日次自動バックアップ（30日保持）、S3 バージョニング有効化 --> |
-| **監視** | <!-- 例: CloudWatch でインフラ監視、Sentry でエラートラッキング --> |
-| **セキュリティ** | <!-- 例: Private Subnet にアプリケーション配置、RDS/S3 暗号化、IAM 最小権限 --> |
-| **災害復旧** | <!-- 例: RPO: 1時間、RTO: 4時間、Multi-AZ 構成で高可用性確保 --> |
+# インフラ設計
+
+<!--
+何を書くか: インフラ構成図、環境構成、主要な運用方針
+
+目的:
+  - インフラ構成の全体像を可視化
+  - 環境ごとの違いを明確化
+  - 基本的な運用方針の記録
+
+重要性:
+  - 高レベルなインフラ構成の全体像を把握
+  - 詳細な実装（スペック、ネットワーク設定、監視設定）は Infrastructure as Code で管理
+
+記載のポイント:
+  - インフラ構成図で視覚的に表現（Multi-AZ構成など）
+  - 環境ごとの違い（開発、ステージング、本番）
+  - バックアップ・監視の基本方針
+
+更新頻度:
+  - プロジェクト初期にインフラ設計を作成
+  - インフラ構成変更時に更新
+-->
+
+---
+
+## インフラ構成図
+
+<!--
+Mermaid を使用してインフラ全体の構成を可視化
+
+記載のベストプラクティス:
+  1. 物理的な構成を表現（サーバー、ネットワーク、ストレージ）
+  2. 冗長化構成を明記（Multi-AZ、フェイルオーバー）
+  3. ネットワークセグメントを分離（パブリック、プライベート、DMZ）
+  4. セキュリティグループ、ファイアウォールルールを図示
+  5. 外部サービスとの接続も記載
+
+よくあるコンポーネント:
+  - インターネット: 外部ネットワーク
+  - CDN: CloudFront, Cloudflare, Fastly
+  - DNS: Route 53, Cloudflare DNS
+  - Load Balancer: ALB, NLB, ELB
+  - アプリケーションサーバー: EC2, ECS, Lambda
+  - データベース: RDS, Aurora, DynamoDB
+  - キャッシュ: ElastiCache (Redis, Memcached)
+  - ストレージ: S3, EBS, EFS
+  - VPN: VPC Peering, VPN Gateway
+  - 監視: CloudWatch, Datadog, New Relic
+
+Mermaid の記法:
+  - subgraph でネットワークセグメントをグループ化
+  - VPC, Subnet, Availability Zone を表現
+-->
+
+```mermaid
+graph TB
+    Internet[インターネット]
+
+    subgraph "AWS Cloud"
+        Route53[Route 53<br/>DNS]
+        CDN[CloudFront<br/>CDN]
+
+        subgraph "VPC"
+            subgraph "Availability Zone A"
+                subgraph "Public Subnet A"
+                    NAT_A[NAT Gateway A]
+                end
+                subgraph "Private Subnet A"
+                    APP1[App Server 1<br/>EC2]
+                    Cache_A[Redis<br/>ElastiCache]
+                end
+                subgraph "Data Subnet A"
+                    DB_Primary[PostgreSQL<br/>RDS Primary]
+                end
+            end
+
+            subgraph "Availability Zone B"
+                subgraph "Public Subnet B"
+                    NAT_B[NAT Gateway B]
+                end
+                subgraph "Private Subnet B"
+                    APP2[App Server 2<br/>EC2]
+                    Cache_B[Redis<br/>ElastiCache]
+                end
+                subgraph "Data Subnet B"
+                    DB_Replica[PostgreSQL<br/>RDS Replica]
+                end
+            end
+
+            ALB[Application<br/>Load Balancer]
+        end
+
+        S3[S3<br/>Object Storage]
+        CloudWatch[CloudWatch<br/>Monitoring & Logs]
+    end
+
+    Internet --> Route53
+    Route53 --> CDN
+    CDN --> ALB
+    ALB --> APP1
+    ALB --> APP2
+
+    APP1 --> DB_Primary
+    APP2 --> DB_Primary
+    APP1 --> DB_Replica
+    APP2 --> DB_Replica
+
+    APP1 --> Cache_A
+    APP2 --> Cache_B
+
+    APP1 --> S3
+    APP2 --> S3
+
+    APP1 --> NAT_A
+    APP2 --> NAT_B
+    NAT_A --> Internet
+    NAT_B --> Internet
+
+    APP1 -.logs.-> CloudWatch
+    APP2 -.logs.-> CloudWatch
+    DB_Primary -.metrics.-> CloudWatch
+    DB_Replica -.metrics.-> CloudWatch
+```
+
+**補足**:
+<!-- 例:
+- Multi-AZ 構成で可用性を確保（AZ-A と AZ-B で冗長化）
+- Public Subnet: インターネットゲートウェイへの経路あり（NAT Gateway）
+- Private Subnet: アプリケーションサーバー（外部から直接アクセス不可）
+- Data Subnet: データベース（Private Subnet からのみアクセス可能）
+- RDS は Primary と Read Replica で読み取り負荷を分散
+- Redis は各 AZ に配置しレプリケーション構成
+- CloudWatch で全リソースの監視とログ集約
+-->
+
+---
+
+## 環境構成
+
+<!--
+開発、ステージング、本番環境の違いを明記
+
+環境ごとの特徴:
+  - 開発環境: ローカル開発、最小構成
+  - ステージング環境: 本番に近い構成、テスト用
+  - 本番環境: 高可用性、冗長化構成
+
+詳細なスペック（インスタンスタイプ、ストレージ容量など）は
+Infrastructure as Code（Terraform/CloudFormation）で管理します。
+-->
+
+| 環境 | ホスティング | データベース | 特徴 |
+|------|-------------|-------------|------|
+| **開発** | <!-- ローカル（Docker） --> | <!-- PostgreSQL (Docker) --> | <!-- 最小構成、コスト最小化 --> |
+| **ステージング** | <!-- AWS EC2 --> | <!-- RDS PostgreSQL<br/>Single-AZ --> | <!-- 本番に近い構成だが小規模 --> |
+| **本番** | <!-- AWS EC2<br/>Auto Scaling --> | <!-- RDS PostgreSQL<br/>Multi-AZ + Read Replica --> | <!-- Multi-AZ 冗長化、高可用性 --> |
+
+---
+
+## 主要な運用方針
+
+<!--
+バックアップ、監視、セキュリティの基本方針を簡潔に記載
+
+詳細な設定（監視閾値、ログ設定、ネットワーク設定など）は
+Infrastructure as Code とランブックで管理します。
+
+記載すべき内容:
+  - バックアップ方針
+  - 監視方針
+  - セキュリティ基本方針
+-->
+
+| 項目 | 内容 |
+|------|------|
+| **バックアップ** | <!-- 例: RDS 日次自動バックアップ（30日保持）、S3 バージョニング有効化 --> |
+| **監視** | <!-- 例: CloudWatch でインフラ監視、Sentry でエラートラッキング --> |
+| **セキュリティ** | <!-- 例: Private Subnet にアプリケーション配置、RDS/S3 暗号化、IAM 最小権限 --> |
+| **災害復旧** | <!-- 例: RPO: 1時間、RTO: 4時間、Multi-AZ 構成で高可用性確保 --> |

package/templates/project/AI_CONTEXT.md

@@ -0,0 +1,55 @@
+# AI Context
+
+<!--
+何のドキュメントか: Vibe coding / AI 実装エージェントに渡す、圧縮された実装コンテキスト。
+                    a-006（PM Gate）が上流ドキュメントを要約して生成する。
+
+原則:
+  - 簡潔・密に。AI が一読でスコープ境界を把握できることを優先する。
+  - 「作らないもの（Must NOT build）」を必ず明示し、過剰実装を防ぐ。
+  - 曖昧表現を避け、固有名・数値で書く。
+
+参照元: 01-product-brief.md / 02-mvp-scope.md / 02-behavior/01-core-scenarios.md / 03-domain/
+-->
+
+## Product / Target
+
+<!-- 何を・誰のために作るか。1〜2行。 -->
+
+-
+
+## MVP — Must build
+
+<!-- 02-mvp-scope.md の Must 機能のみ。実装対象。 -->
+
+-
+
+## MVP — Must NOT build
+
+<!-- 02-mvp-scope.md の Won't / Out of Scope。ここにあるものは実装しない。 -->
+
+-
+
+## Core user flow
+
+<!-- 02-behavior/01-core-scenarios.md の Day 1 Happy Path（1〜3本）を要約。 -->
+
+-
+
+## Key domain concepts / boundaries
+
+<!-- 03-domain/01-domain-sketch.md の中核エンティティ・境界・主要ビジネスルール・外部依存。 -->
+
+-
+
+## Hard constraints
+
+<!-- 01-product-brief.md「クリティカル制約」（守らねば成立しない制約のみ）。詳細な定量 NFR は設計フェーズ/a-014 で扱うため初期 AI コンテキストには含めない。 -->
+
+-
+
+## Implementation priority / 注意事項
+
+<!-- 着手順・落とし穴・触ってはいけない領域など。 -->
+
+-

package/templates/project/STAKEHOLDER-SUMMARY.md

@@ -0,0 +1,66 @@
+# Stakeholder Summary
+
+<!--
+何のドキュメントか: ステークホルダーが5分で読み、実装着手の Go / No-Go を判断するための統合1枚もの。
+                    a-006（PM Gate）が上流ドキュメントを要約して生成する。
+
+原則:
+  - Single source of truth を複製しない。各項は上流ドキュメントの「要約＋参照リンク」で書く。
+  - 1〜2ページに収める。詳細は参照先に委ねる。
+  - 判定（Go / Go with caveats / No-Go）を必ず明記する。
+
+参照元: 01-product-brief.md / 02-mvp-scope.md / 02-behavior/01-core-scenarios.md / 03-domain/
+-->
+
+## なぜ作るか（背景・課題）
+
+<!-- 01-product-brief.md「背景 / 解く課題」「Why now」を2〜3文で要約。 -->
+
+- 課題:
+- なぜ今:
+
+## 誰の課題か（ターゲット）
+
+<!-- 01-product-brief.md「ターゲットユーザー」「ステークホルダー」を要約。 -->
+
+- 主要ペルソナ:
+- 決裁者 / 主要関心事:
+
+## MVP に入れるもの（Must）
+
+<!-- 02-mvp-scope.md の Must 機能を箇条書き。各 Must がどの仮説・指標に効くかを1行で。 -->
+
+-
+
+## MVP に入れないもの（Not Now / Won't）
+
+<!-- 02-mvp-scope.md の Not Now / Won't と Out of Scope を、理由つきで要約。スコープ合意の核。 -->
+
+- Not Now:
+- Won't（やらない）:
+
+## 成功指標
+
+<!-- 01-product-brief.md「成功指標」を要約（North Star / KPI / Guardrail）。各指標は計測方法（どこで・どう取得）も一言添える。 -->
+
+- North Star:
+- KPI / Guardrail:
+
+## 主要リスク / 未決事項
+
+<!-- Product Brief「未確定事項」＋ レビューで検出した重大リスクを要約。 -->
+
+-
+
+## 判定（Go / Go with caveats / No-Go）
+
+<!--
+a-006（PM Gate）の判定結果を記入する。
+  - Go:               このまま実装着手してよい。
+  - Go with caveats:  条件付きで着手可（caveat を明記）。
+  - No-Go:            実装前に解消すべき重大課題あり（理由を明記）。
+-->
+
+**判定**: <!-- Go / Go with caveats / No-Go -->
+
+**根拠 / caveat**: