ADRは経緯より「決まったこと」だけでいい

はじめに 先に言っておくと、僕はADR（Architecture Decision Record）を全否定するつもりはありません。設計の判断を残しておくのは、明らかに価値があります。 ただ、ADRの話になると必ず「経緯を丁寧に残そう」という方向に進みがちです。なぜその設計にしたのか、どんな議論があったのか、どの案を捨てたのか。 でも、正直なところ経緯って、本当にそんなに大事でしょうか？ Railsで開発していると、日々たくさんの判断をします。その全部に経緯を書くのは現実的じゃない。そして書いたところで、後で役に立った実感があまりない。今日はそのあたりの話をします。 経緯は「大事そう」に見える 経緯を残したくなる気持ちは、すごくよく分かります。 後から「なんでこうしたの？」と聞かれたときに答えられる 同じ議論を蒸し返さずに済む 判断の背景を共有すれば、チームの納得感が上がる どれも正論です。

[Error401]

決定理由こそが大事だと思う。なんでこうしたんだっけということになりがちで、AとBでAにした理由（Bにしなかった理由）を調べることなく知るための情報にしたい。量の話はAIが解決してくれた。

[nida3001]

逆に決まったことなんてリポジトリ見ればわかるじゃん

[gabill]

ADRを「ここ見れば最新の仕様がわかる場所」としてみるか、「決まった経緯と前提条件が分かる場所」と見るか。自分は後者で、前者は別の所でやればいいと思う。

[itotto]

経緯の薄いADRならいらない派。そのときの決定についての経緯や背景込みで書くものであって、基本メンテナンスはしない（ステータス変えるくらい）ものかなと思ってた。内容が変わるならいまのは廃止で追加する。

[aiueokabe]

タイトルでは経緯不要と言いつつ本文では無いと困るから1行で書くとあり意味不明。ADRはまさに意思決定に至った当時の背景や理由を残すためのものであり、そこを否定するのはADRの否定と同義だろ

[Sampo]

寿命の長いシステムの面倒を見て修羅場くぐった経験つんだらまた考え方も変わるかもなと思いました。「なんでこんな処理があるの？　残しとかなくちゃダメ！？」ってなったとき経緯があるとないで時間の溶け方が違う

[hogetax]

今となってはTEXTが多いことはあまりデメリットにならないし、そもそも自分で記述することも少なくなっているので、ちょっと気持ちが理解できなかった

[prograti]

技術的なことはある程度推測できるけど、ビジネス的な背景や制約条件がちゃんと書かれていなかったら、後任の人がアーキテクチャ見直しを行う時に困ったりしないかな？

[takashiski]

「コードを読めばわかることを丁寧に記述しろ」「コードからわからない経緯は1行以下にしろ」という謎の主張。「AではなくBの理由はこういう問題があったから」がわからなくて調査に数日かけた経験、ないんかな

[Listlessness]

うちのClaudeは結果だけだと同じ事を議論する羽目になるからWhyを残すんやでって言ってるよ。

[hase0510]

前提はすぐ古くなるから意味がない～？？？ 前提が古くなったら判断をやり直さなきゃいけないじゃん？ 前提が古くなったことに気づけるのは前提を記録しておいたからこそじゃん。

[dd41kk]

検討したけど採用しなかった案は残してる。採用しなかったのにはそれなりの理由があって、そこに行き着くまでにはそれなりの時間を要するので、価値がある

[trace22]

お前が読まねーからなくていいってか

[remonoil]

"ADRは経緯より「決まったこと」だけでいい" だけでは足りないから記事書いたんでしょ？やっぱり経緯が必要なんだよ

[neos21]

「なぜこれに決定したか」も大事だが、その過程で採用しなかったことについて「なぜ」を残すことって、システムの役割分担や寿命といった境界線を示すためにかなり重要だと思うんだが。

[dekaino]

うへあ。大事なのは過去の「理由」よりも過去の「要求」とか過去の「目的」だと思う。それらに低コストかつ簡単にアクセスできると都合が悪い人はそこそこいると思うけれども詭弁ふるって潰さないで。

[toaruR]

『経緯を丁寧に残そう』……AI時代的には、一次記録の綺麗さよりも、抜け漏れの少なさの方が重要そう

[otoan52]

ADRはドキュメントじゃなくてログだよ。書き換えちゃいけない。内容は古くて腐ってていい。でも、なぜそう決めたのかは残っていないといけない。決定の上書きは必ず必要になるからだ。無いと妥当性の評価が難しくなる

[kompiro]

決まったことを辿っていけば済むソースコード考古学をやらなくて済む現場は幸せやね。

[mrmt]

「決まったこと」はADRのメタデータとしてとても大事だが、言っちゃえばメタデータに近いものであり、なんでこうなってんの? が本体であり価値であり目的であり、DecisionのRecordだと思うなあ。

[akahmys]

“「Sidekiqのバージョンがこうだから」→ もうアップグレード済み” ←これこそ、分からなくなると意味が無くなったコードに誰も触れないって問題になるんじゃないの？逆に「決まったこと」はコードそのものじゃん。

[Fluss_kawa]

なぜその実装にすることにしたのかが残ってないとしばらくしてまた同じこと議論するんだよね。同じこと議論するにしても前回そうしなかった理由が書いてあれば状況が変わってなければ議論せずに却下できることもある

[sd-craft]

ADRは更新しないのでその運用は別の形式を採用したらいいと思う

[morucy]

いや、経緯なんてめっちゃ必要でしょ。決定事項だけあっても、それがどういう理由で決まったのか分かんなかったら振り返った時に妥当性が判断できねえ。

[Magicant]

結論がどんな要件や制約から導き出されたものなのかを記録することに意味があるんでね。要件とか無視して適当に決めて問題なかったなら、それたぶん ADR 残す必要ない些事だよ

[rAdio]

『気持ちは、すごくよく分かります。』『実感ベースで言います。』『大事だと思うのは、経緯ではなく決定そのものです。』「**強調そのまま」

[ustam]

人間は読まなくてもAIが読むので無駄にはならないかな？　似たような議論が起きた時に、「過去にも似たような議論があった」とAIが教えてくれる感じ？

[nguyen-oi]

経緯長文で残しても前提変わったら負債になるのガチであるある。メンテされないドキュメントより動いてるコードと決定事項1行のほうが100倍役に立つわ

[R2M]

AIが読むとなったら、多少違った答えになりそう