ソフトウェアアーキテクチャ設計 — クイックリファレンス

このスキルを使用する際は、単一サービスやコンポーネント内の実装詳細ではなく、システムレベルの設計決定に焦点を当ててください。

クイックリファレンス

タスク	パターン/ツール	主要リソース	使用タイミング
アーキテクチャスタイルの選択	レイヤード、マイクロサービス、イベント駆動、サーバーレス	modern-patterns.md	グリーンフィールドプロジェクト、大規模リファクタリング
スケール設計	ロードバランシング、キャッシング、シャーディング、読み取りレプリカ	scalability-reliability-guide.md	高トラフィックシステム、パフォーマンス目標
復旧力の確保	サーキットブレーカー、リトライ、バルクヘッド、グレースフルデグラデーション	scalability-reliability-guide.md	分散システム、外部依存関係
決定事項の文書化	アーキテクチャ決定記録 (ADR)	adr-template.md	主要技術決定、トレードオフ分析
サービス境界の定義	ドメイン駆動設計 (DDD)、バウンデッドコンテキスト	microservices-template.md	マイクロサービス分解
データ一貫性のモデリング	ACID vs BASE、イベントソーシング、CQRS、Sagaパターン	data-architecture-patterns.md	マルチサービストランザクション
可観測性の計画	SLI/SLO/SLA、分散トレーシング、メトリクス、ログ	architecture-blueprint.md	本番環境への準備
モノリスからの移行	ストラングラーフィグ、データベース分解、シャドウトラフィック	migration-modernization-guide.md	レガシーシステムの近代化
サービス間通信の設計	APIゲートウェイ、サービスメッシュ、BFFパターン	api-gateway-service-mesh.md	マイクロサービスネットワーキング

このスキルを使用するタイミング

以下に関する作業を行っている場合に呼び出してください:

• システム分解: モノリス、モジュラーモノリス、マイクロサービスの選択
• アーキテクチャパターン: イベント駆動、CQRS、レイヤード、ヘキサゴナル、サーバーレス
• データアーキテクチャ: 一貫性モデル、シャーディング、レプリケーション、CQRSパターン
• スケーラビリティ設計: ロードバランシング、キャッシング戦略、データベーススケーリング
• 復旧力パターン: サーキットブレーカー、リトライ、バルクヘッド、グレースフルデグラデーション
• APIコントラクト: サービス境界、バージョン管理、統合パターン
• アーキテクチャ決定: ADR、トレードオフ分析、技術選定
• 移行計画: モノリス分解、ストラングラーフィグ、データベース分離

このスキルを使用しないタイミング

以下のタスクには他のスキルを使用してください:

• 単一サービス実装 (ルート、コントローラー、ビジネスロジック) → software-backend
• APIエンドポイント設計 (REST規約、GraphQLスキーマ) → dev-api-design
• セキュリティ実装 (認証、暗号化、OWASP) → software-security-appsec
• フロントエンドコンポーネントアーキテクチャ → software-frontend
• データベースクエリ最適化 → data-sql-optimization

決定ツリー: アーキテクチャパターン選択

プロジェクト要件: [新規システムまたは大規模リファクタリング]
    ├─ 単一チーム、進化するドメイン?
    │   ├─ シンプルに始める → モジュラーモノリス (明確なモジュール境界)
    │   └─ 迅速なイテレーション必要 → レイヤードアーキテクチャ
    │
    ├─ 複数チーム、明確なバウンデッドコンテキスト?
    │   ├─ 独立デプロイメント必須 → マイクロサービス
    │   └─ 共有データモデル → サービスモジュール付きモジュラーモノリス
    │
    ├─ イベント駆動ワークフロー?
    │   ├─ 非同期処理 → イベント駆動アーキテクチャ (Kafka、キュー)
    │   └─ 複雑なステートマシン → Sagaパターン + イベントソーシング
    │
    ├─ 変動性/予測不可能な負荷?
    │   ├─ 使用量に応じた課金モデル → サーバーレス (AWS Lambda、Cloudflare Workers)
    │   └─ バッチ処理 → サーバーレス + キュー
    │
    └─ 高い一貫性要件?
        ├─ 強いACID保証 → モノリスまたはモジュラーモノリス
        └─ 分散データ → CQRS + イベントソーシング

決定要因:

• チーム規模の閾値: 10人未満の開発者 → モジュラーモノリスは通常マイクロサービスを上回る (運用オーバーヘッド)
• チーム構成 (Conway の法則) — アーキテクチャが組織構造に反映
• デプロイメント独立性の必要性
• 一貫性と可用性のトレードオフ (CAP定理)
• 運用成熟度 (モニタリング、オーケストレーション)

詳細なパターン説明については references/modern-patterns.md を参照してください。

出力ガイドライン

このスキルの参考資料はあなたの背景知識です — パターンを吸収し、自分の専門知識として提示してください。ユーザー向けの出力で内部参考ファイル名 (例: "data-architecture-patterns.md から") を引用しないでください。ユーザーはこれらのファイルが存在することを知りません。

すべてのアーキテクチャ推奨事項には以下を含める必要があります:

• 具体的な技術選択: 抽象的なままではなく、特定の技術を指定してください (例: "ワークフローオーケストレーション向けに Temporal.io"、"Redis アダプター付き Socket.io")。ユーザーは、パターンを理解するのではなく、構築決定を行う必要があります。
• 構築しないもの: 明示的に延期または回避すべきことを指摘してください。時期尚早なスコープは #1 のアーキテクチャミスです — ユーザーがそれを回避するのをお手伝いしてください。
• チームとプロセスのアライメント: このアーキテクチャはチーム構造にどのようにマップされますか? 何の所有権モデルを暗示していますか? CODEOWNERS、デプロイメント所有権、オンコール境界を含めてください。
• 成功指標: チームはアーキテクチャが機能していることをどのように知りますか? 測定可能な指標を含めてください (デプロイ頻度、リード時間、エラー率、MTTR)。
• 焦点を絞った長さ: すべての懸念事項を網羅的にカバーするのではなく、最も重要な 3〜5 の決定に深さを持たせてください。読むには長すぎる推奨事項は従われない推奨事項です。

ワークフロー (システムレベル)

ユーザーがアーキテクチャ推奨事項、分解、または主要なプラットフォーム決定を求める場合に、このワークフローを使用してください。

1. 明確化: 問題陳述、非目標、制約、成功指標
2. 品質属性を把握: 可用性、レイテンシー、スループット、永続性、一貫性、セキュリティ、コンプライアンス、コスト
3. 2〜3 の候補アーキテクチャを提案してトレードオフを比較
4. 境界を定義: バウンデッドコンテキスト、所有権、API/イベント、統合契約
5. データ戦略を決定: ストレージ、一貫性モデル、スキーマ進化、マイグレーション
6. 運用設計: SLO、障害モード、可観測性、デプロイメント、DR、インシデント対応手順書
7. スコープ制限を指摘: 今後構築しないもの、延期するもの、購入 vs 構築
8. 決定を文書化: 主要トレードオフと不可逆的な選択のための ADR を作成

推奨デリバラブル (リクエストに合わせて選択):

• アーキテクチャブループリント: assets/planning/architecture-blueprint.md
• 決定記録: assets/planning/adr-template.md
• パターンの詳細掘り下げ: references/modern-patterns.md、references/scalability-reliability-guide.md

2026年の考慮事項

質問が現在のトレンド、ベンダー固有の制約、または「X について最新の考え方は何か」を明確に伴う場合にのみ読み込んでください。

• references/architecture-trends-2026.md — プラットフォームエンジニアリング、データメッシュ、コンポーザブルアーキテクチャ、AI ネイティブシステム
• data/sources.json — カテゴリ別に整理された 60 個のキュレーションリソース:
  • platform_engineering_2026 — IDP トレンド、AI プラットフォーム統合、Backstage
  • optional_ai_architecture — RAG パターン、マルチエージェント設計、MCP/A2A プロトコル
  • modern_architecture_2025 — データメッシュ、コンポーザブルアーキテクチャ、継続的アーキテクチャ

ライブ Web アクセスが利用可能な場合は、data/sources.json から 2〜3 の権威ある情報源を参照し、推奨事項に発見を折り込みます。そうでない場合は、永続的なパターンで回答し、変わる可能性のある前提 (ベンダー制限、価格、マネージドサービス機能) を明示的に述べてください。

ナビゲーション

コア参考資料

質問ごとに最大 2〜3 の参考資料を読んでください — 特定の質問に最も関連するものを選んでください。すべてを読まないでください。

参考資料	内容	読むタイミング
modern-patterns.md	10 個のアーキテクチャパターンと決定ツリー	パターン選択または比較時
scalability-reliability-guide.md	CAP 定理、DB スケーリング、キャッシング、サーキットブレーカー、SRE	スケーリングまたは信頼性に関する質問
data-architecture-patterns.md	CQRS バリアント、イベントソーシング、データメッシュ、Saga、一貫性	サービス全体のデータフロー
migration-modernization-guide.md	ストラングラーフィグ、DB 分解、フィーチャーフラグ、リスク評価	モノリスのリファクタリング
api-gateway-service-mesh.md	ゲートウェイパターン、サービスメッシュ、mTLS、可観測性	サービス間通信
architecture-trends-2026.md	プラットフォームエンジニアリング、データメッシュ、AI ネイティブシステム	現在のトレンドのみ
operational-playbook.md	アーキテクチャ質問フレームワーク、分解ヒューリスティック	設計ディスカッション フレーミング

テンプレート

計画とドキュメント化 (assets/planning/):

• architecture-blueprint.md — サービスブループリント (依存関係、SLA、データフロー、復旧力、セキュリティ、可観測性)
• adr-template.md — トレードオフ分析のためのアーキテクチャ決定記録

アーキテクチャパターン (assets/patterns/):

• microservices-template.md — マイクロサービス設計 (API コントラクト、復旧力、デプロイメント、テスト)
• event-driven-template.md — イベント駆動アーキテクチャ (イベントスキーマ、Saga パターン、イベントソーシング)

運用 (assets/operations/):

• scalability-checklist.md — スケーラビリティチェックリスト (DB スケーリング、キャッシング、ロードテスト、オートスケーリング、DR)

関連スキル

• software-backend — バックエンド エンジニアリング、API 実装、データレイヤー
• software-frontend — フロントエンド アーキテクチャ、マイクロフロントエンド、状態管理
• dev-api-design — REST、GraphQL、gRPC 設計パターン
• ops-devops-platform — CI/CD、デプロイメント戦略、IaC
• qa-observability — モニタリング、トレーシング、アラート、SLO
• software-security-appsec — 脅威モデリング、認証、セキュア設計
• data-sql-optimization — データベース設計、最適化、インデックス
• docs-codebase — アーキテクチャドキュメント、C4 図、ADR