アーキテクチャに限らず意思決定を全部残す「ADR（Any Decision Record）」という文化

SDD は Spec-Driven Development（仕様駆動開発）のことで、仕様を源泉としてコードを書く・生成する開発スタイルを指しています。Dress Code では OpenSpec を使って導入していて、その実践については別のメンバーが記事にしています。 データ層では Event Sourcing で「状態」ではなく「変化（イベント）」を残しています。状態はイベントから再生成できる派生物であって、守るべき源泉はイベントの方だ、という考え方です。この話は以前記事にしました。 この原則をアーキテクチャ層に持っていくと、「今のアーキテクチャ」自体は派生物です。 守るべき源泉は 「なぜそう作ったか」という意思決定 の方です。 意思決定が失われると、目の前の構成が「動いているから触れない」ブラックボックスになっていきます。 ADR → SDD → 実装 という流れで、上流の事実がそのま

[lunaphilia]

理由を残す必要は深く同意するものの、ADR自体のメンテナンスが重い気がして、Immutabilityがそんなに必要か？とおもう　システムの包括的なDesignDocをバージョン管理してどんどん改訂していけばいいのでは

[kekera]

これ、こんな感じでAI相手にはどのように判断したかを全部記録しておいた方が良い。ホント方針変更した場合の影響がわかりやすくて助かる

[pekee-nuee-nuee]

こういう感じのなんでもとりあえずドキュメントにするコストがすごい下がったんだよな。本当に助かっています

[georgew]

AI生成スライドに描かれてるキャラのコツメカワウソが可愛い...

[ebibibi]

私もADRをガンガン書いてる。いい感じ。確かにAnyにしてしまってもいいかも。

[shoh8]

“スタートアップ初期から意思決定を"資産化"したかった”

[crimson_diamond]

Claude はADRにします（やらない）（忘れる）という、ドングリを埋めて忘れるリスみたいなムーブするので、もう少し使い込んでから記事を書いたらどうか

[Listlessness]

なんかしらんけどClaudeが勝手に私の意思決定を全部ドキュメントに残してくれてる。たぶん会話の中で、文書に残しておかないとこいつは過去の決定をいつも蒸し返すと気づいたんだと思う。中身は読んだことがない。

[rokusan36]

欲しい

[Shinwiki]

当たり前

[yarumato]

“「状態はイベントから再生成できる派生物であって、守るべき源泉はイベントの方だ」という考え方を延伸すると、「今のアーキテクチャ」自体は派生物。守るべき源泉は 「なぜそう作ったか」という意思決定の方だ”

[marshi]

なんで既存の言葉と被せるの…

[nguyen-oi]

何でもADRにぶち込むと運用の形骸化が心配だけどAI検索前提なら上手く機能するのかも