Skip to main content
Architecture9 min read

誰も書き留めないアーキテクチャ決定

KafkaとRabbitMQの選択に何週間も費やすのに、なぜそうしたのかを文書化しない。ADRなら15分で済み、『なぜこうしたのか』という問い合わせに何ヶ月も費やすのを防げる。

Part ofProduct Systems->
By Jason TeixeiraDecember 20, 2025
ArchitectureDocumentationADRDecision MakingBest Practices
Share:
On this page

6ヶ月前、私はNexuralでFirebaseではなくSupabaseを選んだ。PostgreSQL、行レベルセキュリティ、セルフホスト可能——良い理由があった。しかし、その理由をほとんど忘れかけていた。同じ決断を再評価する(そして1週間を無駄にする)ことから私を救ったのは、たった15分で書いたマークダウンファイルだった。

問題

どのエンジニアリングチームにもこんな会話がある:

「なぜRabbitMQを使っていてKafkaじゃないんだ?」 「デイブが選んだんだと思う。デイブは8ヶ月前に辞めたよ」 「……」 「Kafkaに乗り換えるべきか?」

そして今、すでに評価済みの判断を再評価するのにスプリントを費やしている。組織の知恵はドアの外へ消え去ったのだ。

アーキテクチャ決定記録(ADR)

ADRとは、重要な決定を記録する短いドキュメントのことだ。私のやり方は極めてシンプルだ:

\\

Reader route

article -> proof -> offer

ReadClusterProofScope

cluster

Product Systems

intent

Architecture

route

next step

What to do with this

Turn the note into a build path.

If this topic maps to a real business problem, keep reading the cluster, study the academy path, or route the work into a scoped engagement.

Jason Teixeira
Written by
Jason Teixeira
Founder, Sage Ideas Studio · Principal Engineer
livebuild 5d6c8652026-08-05 06:00Z
// solo studio// no analytics resold// every commit human-reviewed