architecture-decision-record
アーキテクチャ上の意思決定を文書化する
チームは重要な技術的選択の理由を失いがちで、それによって同じ議論が繰り返され、実装に一貫性がなくなります。このスキルは、背景、決定、結果、代替案、レビュー指針を含む構造化されたADRを作成します。
スキルZIPをダウンロード
Claudeでアップロード
設定 → 機能 → スキル → スキルをアップロードへ移動
オンにして利用開始
Agent向けリソース
AI Agent、クローラー、またはスクリプトがページ全体ではなくクリーンなコンテキストを必要とする場合は、これらのリンクを使ってください。
テストする
「architecture-decision-record」を使用しています。 URLパスによるAPIバージョニングを採用するためのADRを作成してください。
期待される結果:
acceptedステータス、APIバージョニングの背景、明確なURLパスの決定、肯定的および否定的な結果、却下された代替案、参考資料を含む構造化されたADR。
「architecture-decision-record」を使用しています。 アーキテクチャ評議会の承認前にこのADRをレビューしてください。
期待される結果:
不足している要件、曖昧な所有者、弱い代替案、偏りのある結果、解決すべき承認項目を指摘するレビュー要約。
「architecture-decision-record」を使用しています。 注文処理にサーバーレスを採用しなかった理由を文書化してください。
期待される結果:
コールドスタートのレイテンシ、ベンダーロックイン、デバッグの複雑さ、チームの準備状況、別のアプローチが選択された理由を説明するADRの代替案セクション。
セキュリティ監査
安全The static analyzer reported command execution, network, credential, and weak-crypto indicators, but review found documentation-only Markdown. The flagged locations are template paths, code spans, example URLs, and architecture terms, with no scripts, network calls, credential access, or prompt injection found.
低リスクの問題 (3)
品質スコア
作れるもの
主要なプラットフォーム上の意思決定を記録する
チームがデータベース、APIスタイル、デプロイモデル、サービス境界を選択した理由を文書化します。
意思決定の履歴を保持する
新しいチームメンバーに、過去の意思決定、代替案、所有者、トレードオフの明確な記録を提供します。
レビューに向けて意思決定を準備する
チェックリストを使用して、ADRに背景、結果、現実的な代替案、ステークホルダー承認が含まれていることを確認します。
これらのプロンプトを試す
PostgreSQLを主要データベースとして選択するためのADRを作成してください。背景、決定、結果、代替案、参考資料を含めてください。
モジュラーモノリス、マイクロサービス、サーバーレスアーキテクチャを比較するADRを書いてください。1つの選択肢を推奨し、却下した代替案を説明してください。
このADRについて、不足している背景、不明確な決定文、弱い代替案、不完全な結果、ステークホルダー承認の不足をレビューしてください。
当社のエンジニアリング組織向けにADRプロセスを設計してください。ステータスライフサイクル、番号付け、保存場所、レビュー役割、置き換えルールを含めてください。
ベストプラクティス
- 決定は、明確な現在形の表現で、指名された所有者と想定される時期を含めて書きます。
- 少なくとも2つの現実的な代替案を含め、メリット、デメリット、却下理由をバランスよく記載します。
- acceptedのADRは安定した状態で維持し、決定が置き換えられる場合は新しいADRを作成します。
回避
- アーキテクチャ上の意思決定とその根拠を文書化する代わりに、実装手順を書くこと。
- 運用、コスト、セキュリティ、保守に関するトレードオフを隠して、利点だけを列挙すること。
- チームが真剣に検討したことのない弱い代替案を使用すること。