ソフトウェアアーキテクチャガイドライン

SKILL.md

---
name: ソフトウェアアーキテクチャガイドライン
description: システムの境界、品質要件、通信、スタイル、意思決定、リスク、または進化を分析する際に、文脈に応じたソフトウェアアーキテクチャの指針を適用します。
---

# ソフトウェアアーキテクチャガイドライン

このポータブルなドラフトは、ソフトウェアドメイン全体のアーキテクチャ作業を支援するためのものです。グローバルにインストールされるものではありません。本書は概念とトレードオフを提供し、このガイドはそれらを条件付きチェックとして運用化します。これらはプロジェクトの命令やユーザーの意図、ローカルガバナンス、既知のシステム証拠の代替ではありません。

## ワークフロー

1. **コンテキストと権限を確立する。** ドメイン、システム境界、ビジネス成果、デプロイおよびデータ制約、チームの能力、既知の証拠、未知の事項、意思決定権限を特定します。すでに委譲されている権限を尊重します。結果を変える可能性のある不足している事実のみを尋ね、それ以外は条件付きの推奨を行います。
2. **ドライバーをランク付けする。** ステークホルダーの成果をアーキテクチャ特性に変換します。各候補を三部構成の定義に照らしてテストし、複合的な品質を分解し、小さなセットに優先順位を付けます。
3. **境界とデータをマッピングする。** 機能的責任、依存関係、トランザクション、データ所有権、静的結合、ランタイム呼び出し、および各関連境界での特性を特定します。
4. **比例的に比較する。** 重要な選択については、少なくとも2つの実行可能なオプションを、明示された優先順位、コスト、リスク、証拠に照らして比較します。小さくて可逆的な変更に対しては正式な比較を強制しないでください。
5. **根拠をもって決定する。** 推奨または状況、適合理由、受け入れたコスト、仮定、および再検討を引き起こす証拠を述べます。委譲された権限に従い、承認ゲートを勝手に作らないでください。
6. **チェックを指定する。** リスクに比例した測定基準または適合関数を選択します。範囲、信号、制限、および対応を明示します。

## コアルール

- 推奨はコンテキストに基づくこと（[context and priority rules](references/rulebook.md#context-priorities): F01）および委譲された権限を尊重すること（[decision, risk, and evolution rules](references/rulebook.md#decisions-risk-evolution): D03）。
- 測定可能なステークホルダー成果から特性を導出しランク付けすること（[context and priority rules](references/rulebook.md#context-priorities): F05, F06, F07, F08, F18）。
- 責任は一貫性を保ち、境界は依存関係と結合について正直であること（[boundary rules](references/rulebook.md#boundaries-coupling-data): F11–F17, S03, S08; [glossary](references/glossary.md)）。
- 作業に適した通信を選び、リクエスト、コマンド、イベントを区別し、障害に備えた設計を行うこと（[communication rules](references/rulebook.md#communication-reliability): S06, S09–S13, S15, D08）。
- アーキテクチャスタイルは条件付きオプションとして扱い、そのコストを比較すること（[style rules](references/rulebook.md#style-choice): S01, S16, D06; [style guide](references/style-selection.md)）。
- 重要な決定が存在する理由とそれを変える要因を記録すること（[trade-offs](references/rulebook.md#context-priorities): F02; [decision records](references/rulebook.md#decisions-risk-evolution): F03）。
- リスク、不確実性、実装の整合性を可視化すること（[risk and evolution rules](references/rulebook.md#decisions-risk-evolution): D10, D11, D12, D13）。
- 重要な制約は人々が理解できるチェックで管理すること（[governance rules](references/rulebook.md#decisions-risk-evolution): F09, F10）。
- 実際の権限と制約の範囲内でチームの選択を尊重すること（[team and communication rules](references/rulebook.md#communication-teams): S04, D16, D17, D18）。
- プロジェクトにモデルプロバイダーが含まれる場合のみ、プロバイダー固有のガイダンスを適用すること（[D15 in rules.json](references/rules.json)）。

## 出力契約

返却内容：コンテキストと未知の事項；推奨と状況；代替案とコスト；境界、データ、通信の影響；証拠とチェック；および再検討トリガー。選択の重要度に応じて詳細度を調整します。

## 参考文献

タスクに対しては、[rules.json](references/rules.json)の関連カテゴリのみを読み込み、または[rulebook.md](references/rulebook.md)の該当セクションを読むこと。両方または全パックを読み込まないでください。9つのスタイルについては[style-selection.md](references/style-selection.md)、ソースベースの用語については[glossary.md](references/glossary.md)、引用された章の位置は[source-map.json](references/source-map.json)を参照してください。合成評価プロンプトは[evaluation-cases.json](references/evaluation-cases.json)にありますが、実行されていません。手法と制限は[method-and-validation.md](references/method-and-validation.md)に記載されています。