スキル architecture-decision-records
📦

architecture-decision-records

安全

アーキテクチャ決定記録（ADR）の作成

こちらからも入手できます: wshobson

このスキルは、構造化されたテンプレートを使用して重要な技術的決定を文書化する際にチームを支援します。包括的な ADR 形式、ライフサイクル管理のガイダンス、コンテキスト・トレードオフ・根拠を記録するためのベストプラクティスを提供します。

対応: Claude Codex Code(CC)
🥉 75 ブロンズ
1

スキルZIPをダウンロード

2

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

3

オンにして利用開始

テストする

「architecture-decision-records」を使用しています。 フロントエンドプロジェクトでの TypeScript 採用の ADR を作成してください

期待される結果:

ステータス：承認済み、現在の React コードベースの課題に関するコンテキスト、TypeScript 採用の決定、長所（型安全性、IDE サポート）と短所（学習曲線、ビルドの複雑さ）を含む結果、トレーニングセッションを含む緩和策を備えた完全な ADR 文書。

「architecture-decision-records」を使用しています。 レガシー認証サービスの廃止を文書化する

期待される結果:

ADR-0015 を置き換えることを示すステータスを持つ廃止 ADR、現在のサービスの問題をリストしたコンテキスト、フェーズ別アプローチによる移行計画、元の決定でうまくいかなかったことについての学んだ教訓。

セキュリティ監査

安全
v1 • 2/24/2026

Security analysis confirms this is a safe documentation skill. Static findings for external_commands, network, and weak_crypto are false positives. The skill contains markdown templates, example CLI commands (shown as documentation), and reference URLs to external documentation. No executable code, no data exfiltration, no cryptographic operations.

1
スキャンされたファイル
444
解析された行数
0
検出結果
1
総監査数
セキュリティ問題は見つかりませんでした

検出されたパターン

False Positive: External Commands DetectionFalse Positive: Network DetectionFalse Positive: Weak Cryptographic Algorithm
監査者: claude

品質スコア

38
アーキテクチャ
100
保守性
87
コンテンツ
50
コミュニティ
100
セキュリティ
100
仕様準拠

作れるもの

データベース技術の選択の文書化

新しいプロジェクトで PostgreSQL、MySQL、MongoDB のいずれかを選択する際、標準 ADR テンプレートを使用して要件をキャプチャし、オプションを比較し、完全な根拠とともに決定を記録します。

フレームワーク移行決定の記録

Angular から React への移行を計画する際、廃止 ADR を作成して変更の理由、移行フェーズ、以前の決定から学んだ教訓を文書化します。

チーム決定プロセスの確立

新しいチームメンバーのオンボーディング時に、ADR テンプレートを使用して過去のアーキテクチャの選択と現在のアーキテクチャの背後にある理由を理解できるようにします。

これらのプロンプトを試す

基本的な ADR リクエスト 
[DECISION_TITLE] のアーキテクチャ決定記録を作成してください。標準 MADR 形式を使用し、この決定を行う必要がある理由のコンテキスト、検討したオプション、最終決定、結果を含めてください。
技術比較 
[USE_CASE] における [TECHNOLOGY_A]、[TECHNOLOGY_B]、[TECHNOLOGY_C] の比較 ADR を作成してください。各オプションの詳細な長所と短所、要件を含め、最良の選択を根拠とともに推奨してください。
廃止記録 
[NEW_TECHNOLOGY] に置き換えられる [OLD_TECHNOLOGY] の廃止 ADR を作成してください。当初の決定が行われた理由のコンテキスト、何が変わったか、移行計画、学んだ教訓を含めてください。
RFC スタイル提案 
[PROPOSAL] の詳細な RFC スタイル ADR を作成してください。動機、詳細な設計、欠点、検討された代替案、未解決の質問、実装計画を含め、チームのレビューと議論に適したものにしてください。

ベストプラクティス

  • 決定のコンテキストを正確に把握するために、実装開始前に ADR を作成する
  • 結果セクションに正直なトレードオフと潜在的な欠点を含める
  • 関連する ADR をリンクして、プロジェクトの決定依存関係グラフを構築する
  • 決定が廃止または置き換えられた際に ADR のステータスを更新する

回避

  • 具体的なコンテキストや根拠なしに曖昧な決定を記述する
  • 他のオプションが検討されたことを示すことを避けるために代替セクションを省略する
  • 置き換えるために新しい ADR を作成する代わりに、承認済みの ADR を変更する
  • アーキテクチャ文書化を必要としない軽微な決定のために ADR を作成する

よくある質問

アーキテクチャ決定記録（ADR）とは何ですか？
アーキテクチャ決定記録（ADR）は、プロジェクト中に行われた重要なアーキテクチャ決定を記録する文書です。通常、コンテキスト、決定そのもの、その決定の結果を含みます。
いつ ADR を作成すべきですか？
フレームワークの採用、データベース技術の選択、API デザインパターン、セキュリティアーキテクチャ、統合パターンなどの重要なアーキテクチャ決定を行う際に ADR を作成してください。軽微なパッチや定期的なメンテナンスでは ADR をスキップします。
どの ADR 形式を使用すべきですか？
包括的な決定には標準 MADR 形式を、迅速な決定には軽量形式を、簡潔な選択には Y-Statement を、チームのレビューを必要とする複雑な提案には RFC スタイルを使用してください。
関連する ADR をどのようにリンクしますか？
各 ADR に「関連する決定」セクションを含め、番号で他の ADR を参照してください。「ADR-0003 を置き換える」や「ADR-0002 を補完する」などのステータスインジケーターを使用して関係を示します。
承認済みの ADR を変更できますか？
いいえ。承認済みの ADR は変更しないでください。代わりに、古いものを置き換える新しい ADR を作成し、何が変わったのか、なぜ変わったのかを文書化してください。
ADR 管理に役立つツールは何ですか？
adr-tools は ADR 管理に人気のある CLI ツールです。ディレクトリの初期化、新しい ADR の作成、目次の生成、関連する決定のリンクを行うことができます。

開発者の詳細

作成者

sickn33

ライセンス

MIT

リポジトリ

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/architecture-decision-records

参照

main

ファイル構成

📄 SKILL.md