yodogawa 2.0.0 → 2.1.0

package/skills/a-013-define-architecture/examples/architecture-templates.md

@@ -0,0 +1,98 @@
+# アーキテクチャ図と ADR のテンプレート
+
+SKILL.md 手順3〜5 で使用するシステム全体図と ADR のサンプル。
+
+## システムアーキテクチャ図（Mermaid）
+
+### シンプルな 3 層構成
+
+```mermaid
+flowchart LR
+  Web[Web Client<br/>Next.js] -->|HTTPS| API[API Server<br/>NestJS]
+  Mobile[Mobile App] -->|HTTPS| API
+  API -->|TCP| DB[(PostgreSQL)]
+  API -->|HTTPS| Stripe[Stripe API]
+  API -->|SMTP| Mail[SendGrid]
+```
+
+### 冗長化・スケーリング構成
+
+```mermaid
+flowchart TB
+  subgraph Edge
+    CDN[CloudFront] --> LB[ALB]
+  end
+  subgraph App
+    LB --> API1[API #1]
+    LB --> API2[API #2]
+  end
+  subgraph Data
+    API1 --> Primary[(Primary DB)]
+    API2 --> Primary
+    Primary -.replicate.-> Replica[(Read Replica)]
+    API1 --> Cache[(Redis)]
+    API2 --> Cache
+  end
+```
+
+### 記述のポイント
+
+- コンポーネント間のプロトコル（HTTPS / gRPC / TCP / SMTP）を矢印ラベルに記載
+- スケールアウト対象（ALB 配下）を `subgraph` でグルーピング
+- 外部サービス（Stripe 等）は独立ノードで明示
+
+## アーキテクチャパターン選定ガイド
+
+| パターン | 適合シーン |
+|:--|:--|
+| レイヤード | 標準的 Web アプリ、チーム規模小〜中 |
+| クリーンアーキテクチャ | ドメインロジックが複雑、長期運用 |
+| マイクロサービス | 組織/スケール境界が明確、独立デプロイ必須 |
+| モジュラーモノリス | 将来分割したいが初期はモノリスで進めたい |
+| Event-Driven | 非同期処理、拡張性重視 |
+
+## ADR（Architecture Decision Record）テンプレート
+
+```markdown
+### ADR-001: データベースに PostgreSQL を採用
+
+- **ステータス**: Accepted
+- **日付**: YYYY-MM-DD
+
+#### 背景（Context）
+
+- トランザクション整合性と JSON 柔軟性の両立が必要
+- チームの RDBMS 習熟度が高い
+
+#### 決定（Decision）
+
+- PostgreSQL 16 を採用
+
+#### 代替案（Alternatives）
+
+- MySQL 8: エコシステムは強いが JSON 機能が PG より弱い
+- MongoDB: スキーマレスだが結合クエリでコード複雑化
+
+#### 影響（Consequences）
+
+- プラス: JSONB + リレーション、強い一貫性
+- マイナス: 水平スケーリングに追加設計が必要（将来 Citus 等）
+```
+
+## よく記録する ADR の例
+
+- DB 選定（RDBMS vs NoSQL）
+- 認証方式（JWT vs Session vs OAuth）
+- フロントエンドレンダリング（SPA vs SSR vs SSG）
+- 非同期処理（Queue vs Event Bus vs 直接実行）
+- フレームワーク選定
+- キャッシュ戦略
+
+## コミットメッセージ例
+
+```text
+docs: アーキテクチャ設計の定義
+
+- システム全体図（Mermaid）の作成
+- アーキテクチャパターンと ADR の記録
+```

package/skills/a-013-define-architecture/reference/structure-check.md

@@ -0,0 +1,53 @@
+# 構造チェックとレビュー観点
+
+SKILL.md 手順6〜7 で使う確認コマンドとレビュー観点。
+
+## セクション存在確認
+
+```bash
+# アーキテクチャ図の確認
+grep "\`\`\`mermaid" docs/project/design/07-architecture.md && echo "OK" || echo "MISSING: Architecture Diagram"
+# パターン定義の確認
+grep "## 採用アーキテクチャパターン" docs/project/design/07-architecture.md && echo "OK" || echo "MISSING: Pattern definition"
+# ADR セクションの確認
+grep "## ADR" docs/project/design/07-architecture.md && echo "OK" || echo "MISSING: ADR section"
+```
+
+## チェックリスト
+
+- [ ] `docs/project/design/07-architecture.md` が作成されている
+- [ ] システム全体像（クライアント / API / DB / 外部サービス）が可視化されている
+- [ ] コンポーネント間のプロトコルがラベルで明示されている
+- [ ] スケーラビリティ・冗長化構成が反映されている
+- [ ] 採用アーキテクチャパターンと理由が明記されている
+- [ ] 重要な技術選定の ADR（背景・決定・代替案・影響）が記録されている
+
+## レビュー確認質問
+
+- 「技術スタック・リポジトリ構造・データモデル・API 仕様すべてと整合していますか？」
+- 「非機能要件（性能、可用性、セキュリティ）を満たせる構成ですか？」
+- 「将来チームが ADR を読んで意思決定の背景を理解できますか？」
+- 「外部依存（SaaS、API）が明示されていますか？」
+
+## ADR 記録の基準
+
+- DB / 言語 / フレームワーク選定など後戻りコストが大きいもの
+- 代替案と比較検討した決定
+- セキュリティや性能に影響する設計選択
+- チームのコーディング規約に関わる大枠の方針
+
+## Git への追加（任意）
+
+```bash
+git add docs/project/design/07-architecture.md
+git status
+```
+
+推奨コミットメッセージ:
+
+```text
+docs: アーキテクチャ設計の定義
+
+- システム全体図（Mermaid）の作成
+- アーキテクチャパターンと ADR の記録
+```

package/skills/a-014-define-infrastructure/SKILL.md

@@ -1,130 +1,113 @@
----
-name: a-014-define-infrastructure
-description: 技術スタックとアーキテクチャ設計を基に、インフラ構成図、環境構成、運用方針を定義するワークフロー
----
-
-# DefineInfrastructure (a-014)
-
-## 目的
-
-- 技術スタックとアーキテクチャ設計を基に、インフラ構成を定義する。
-- クラウドリソース、ネットワーク、セキュリティ、監視を含む全体構成を可視化する。
-- 環境ごとの構成（開発、ステージング、本番）を明確化する。
-- 高可用性、冗長化、スケーラビリティ、セキュリティの方針を定義する。
-
-## 前提
-
-- `docs/project/design/01-tech-stack.md` が作成されていること（デプロイ環境、インフラ技術選定済み）。
-- `docs/project/design/07-architecture.md` が作成されていること（推奨）。
-- `docs/project/design/` ディレクトリが存在すること。
-
-## 手順
-
-### 1. ドキュメントと前提条件の確認
-
-- 必要なドキュメントを読み込む：
-  - `docs/project/design/01-tech-stack.md`
-  - `docs/project/design/07-architecture.md`
-
-- ドキュメントが不足している場合、対応するワークフローの実行を促す。
-
-### 2. テンプレートの準備
-
-- テンプレートをコピーして作業用ファイルを作成する：
-
-  ```bash
-  SCRIPT_DIR=$(for d in .agent .cursor .claude .codex; do [ -d "$d" ] && echo "$d" && break; done)
-  cp "$SCRIPT_DIR/templates/project/04-design/08-infrastructure.md" "docs/project/design/08-infrastructure.md"
-  ```
-
-### 3. インフラ構成の提案
-
-- 技術スタックとアーキテクチャ図から、必要なインフラリソース（VPC, ALB, EC2/ECS, RDS等）を抽出する。
-- **インフラ構成案の提示**:
-  - 「以下の構成を提案します：」
-  - 「[Cloud Provider] 上に [Pattern] (例: VPC + Public/Private Subnet) を構築」
-  - 「DBは [Managed Service] (例: RDS) を使用」
-
-### 4. 詳細定義（インタビュー）
-
-ユーザーからのフィードバックを受け、詳細を定義する。
-
-#### 4.1 ネットワークとセキュリティ
-
-- VPC構成、サブネット分割（Public/Private/Data）
-- セキュリティグループ方針、WAF、HTTPS化
-
-#### 4.2 コンピューティングとスケーリング
-
-- インスタンスタイプ/サイズ
-- Auto Scalingポリシー（CPU負荷等）
-
-#### 4.3 データベースとストレージ
-
-- Multi-AZ構成、リードレプリカの有無
-- バックアップ方針（頻度、保持期間）
-
-#### 4.4 環境構成
-
-- 開発/ステージング/本番環境の差異（リソースサイズ、冗長化）
-
-### 5. ドキュメント作成
-
-- `docs/project/design/08-infrastructure.md` に決定事項を記入する。
-- **必須項目**:
-  - インフラ構成図 (Mermaid)
-  - 環境構成表
-  - 運用方針（バックアップ、監視、セキュリティ）
-
-### 6. 完了条件と構造の確認
-
-- 以下の完了条件を満たしているか、コマンドとチェックリストで確認してください：
-  1. **構造確認**:
-
-     ```bash
-     # インフラ構成図の確認
-     grep "\`\`\`mermaid" docs/project/design/08-infrastructure.md && echo "OK" || echo "MISSING: Infra Diagram"
-     # 環境構成の確認
-     grep "## 環境構成" docs/project/design/08-infrastructure.md && echo "OK" || echo "MISSING: Environments"
-     # 運用方針の確認
-     grep "## 主要な運用方針" docs/project/design/08-infrastructure.md && echo "OK" || echo "MISSING: Operations"
-     ```
-
-  2. **チェックリスト**:
-     - [ ] `docs/project/design/08-infrastructure.md` が作成されている
-     - [ ] 本番環境の構成（冗長化など）が明確になっている
-     - [ ] バックアップや監視の方針が記録されている
-
-### 7. Git への追加（オプション）
-
-- ユーザーに確認：「作成したインフラ設計ドキュメントを Git に追加しますか？」
-- 「はい」の場合、以下を実行：
-
-  ```bash
-  git add docs/project/design/08-infrastructure.md
-  git status
-  ```
-
-- 推奨コミットメッセージ：
-
-  ```
-  docs: インフラ設計の定義
-
-  - インフラ構成図（Mermaid）の作成
-  - 環境構成と運用方針の記録
-  ```
-
-## 完了条件
-
-- `docs/project/design/08-infrastructure.md` が作成されている。
-- インフラの物理構成とネットワーク構成が可視化されている。
-- 環境ごとの差異が明確になっている。
-- 運用上の重要事項（バックアップ、セキュリティ）が定義されている。
-- ユーザーが内容を承認している。
-
-## エスカレーション
-
-- コストが高すぎる場合：
-  - 「冗長化構成によりコストが増加します。ステージング環境はSingle-AZにするなど、コスト最適化を検討しましょう。」と提案する。
-- セキュリティリスクがある場合：
-  - 「DBがパブリックサブネットに配置されています。プライベートサブネットへの移動を強く推奨します。」と警告する。
+---
+name: a-014-define-infrastructure
+description: アーキテクチャ設計を基にインフラ構成図・環境構成・運用方針を定義する。アーキテクチャ確定後、デプロイ/運用環境を設計する際に使用。
+disable-model-invocation: true
+allowed-tools: Read, Write, Edit, Bash, Grep, Glob
+---
+
+# DefineInfrastructure (a-014)
+
+## 目的
+
+- 技術スタックとアーキテクチャ設計を基に、インフラ構成を定義する。
+- クラウドリソース、ネットワーク、セキュリティ、監視を含む全体構成を可視化する。
+- 環境ごとの構成（開発、ステージング、本番）を明確化する。
+- 高可用性、冗長化、スケーラビリティ、セキュリティの方針を定義する。
+
+## 前提
+
+- `docs/project/design/01-tech-stack.md` が作成されていること（デプロイ環境、インフラ技術選定済み）。
+- `docs/project/design/07-architecture.md` が作成されていること（推奨）。
+- `docs/project/design/` ディレクトリが存在すること。
+
+## 手順
+
+### 1. ドキュメントと前提条件の確認
+
+以下を読み込む:
+
+- `docs/project/design/01-tech-stack.md`
+- `docs/project/design/07-architecture.md`
+
+不足があれば対応スキルの実行を促す。
+
+### 2. テンプレートの準備
+
+```bash
+SCRIPT_DIR=$(for d in .agent .cursor .claude .codex; do [ -d "$d" ] && echo "$d" && break; done)
+cp "$SCRIPT_DIR/templates/project/04-design/08-infrastructure.md" "docs/project/design/08-infrastructure.md"
+```
+
+### 3. インフラ構成の提案
+
+技術スタックとアーキテクチャ図から必要なリソース（VPC, ALB, ECS/EC2, RDS 等）を抽出し、構成案を提示する。
+
+- 「[Cloud Provider] 上に VPC + Public/Private Subnet 構成」
+- 「DB は Managed Service（RDS 等）」
+
+構成図のサンプルは [examples/infrastructure-templates.md](examples/infrastructure-templates.md#インフラ構成図mermaid) を参照。
+
+### 4. 詳細定義（インタビュー）
+
+#### 4.1 ネットワークとセキュリティ
+
+VPC 構成、サブネット分割（Public/Private/Data）、セキュリティグループ、WAF、HTTPS 化。詳細は [examples/infrastructure-templates.md](examples/infrastructure-templates.md#ネットワークセキュリティ) を参照。
+
+#### 4.2 コンピューティングとスケーリング
+
+インスタンス種別・サイズ、Auto Scaling ポリシー（CPU 負荷等）、デプロイ戦略。
+
+#### 4.3 データベースとストレージ
+
+Multi-AZ 構成、リードレプリカ、バックアップ（頻度、保持期間）、PITR の有無。
+
+#### 4.4 環境構成
+
+開発/ステージング/本番環境の差異（リソースサイズ、冗長化、WAF など）。表形式のテンプレートは [examples/infrastructure-templates.md](examples/infrastructure-templates.md#環境構成表) を参照。
+
+### 5. ドキュメント作成
+
+`docs/project/design/08-infrastructure.md` に以下を記入する:
+
+- インフラ構成図（Mermaid）
+- 環境構成表
+- 運用方針（バックアップ、監視、セキュリティ）
+
+運用方針の項目一覧は [examples/infrastructure-templates.md](examples/infrastructure-templates.md#運用方針の定義項目) を、非機能要件との対応表は [reference/structure-check.md](reference/structure-check.md#非機能要件との対応確認) を参照。
+
+### 6. 構造チェック
+
+```bash
+grep "\`\`\`mermaid" docs/project/design/08-infrastructure.md \
+  && grep "## 環境構成" docs/project/design/08-infrastructure.md \
+  && grep "## 主要な運用方針" docs/project/design/08-infrastructure.md \
+  && echo "OK" || echo "MISSING SECTION"
+```
+
+詳細チェックリストは [reference/structure-check.md](reference/structure-check.md#チェックリスト) を参照。
+
+### 7. Git への追加（任意）
+
+```bash
+git add docs/project/design/08-infrastructure.md
+git commit -m "docs: インフラ設計の定義"
+```
+
+## 完了条件
+
+- `docs/project/design/08-infrastructure.md` が作成されている。
+- インフラの物理構成とネットワーク構成が可視化されている。
+- 環境ごとの差異が明確になっている。
+- 運用上の重要事項（バックアップ、セキュリティ）が定義されている。
+- ユーザーが内容を承認している。
+
+## エスカレーション
+
+- **コストが高すぎる**: 「冗長化構成によりコストが増加します。ステージング環境は Single-AZ にするなど、コスト最適化を検討しましょう。」
+- **セキュリティリスク**: 「DB がパブリックサブネットに配置されています。プライベートサブネットへの移動を強く推奨します。」
+- 詳細応答例は [reference/structure-check.md](reference/structure-check.md#エスカレーション時の推奨応答) を参照。
+
+## 参考
+
+- [examples/infrastructure-templates.md](examples/infrastructure-templates.md) — インフラ構成図、環境構成表、運用方針の定義項目
+- [reference/structure-check.md](reference/structure-check.md) — 構造確認コマンド、チェックリスト、非機能要件対応、レビュー質問

package/skills/a-014-define-infrastructure/examples/infrastructure-templates.md

@@ -0,0 +1,97 @@
+# インフラ構成図と環境構成のテンプレート
+
+SKILL.md 手順3〜5 で使用するインフラ構成図・環境表・運用方針のサンプル。
+
+## インフラ構成図（Mermaid）
+
+### AWS 標準構成例
+
+```mermaid
+flowchart TB
+  Users((Users)) --> CF[CloudFront]
+  CF --> S3[S3<br/>静的アセット]
+  CF --> ALB[ALB<br/>Public Subnet]
+
+  subgraph VPC[VPC 10.0.0.0/16]
+    subgraph PublicSubnet[Public Subnet]
+      ALB
+      NAT[NAT Gateway]
+    end
+    subgraph PrivateSubnet[Private Subnet]
+      ECS[ECS Fargate<br/>API]
+    end
+    subgraph DataSubnet[Data Subnet]
+      RDS[(RDS Multi-AZ<br/>PostgreSQL)]
+      Redis[(ElastiCache<br/>Redis)]
+    end
+  end
+
+  ALB --> ECS
+  ECS --> RDS
+  ECS --> Redis
+  ECS --> NAT --> Internet[Internet<br/>外部 API]
+```
+
+### 記述のポイント
+
+- VPC / Subnet 階層を `subgraph` でグルーピング
+- Public / Private / Data の分離を明示
+- マネージドサービス（RDS, ElastiCache）はカッコ型ノード `[(...)]`
+
+## 環境構成表
+
+| 項目 | 開発 | ステージング | 本番 |
+|:--|:--|:--|:--|
+| API インスタンス | Fargate 0.25vCPU × 1 | Fargate 0.5vCPU × 1 | Fargate 1vCPU × 2 |
+| DB | RDS t4g.micro Single-AZ | RDS t4g.small Single-AZ | RDS m7g.large Multi-AZ |
+| リードレプリカ | なし | なし | 1 台 |
+| キャッシュ | なし | ElastiCache t4g.micro | ElastiCache t4g.small × 2 |
+| WAF | 無効 | 有効 | 有効 |
+| バックアップ | 1 日保持 | 3 日 | 30 日 + 週次スナップショット |
+| 監視アラート | Slack 低頻度 | Slack | Slack + PagerDuty |
+
+## 運用方針の定義項目
+
+### ネットワーク・セキュリティ
+
+- VPC 構成、サブネット CIDR、AZ 配置
+- セキュリティグループ方針（最小権限）
+- WAF ルール、Rate Limit
+- HTTPS 化（ACM / Let's Encrypt）
+- Bastion / SSM Session Manager 経由のアクセス
+
+### コンピューティングとスケーリング
+
+- インスタンス種別（Fargate / EC2 / Cloud Run）
+- Auto Scaling ポリシー（CPU 70%、ALB RequestCount）
+- デプロイ戦略（Blue/Green、Rolling）
+
+### データベースとストレージ
+
+- Multi-AZ の有無
+- リードレプリカ構成
+- バックアップ: 自動（日次、保持期間）、手動スナップショット
+- ポイントインタイムリカバリ（PITR）
+
+### 監視とログ
+
+- メトリクス: CloudWatch / Datadog
+- ログ集約: CloudWatch Logs / OpenSearch
+- アラート閾値（CPU 80%、エラーレート 1%、p95 レイテンシ）
+- オンコール体制
+
+### セキュリティ
+
+- シークレット管理（Secrets Manager / Parameter Store）
+- 暗号化（KMS による保管時暗号化、TLS 1.2+）
+- IAM 最小権限、MFA 必須
+- 監査ログ（CloudTrail）
+
+## コミットメッセージ例
+
+```text
+docs: インフラ設計の定義
+
+- インフラ構成図（Mermaid）の作成
+- 環境構成と運用方針の記録
+```

package/skills/a-014-define-infrastructure/reference/structure-check.md

@@ -0,0 +1,63 @@
+# 構造チェックとレビュー観点
+
+SKILL.md 手順6〜7 で使う確認コマンドとレビュー観点。
+
+## セクション存在確認
+
+```bash
+# インフラ構成図の確認
+grep "\`\`\`mermaid" docs/project/design/08-infrastructure.md && echo "OK" || echo "MISSING: Infra Diagram"
+# 環境構成の確認
+grep "## 環境構成" docs/project/design/08-infrastructure.md && echo "OK" || echo "MISSING: Environments"
+# 運用方針の確認
+grep "## 主要な運用方針" docs/project/design/08-infrastructure.md && echo "OK" || echo "MISSING: Operations"
+```
+
+## チェックリスト
+
+- [ ] `docs/project/design/08-infrastructure.md` が作成されている
+- [ ] 本番環境の構成（冗長化、Multi-AZ など）が明確
+- [ ] ネットワーク分離（Public / Private / Data）が図示されている
+- [ ] セキュリティグループ方針と WAF 設定が記録されている
+- [ ] バックアップ頻度・保持期間が定義されている
+- [ ] Auto Scaling ポリシーが定義されている
+- [ ] 監視・アラート閾値が定義されている
+- [ ] 環境ごとの差異（開発 / ステージング / 本番）が表形式で記録されている
+
+## 非機能要件との対応確認
+
+| 非機能要件 | インフラ設計での対応 |
+|:--|:--|
+| 可用性 99.9% | Multi-AZ、Auto Scaling、Health Check |
+| p95 < 500ms | CDN、Read Replica、Redis キャッシュ |
+| RPO 1 時間以内 | 自動バックアップ + PITR |
+| RTO 30 分以内 | Multi-AZ フェイルオーバ |
+| 監査ログ | CloudTrail、アクセスログ保持 |
+
+## レビュー確認質問
+
+- 「アーキテクチャ図のコンポーネントがすべてインフラに反映されていますか？」
+- 「コスト試算は許容範囲ですか？」
+- 「災害復旧（DR）の RPO / RTO を満たせますか？」
+- 「セキュリティベストプラクティス（最小権限、暗号化）は守られていますか？」
+
+## エスカレーション時の推奨応答
+
+- **コスト過大**: 「冗長化によりコスト増。ステージング環境は Single-AZ にするなど最適化を検討しましょう。」
+- **セキュリティリスク**: 「DB がパブリックサブネットに配置されています。プライベートサブネットへの移動を強く推奨します。」
+
+## Git への追加（任意）
+
+```bash
+git add docs/project/design/08-infrastructure.md
+git status
+```
+
+推奨コミットメッセージ:
+
+```text
+docs: インフラ設計の定義
+
+- インフラ構成図（Mermaid）の作成
+- 環境構成と運用方針の記録
+```