create-architectural-decision-record は何をしますか？
AI に最適化された意思決定文書を作成するためのアーキテクチャ決定記録 (ADR) 文書を作成します。
概要
このスキルを使用すると、プロジェクト内の重要なアーキテクチャ上の決定を記録する ADR 文書を生成できます。ADR は、決定の内容、背景、結果、および検討された代替案を明確かつ簡潔に文書化するための構造化された形式を提供します。
使用法
このスキルを AI エージェントと一緒に使用するには、次のように呼び出します。
/claude create-architectural-decision-record "決定のタイトルをここに記述"
出力形式
生成された ADR 文書はマークダウン形式で出力され、次のセクションが含まれます。
- タイトル: 決定の簡潔な名前
- ステータス: 草案 (draft)、提案中 (proposed)、承認済み (accepted)、非推奨 (deprecated)、置き換え済み (superseded) のいずれか
- コンテキスト: 決定が行われた背景と状況
- 決定: 行われた具体的なアーキテクチャ上の選択
- 結果: 決定のプラスとマイナスの影響
- 代替案: 検討された他のオプションとそれらが却下された理由
例
# ADR-001: データベースに PostgreSQL を採用する
## ステータス
承認済み
## コンテキスト
現在、アプリケーションは SQLite を使用していますが、同時接続数の増加とデータ整合性の要件により、より堅牢なデータベースソリューションが必要です。
## 決定
主要なデータベースとして PostgreSQL 13 を採用します。
## 結果
- プラス: 同時実行性の向上、より強力な整合性保証、拡張性に優れた機能
- マイナス: 運用オーバーヘッドの増加、追加のインフラストラクチャコスト
## 代替案
- MySQL: 同様の機能を提供しますが、PostgreSQL の拡張性に劣ります
- MongoDB: ドキュメント指向モデルは現在のリレーショナルデータモデルと一致しません
ヒント
- 決定は現在形で記述してください (「〜することにした」ではなく「〜を採用する」)
- 決定の背後にある「なぜ」に焦点を当ててください
- 各 ADR に一意の ID を付けてください
- 今参照できるように関連する決定を相互参照してください