アーキテクチャデシジョンレコード - Martin Fowler's Bliki (ja)

アーキテクチャデシジョンレコード（Architecture Decision Record: ADR）とは、プロダクトやエコシステムに関する重要なひとつの決定を記録および説明する簡潔な文書である。文書は短く、数ページ程度に収め、内容には決定事項、決定の背景、重要な影響を含めなければならない。決定を変更した場合は、文書を修正するのではなく、置き換えた決定にリンクしておく。 ほとんどの文書がそうであるように、ADRの作成にも2つの目的がある。まず、決定の記録である。数か月後あるいは数年後でもシステムが現在のように構築された理由を理解できる。だが、それよりも重要なのが、文書を書くことで考えが明確になる点である。グループの場合は特にそうだ。重要な文書を書くことで、異なる見解が浮かび上がってくる。こうした意見の違いについて議論し、できれば解消することが望ましい。 一般的なルールとして「逆ピラミッド」

[pekee-nuee-nuee]

ミーティングに参加して適切なADRに起こしてくれるAIが求められる

[otchy210]

"決定の記録はソースコードと同じリポジトリに保存することが推奨" いよいよここが重要な時代。AI に読んでもらわないとだからね。

[hasiduki]

ADRは記録なので承認されたら更新しない！！！！！！！変えたくなったら新しくADRを書く！！！！

[diveintounlimit]

リポジトリに保存するんだったらバージョンもgitで管理してもらえばよくね？

[mkusaka]

ADRの概要と書き方を解説。doc/adrにMarkdownで保存し、statusはproposed/accepted/supersededで管理する。

[t-wada]

ADR（Architecture Decision Record）についての Fowler の説明