ADRs4AI: 人間とAIの協働のためのバージョン管理された検討記録
コアコンセプト: 推論プロセスの記録
ADRs4AIは、人間とAIの協働において「蒸発」してしまう推論プロセスという問題に対し、検討プロセスをバージョン管理されたアーキテクチャ決定記録（ADR）として形式化することで対処します。コードは保存されますが、その背後にある論理、検討された選択肢、AIモデルと議論されたトレードオフは通常失われてしまいます。このフレームワークは、これらの検討事項を構造化されたGitバージョン管理形式で記録することを義務付け、将来の共同作業者が特定の実装選択の「理由」を理解できるようにします。
ADRs4AIのワークフロー
この手法は、意図の「シード（種）」を捉え、AIにその意図をADRとして構造化させ、人間が最終的な判断を下すというシンプルなループを中心に構成されています。このプロセスは、標準的な開発サイクルに統合できるように設計されています。
- シード: ユーザーは最初の考えや要件をファイルに書き出します。
- 構造化: AIはこの入力を処理し、未解決の質問を特定し、根拠、信頼度、潜在的な反証を伴う選択肢を提案します。
- 判断: 人間はAIの推奨事項をレビューし、最終決定を下します。その後、その決定がリポジトリにコミットされます。
このワークフローは、未解決の質問をツリービューで表示するVS Code拡張機能や、外出先で決定事項をレビューして承認できるiOSクライアントによってサポートされています。システムは特定のタグ ### QST: を使用しており、grep のような標準ツールで未解決の質問を簡単に検索できるようにしています。
実装とツール
このエコシステムは、このプラクティスの導入障壁を下げるためのいくつかのツールを提供しています。
- リポジトリテンプレート: ADRテンプレート、ディレクティブ、インボックスプロトコルを含むスターターテンプレート。
- VS Code拡張機能: 不適切な形式の記録に対する診断機能や、AIエージェントがプロジェクトの履歴記録をクエリできるようにするMCPサーバーを備えています。
- iOSクライアント: 保留中の決定をレビューし、回答を直接リポジトリにコミットするためのモバイルインターフェース。
コミュニティからのフィードバックと批判
Hacker NewsにおけるADRs4AIの評価は、構造化された意思決定の潜在的な有用性と、実装に関する実用的な懸念の両方を浮き彫りにしました。
一部のユーザーは、プロジェクトのマーケティング色の強いプレゼンテーションに対して懐疑的な見方を示し、ADRというコアコンセプトはソフトウェアエンジニアリングにおいてすでに十分に理解されていると指摘しました。また、AI主導のワークフローにおける「ドキュメントの腐敗（doc rot）」のリスクを懸念する声もありました。
"エージェントは、ADRが記録しているとされる様々な矛盾する『ガードレール』や『制約』によって混乱し始めるでしょう。なぜそのような不自然なことをしたのかとエージェントに尋ねると、欠陥があったり時代遅れだったりする仮定を引用するはずです。これは昔からあるドキュメントの腐敗という問題と同じですが、今やドキュメントは盲目的に従われるようになっています。" — @handle
一方で、このシステムの支持者は、intent.md ファイルのような設計ルールを文書化することは、AI支援による開発セッション全体で一貫性を維持するために非常に効果的であると指摘しました。ユーザーは、このプロジェクトがより広く採用されるためには、文書化の理論的な利点を超えて、特定の厄介な課題をどのように解決するかを示す、より明確で現実的なケーススタディを提供する必要があると提案しました。