https://b.hatena.ne.jp/entry/s/zenn.dev/yamitake/articles/adr-decision-over-context はじめに 先に言っておくと、僕はADR（Architecture Decision Record）を全否定するつもりはありません。設計の判断を残しておくのは、明らかに価値があります。 ただ、ADRの話になると必ず「経緯を丁寧に残そう... https://b.hatena.ne.jp/kuwadgi/20260908#bookmark-4792687000566804674 2026-09-08T02:16:53Z あとで読む https://b.hatena.ne.jp/isk_sss/20260908#bookmark-4792687000566804674 2026-09-08T01:54:06Z https://b.hatena.ne.jp/morimarii/20260908#bookmark-4792687000566804674 いいわけないだろ。決まったことなんてコードみりゃいいんだから。経緯がなかったら同じ議論検討調査を違う人間が再生産することになる 2026-09-07T22:21:03Z https://b.hatena.ne.jp/fusionstar/20260908#bookmark-4792687000566804674 AI が迷ったこととか、検討したけど採用しなかった選択肢と、その案を採用しなかった理由、最終案を採用した理由は別のファイル thoughts/*.md に出力させてるよ。 自分が読むかはともかく、 AI の思考がぶれないように。 2026-09-07T16:56:23Z https://b.hatena.ne.jp/kakushika/20260908#bookmark-4792687000566804674 2026-09-07T16:16:04Z https://b.hatena.ne.jp/amatou310/20260908#bookmark-4792687000566804674 全然賛成できない。経緯を記録しないならADRなんか書かなくていいと思う。手間がかかるのはわかるし。このときこう決めたけど前提となったこれはもう廃止してるじゃん、も大事な情報だと思う。 2026-09-07T15:49:29Z https://b.hatena.ne.jp/Hawaii0177/20260908#bookmark-4792687000566804674 2026-09-07T15:38:54Z https://b.hatena.ne.jp/fuzitahoushirou/20260908#bookmark-4792687000566804674 2026-09-07T15:34:31Z 決める あとで読む ADR システム設計 https://b.hatena.ne.jp/single_wing/20260908#bookmark-4792687000566804674 2026-09-07T15:25:05Z https://b.hatena.ne.jp/yamori0408/20260908#bookmark-4792687000566804674 2026-09-07T15:22:58Z あとで読む https://b.hatena.ne.jp/CLSmooth/20260908#bookmark-4792687000566804674 2026-09-07T15:16:09Z https://b.hatena.ne.jp/nigiri10can/20260908#bookmark-4792687000566804674 2026-09-07T15:01:31Z あとで読む https://b.hatena.ne.jp/kinshachi758/20260907#bookmark-4792687000566804674 2026-09-07T14:57:52Z https://b.hatena.ne.jp/NSTanechan/20260907#bookmark-4792687000566804674 2026-09-07T14:34:00Z https://b.hatena.ne.jp/lunaphilia/20260907#bookmark-4792687000566804674 現状がこうなってる理由が書いてある文書があって、過去の経緯がその文書のバージョン履歴とコミットメッセージに書かれてたらADRなんていらない派 2026-09-07T13:57:14Z https://b.hatena.ne.jp/snow8-yuki/20260907#bookmark-4792687000566804674 履歴残してるが、コードにより自明の部分は残さず、非自明部分だけ切り出してるけどな……。 2026-09-07T13:39:12Z https://b.hatena.ne.jp/o2aholic/20260907#bookmark-4792687000566804674 2026-09-07T13:38:24Z あとで読む https://b.hatena.ne.jp/Marukosu/20260907#bookmark-4792687000566804674 2026-09-07T13:32:05Z ADR https://b.hatena.ne.jp/wawawa12345/20260907#bookmark-4792687000566804674 2026-09-07T13:27:08Z https://b.hatena.ne.jp/makopy_inside/20260907#bookmark-4792687000566804674 2026-09-07T13:13:13Z https://b.hatena.ne.jp/natsuvien/20260907#bookmark-4792687000566804674 「原監督は言います」みたいな文章はAI確定演出ですよ。「効く」などAI臭全開ブログで、案の定タイトルと本文の主張が一致してなくて何やねんって言う読後感になります。 2026-09-07T13:10:13Z https://b.hatena.ne.jp/hatohaya0216/20260907#bookmark-4792687000566804674 2026-09-07T13:07:45Z あとで読む https://b.hatena.ne.jp/yo-mei777/20260907#bookmark-4792687000566804674 2026-09-07T13:05:40Z https://b.hatena.ne.jp/peketamin/20260907#bookmark-4792687000566804674 2026-09-07T13:02:30Z https://b.hatena.ne.jp/BOOOOOOOON/20260907#bookmark-4792687000566804674 ADR言うほど要るか？　ってなってる。どうせコードにそれが現れてコードからリバースできるのに。ADRが30も40も溜まっていった時にどうすんの？ 2026-09-07T12:49:59Z https://b.hatena.ne.jp/hourousuteneko/20260907#bookmark-4792687000566804674 2026-09-07T12:37:54Z https://b.hatena.ne.jp/khtno73/20260907#bookmark-4792687000566804674 「トラフィックがこの規模だから」これでいいとしてたんだなって分かれば今そこ変えていいか/変えるべきかの判断が早くなるやんけなんでそれ削るんだなんでこんな仕掛けにしてたんだっけ？を追う工数増やしたいの？ 2026-09-07T12:37:19Z https://b.hatena.ne.jp/ouj3/20260907#bookmark-4792687000566804674 ADRの存在意義が分かってなくて草。 決まったことを書くのは仕様書なんだよ。 2026-09-07T12:28:05Z https://b.hatena.ne.jp/mushus/20260907#bookmark-4792687000566804674 経緯の書いてあるソースコードだけで良いのでは 2026-09-07T12:15:30Z https://b.hatena.ne.jp/vanbraam/20260907#bookmark-4792687000566804674 いい訳ない. 実際記事中では経緯も必要と書いてる. 尤も1行じゃ全く足りない. 最低でも "なぜそれが問題になったか" と "なぜそのdecisionをしたか(他の選択肢もここに含まれる)" は必要 2026-09-07T11:45:55Z 疑義あり software development design https://b.hatena.ne.jp/omiomiso/20260907#bookmark-4792687000566804674 2026-09-07T11:42:37Z あとで読む https://b.hatena.ne.jp/kekera/20260907#bookmark-4792687000566804674 決めた時の前提と選ばなかった選択肢は必要でしょう。そうすると今の設計で課題が出た時の検討に役立つ。どうせ読むのはAIだから記録できることは記録しておこうよ。 2026-09-07T11:36:52Z https://b.hatena.ne.jp/guitgraph/20260907#bookmark-4792687000566804674 2026-09-07T11:34:05Z あとで読む https://b.hatena.ne.jp/Cetus/20260907#bookmark-4792687000566804674 2026-09-07T11:27:26Z https://b.hatena.ne.jp/hirorinya/20260907#bookmark-4792687000566804674 最新に保つなんて当たり前すぎ と、こうやって炎上狙いかなと思うほどのクソ記事 2026-09-07T11:26:09Z https://b.hatena.ne.jp/yamekodev/20260907#bookmark-4792687000566804674 知ってる知ってる。裁判外紛争解決手続のことよね（法学部並感 2026-09-07T11:21:52Z https://b.hatena.ne.jp/qtamaki/20260907#bookmark-4792687000566804674 「なんでJavaなのTypescriptは検討した？」って代わる代わる10回聞かれる刑に処す 2026-09-07T10:33:51Z https://b.hatena.ne.jp/atsushieno/20260907#bookmark-4792687000566804674 design docsはdesign docsとして残せばいいのでは 2026-09-07T10:05:53Z https://b.hatena.ne.jp/momonga_dash/20260907#bookmark-4792687000566804674 Claudeに書かせると過大な経緯を書くので気持ちはわからんくもない。ただ、そう思う人はClaudeに事実だけを羅列させてないか確認した方がいい。ADRこそ、あなたの意図を残すべきところ。 2026-09-07T10:05:12Z https://b.hatena.ne.jp/hase0510/20260907#bookmark-4792687000566804674 前提はすぐ古くなるから意味がない～？？？ 前提が古くなったら判断をやり直さなきゃいけないじゃん？ 前提が古くなったことに気づけるのは前提を記録しておいたからこそじゃん。 2026-09-07T09:53:17Z https://b.hatena.ne.jp/knj2918/20260907#bookmark-4792687000566804674 2026-09-07T09:39:56Z あとで読む https://b.hatena.ne.jp/oh_157/20260907#bookmark-4792687000566804674 2026-09-07T09:36:14Z https://b.hatena.ne.jp/dd41kk/20260907#bookmark-4792687000566804674 検討したけど採用しなかった案は残してる。採用しなかったのにはそれなりの理由があって、そこに行き着くまでにはそれなりの時間を要するので、価値がある 2026-09-07T09:36:04Z https://b.hatena.ne.jp/trace22/20260907#bookmark-4792687000566804674 お前が読まねーからなくていいってか 2026-09-07T09:23:53Z https://b.hatena.ne.jp/remonoil/20260907#bookmark-4792687000566804674 "ADRは経緯より「決まったこと」だけでいい" だけでは足りないから記事書いたんでしょ？やっぱり経緯が必要なんだよ 2026-09-07T09:10:39Z https://b.hatena.ne.jp/move0tofu/20260907#bookmark-4792687000566804674 2026-09-07T09:02:38Z あとで読む https://b.hatena.ne.jp/takasago08/20260907#bookmark-4792687000566804674 2026-09-07T08:56:19Z https://b.hatena.ne.jp/neos21/20260907#bookmark-4792687000566804674 「なぜこれに決定したか」も大事だが、その過程で採用しなかったことについて「なぜ」を残すことって、システムの役割分担や寿命といった境界線を示すためにかなり重要だと思うんだが。 2026-09-07T08:54:35Z https://b.hatena.ne.jp/kazuya030/20260907#bookmark-4792687000566804674 2026-09-07T08:35:20Z https://b.hatena.ne.jp/aiueokabe/20260907#bookmark-4792687000566804674 タイトルでは経緯不要と言いつつ本文では無いと困るから1行で書くとあり意味不明。ADRはまさに意思決定に至った当時の背景や理由を残すためのものであり、そこを否定するのはADRの否定と同義だろ 2026-09-07T08:24:46Z AI_Slop https://b.hatena.ne.jp/dekaino/20260907#bookmark-4792687000566804674 うへあ。大事なのは過去の「理由」よりも過去の「要求」とか過去の「目的」だと思う。それらに低コストかつ簡単にアクセスできると都合が悪い人はそこそこいると思うけれども詭弁ふるって潰さないで。 2026-09-07T08:23:11Z https://b.hatena.ne.jp/toaruR/20260907#bookmark-4792687000566804674 『経緯を丁寧に残そう』……AI時代的には、一次記録の綺麗さよりも、抜け漏れの少なさの方が重要そう 2026-09-07T08:20:15Z https://b.hatena.ne.jp/otoan52/20260907#bookmark-4792687000566804674 ADRはドキュメントじゃなくてログだよ。書き換えちゃいけない。内容は古くて腐ってていい。でも、なぜそう決めたのかは残っていないといけない。決定の上書きは必ず必要になるからだ。無いと妥当性の評価が難しくなる 2026-09-07T08:18:21Z https://b.hatena.ne.jp/kompiro/20260907#bookmark-4792687000566804674 決まったことを辿っていけば済むソースコード考古学をやらなくて済む現場は幸せやね。 2026-09-07T08:13:39Z https://b.hatena.ne.jp/mrmt/20260907#bookmark-4792687000566804674 「決まったこと」はADRのメタデータとしてとても大事だが、言っちゃえばメタデータに近いものであり、なんでこうなってんの? が本体であり価値であり目的であり、DecisionのRecordだと思うなあ。 2026-09-07T08:10:02Z https://b.hatena.ne.jp/yasuhiro1212/20260907#bookmark-4792687000566804674 2026-09-07T08:09:44Z あとで読む https://b.hatena.ne.jp/hobbiel55/20260907#bookmark-4792687000566804674 2026-09-07T07:57:43Z programming architecture development https://b.hatena.ne.jp/akahmys/20260907#bookmark-4792687000566804674 “「Sidekiqのバージョンがこうだから」→ もうアップグレード済み” ←これこそ、分からなくなると意味が無くなったコードに誰も触れないって問題になるんじゃないの？逆に「決まったこと」はコードそのものじゃん。 2026-09-07T07:35:25Z https://b.hatena.ne.jp/takashiski/20260907#bookmark-4792687000566804674 「コードを読めばわかることを丁寧に記述しろ」「コードからわからない経緯は1行以下にしろ」という謎の主張。「AではなくBの理由はこういう問題があったから」がわからなくて調査に数日かけた経験、ないんかな 2026-09-07T07:18:11Z https://b.hatena.ne.jp/prograti/20260907#bookmark-4792687000566804674 技術的なことはある程度推測できるけど、ビジネス的な背景や制約条件がちゃんと書かれていなかったら、後任の人がアーキテクチャ見直しを行う時に困ったりしないかな？ 2026-09-07T07:05:14Z https://b.hatena.ne.jp/yamasina67/20260907#bookmark-4792687000566804674 2026-09-07T06:55:52Z あとで読む https://b.hatena.ne.jp/tasukuchan/20260907#bookmark-4792687000566804674 2026-09-07T06:47:40Z https://b.hatena.ne.jp/ButterflyFish/20260907#bookmark-4792687000566804674 2026-09-07T06:45:21Z ADR architecture https://b.hatena.ne.jp/toshikish/20260907#bookmark-4792687000566804674 2026-09-07T06:38:48Z https://b.hatena.ne.jp/hogetax/20260907#bookmark-4792687000566804674 今となってはTEXTが多いことはあまりデメリットにならないし、そもそも自分で記述することも少なくなっているので、ちょっと気持ちが理解できなかった 2026-09-07T06:30:06Z https://b.hatena.ne.jp/Listlessness/20260907#bookmark-4792687000566804674 うちのClaudeは結果だけだと同じ事を議論する羽目になるからWhyを残すんやでって言ってるよ。 2026-09-07T06:13:52Z https://b.hatena.ne.jp/Fluss_kawa/20260907#bookmark-4792687000566804674 なぜその実装にすることにしたのかが残ってないとしばらくしてまた同じこと議論するんだよね。同じこと議論するにしても前回そうしなかった理由が書いてあれば状況が変わってなければ議論せずに却下できることもある 2026-09-07T05:58:51Z https://b.hatena.ne.jp/sd-craft/20260907#bookmark-4792687000566804674 ADRは更新しないのでその運用は別の形式を採用したらいいと思う 2026-09-07T05:56:47Z https://b.hatena.ne.jp/morucy/20260907#bookmark-4792687000566804674 いや、経緯なんてめっちゃ必要でしょ。決定事項だけあっても、それがどういう理由で決まったのか分かんなかったら振り返った時に妥当性が判断できねえ。 2026-09-07T05:43:55Z https://b.hatena.ne.jp/itotto/20260907#bookmark-4792687000566804674 経緯の薄いADRならいらない派。そのときの決定についての経緯や背景込みで書くものであって、基本メンテナンスはしない（ステータス変えるくらい）ものかなと思ってた。内容が変わるならいまのは廃止で追加する。 2026-09-07T05:41:28Z 開発 雑記 https://b.hatena.ne.jp/todays_mitsui/20260907#bookmark-4792687000566804674 2026-09-07T05:34:57Z あとで読む https://b.hatena.ne.jp/nida3001/20260907#bookmark-4792687000566804674 逆に決まったことなんてリポジトリ見ればわかるじゃん 2026-09-07T05:34:36Z https://b.hatena.ne.jp/shino_azm/20260907#bookmark-4792687000566804674 2026-09-07T05:27:31Z あとで読む https://b.hatena.ne.jp/tamasamatuyama/20260907#bookmark-4792687000566804674 2026-09-07T05:23:59Z https://b.hatena.ne.jp/Magicant/20260907#bookmark-4792687000566804674 結論がどんな要件や制約から導き出されたものなのかを記録することに意味があるんでね。要件とか無視して適当に決めて問題なかったなら、それたぶん ADR 残す必要ない些事だよ 2026-09-07T05:19:53Z システム設計 https://b.hatena.ne.jp/rAdio/20260907#bookmark-4792687000566804674 『気持ちは、すごくよく分かります。』『実感ベースで言います。』『大事だと思うのは、経緯ではなく決定そのものです。』「**強調そのまま」 2026-09-07T05:11:51Z https://b.hatena.ne.jp/gabill/20260907#bookmark-4792687000566804674 ADRを「ここ見れば最新の仕様がわかる場所」としてみるか、「決まった経緯と前提条件が分かる場所」と見るか。自分は後者で、前者は別の所でやればいいと思う。 2026-09-07T04:56:47Z https://b.hatena.ne.jp/tnaototo/20260907#bookmark-4792687000566804674 2026-09-07T04:44:33Z https://b.hatena.ne.jp/ustam/20260907#bookmark-4792687000566804674 人間は読まなくてもAIが読むので無駄にはならないかな？　似たような議論が起きた時に、「過去にも似たような議論があった」とAIが教えてくれる感じ？ 2026-09-07T04:43:50Z https://b.hatena.ne.jp/Sampo/20260907#bookmark-4792687000566804674 寿命の長いシステムの面倒を見て修羅場くぐった経験つんだらまた考え方も変わるかもなと思いました。「なんでこんな処理があるの？　残しとかなくちゃダメ！？」ってなったとき経緯があるとないで時間の溶け方が違う 2026-09-07T04:42:02Z https://b.hatena.ne.jp/nguyen-oi/20260907#bookmark-4792687000566804674 経緯長文で残しても前提変わったら負債になるのガチであるある。メンテされないドキュメントより動いてるコードと決定事項1行のほうが100倍役に立つわ 2026-09-07T04:39:22Z https://b.hatena.ne.jp/Error401/20260907#bookmark-4792687000566804674 決定理由こそが大事だと思う。なんでこうしたんだっけということになりがちで、AとBでAにした理由（Bにしなかった理由）を調べることなく知るための情報にしたい。量の話はAIが解決してくれた。 2026-09-07T04:31:39Z https://b.hatena.ne.jp/quodius/20260907#bookmark-4792687000566804674 2026-09-07T04:21:15Z https://b.hatena.ne.jp/R2M/20260907#bookmark-4792687000566804674 AIが読むとなったら、多少違った答えになりそう 2026-09-07T02:52:00Z 設計 https://b.hatena.ne.jp/kkeisuke/20260907#bookmark-4792687000566804674 2026-09-07T02:10:01Z