ADR（Architecture Decision Records）は構造的な選択を文書化します：MongoDBではなくPostgreSQLを選んだ理由、RabbitMQではなくKafkaを選んだ理由、認証パターンを選んだ理由。良好に記述されていれば、何年も「なぜあれを選んだんだっけ？」を救うし、オンボーディングを容易にします。AIで迅速に厳密に生成できます。本ガイドはワークフローを提示します。
ステップバイステップワークフロー
1
決定のコンテキストを説明する
何を解決するのか、制約（パフォーマンス、チーム、予算、市場投入時間）、検討されたオプション、誰が決定し誰が影響を受けるか。
2
検討したオプションをリストアップする
特性を持つ少なくとも3つの真摯なオプション。AIは構造化を支援（自明を見落とさず、非現実的なものを発明しない）。
3
関連する基準で比較する
コンテキストに応じた基準：パフォーマンス、スケーラビリティ、学習曲線、エコシステム、コスト、成熟度、ロックイン。各オプションをスコアリング。
4
決定して理由を文書化する
選択したオプション + 明確な理由。特に：正および負の結果、成功条件、この決定を再検討するべき信号。
5
repoにバージョン管理する
形式markdown in /docs/adr/。番号付けと日付付け。チームメンバーが去った後も長く相談可能。
コピー可能なプロンプト
技術選択の完全なADR
あなたはシニアソフトウェアアーキテクト。この決定のADRを形式化してください：nn**コンテキスト** : [解決する問題]n**制約** : [パフォーマンス、チーム、予算、タイミング]n**検討したオプション** : [3～5オプション のリスト]n**決定したオプション** : [選択したオプション]n**現在のスタック** : [技術コンテキスト]nnMichael Nygard形式のADRを生成：nn## Statusn[Proposed / Accepted / Deprecated / Superseded by X]nn## Contextn[3～5段落：問題、制約、検討のきっかけ]nn## Considered Optionsn### Option 1 : [名前]n- Prosn- Consn- Costsn## Decisionn[選択したオプション + 明確な理由]nn## Consequencesn### Positiven[期待される3～5の正の結果]nn### Negativen[2～4の負の結果またはトレードオフ]nn## Conditions to Revisitn[12～24ヶ月でこの決定を再検討する理由となる信号]nn不確実な数値（パフォ、コスト）すべてに[要確認]をマーク。
マルチ基準技術比較
この選択について：[技術タイプ — 例：メッセージブローカー、データベース、frontendフレームワーク]nn**コンテキスト** : [詳細]n**制約** : [リスト]nnこれらのオプションを構造的な基準で比較：nn[オプション1] vs [オプション2] vs [オプション3]nn基準：n1. **パフォーマンス**（レイテンシ、スループット、リソース）n2. **スケーラビリティ**（水平、垂直、制限）n3. **成熟度とエコシステム**（安定版、コミュニティ、ドキュメント）n4. **学習曲線**（現在のチーム、採用）n5. **ロックインと可搬性**n6. **総費用**（ライセンス、インフラ、オペレーション）n7. **セキュリティと準拠**nnフォーマット：基準ごとのスコアリング/10を含む比較表、その後の推奨（引数付き）。
既存ADRの監査
このADRを監査してください：nn[ADR]nn生成：n1. **強み** : 何が良好か（厳密さ、明確さ、完全性）n2. **弱点** : 何が足りないか（不足オプション、過小評価された結果、Plan B がない）n3. **必要な更新** : 執筆以降の進化があるなか、技術に何が変わったか4. **推奨** : ADRはまだ有効／更新が必要／再検討すべき nn建設的かつ事実に基づいて。
推奨ツール
Claude Opus 4.5
★ 4.9 (92) · 20 USD/mois
Claude Opus 4.5 : modèle premium d’Anthropic pour code, agents et tâches complexes en entreprise.
なぜ : Le meilleur reasoning sur les choix techniques complexes nécessitant la pesée multi-critères et l'anticipation des conséquences.
Claude AI
★ 4.9 (55) · Gratuit
Assistant conversationnel d’Anthropic axé sécurité et contexte long. Excellent pour rédaction, analyse, résumés, code et agents. Interface claire, bons résultats en français.
なぜ : Excellence sur la rédaction structurée et rigoureuse des ADR. Format Michael Nygard ou variante au choix.
Perplexity AI
★ 4.9 (211) · 20 USD/mois
Assistant de recherche IA qui fournit des réponses sourcées et vérifiables en temps réel.
なぜ : Pour benchmarker en temps réel avec sources fraîches (versions actuelles, retours d'expérience, comparaisons à jour).
推定ROI
時間短縮
文章70%短縮（30～60分 対 2～3時間）
