最近ADR推してます

PHPerKaigi mini #4発表資料

Transcript

1. 最近ADR推してます 2026/08/24 PHPerKaigi mini #4 1
2. 自己紹介 名前：濱 恭己（はま やすき） ニックネーム：やっさん 所属：株式会社クイック（中途14年目） 職業：ソフトウェアエンジニア 好きなもの：音楽ライブ（メタルetc.）、落語、ロンドン X：@c1ipn0te 2026/08/24 PHPerKaigi mini #4 2
3. 目次 ADRとは？ 私とADRの歴史 ADRをどう書いているか ADR作成による副次的効果 まとめ 2026/08/24 PHPerKaigi mini #4 3
4. ADRとは？ Architecture Decision Recordの略称。システム開発におけるアー キテクチャ上の決定とその文脈（背景・理由）を残す軽量ドキュ メント。 ArchitectureをAnyに変え、決定事項は「なんでも」残すところもある 2026/08/24 PHPerKaigi mini #4 4
5. ADRとは？ うちのチームで使っているフォーマット 文脈 決定が必要になった背景、状況、問題点 技術的な課題、ビジネス要件、制約条件など、意思決定に影響を与える要素 決定 理由 影響 決定によって生じる結果や影響、代替案を選ばなかったことによるトレードオフ など 2026/08/24 PHPerKaigi mini #4 5
6. 私とADRの歴史 ADRとの出会い（2017年ごろ） 親方と呼ばれていた優秀なフリーランスエンジニアの 方からADRの存在を教えてもらった その当時「ええやん！」と思ったものの、そのタイミ ングで書くような事柄が（おそらく）なかったことも あり、整えるのは腰が重く対応せず 2026/08/24 PHPerKaigi mini #4 6
7. 私とADRの歴史 組織拡大に伴い「文脈喪失」課題が露呈（2019年〜） 2019年くらいから多くのメンバーが入社 こういうやり取りが増えた 新：なんでこうなってるんですか？ 私：それBacklogに残ってないですかね？ 新：ないですね。。。 私：ないか。。。うーん、覚えていないです。すみ ません。。。 今振り返ると、2017年時点で残すよう取り組みをして いれば状況は変わっていたかも 2026/08/24 PHPerKaigi mini #4 7
8. 私とADRの歴史 新チームでの実践（2025年3月〜現在） 新規開発チームに参画 神様と呼ばれているテックリードが「うち決定経緯残 っていないことが多いので、ADRつくっていきたいん ですよね」と言っていたので、私は「ぜひやりましょ う！」と後押し そして、実践していくことに 2026/08/24 PHPerKaigi mini #4 8
9. ADRをどう書いているか 初期のアプローチ 1名が草案作成 -> 全体で議論 課題 草案品質が作成者の経験に依存 し、後続の議論の質に影響あり 全体議論がレビューになり、一 緒につくりあげる感が薄い 2026/08/24 PHPerKaigi mini #4 現在のアプローチ ペア/モブで議論しながら作成 作成段階から複数人で会話しながら 決定までもっていく 決定事項は内容によって同期・非同 期を使い分けて展開 9
10. ADR作成による副次的効果 1. 共通理解の強化 背景を書く過程で前提の認識違いが 表面化し、決定前に解消できる すり合わせた共通理解は、今後の開 発にも活きる 2026/08/24 PHPerKaigi mini #4 2. メンバー育成機会の創出 ペア/モブでの議論に経験豊富なメン バーが1名は入るようにしており、意 思決定プロセスを経験の浅いエンジ ニアが学べる ADRをつくる過程に加わることで、 自分も意思決定に携わっている実感 が持てる 10
11. まとめ ADRは、未来への資産を生み出すだけでなく、現在の チーム強化にもつながる取り組み 2026/08/24 PHPerKaigi mini #4 11
12. ご清聴ありがとうございました！ 2026/08/24 PHPerKaigi mini #4 12