ADRを書くときに抑えておくべきポイント
2026年1月9日ADR（Architecture Decision Record）は、ソフトウェアアーキテクチャに関する重要な意思決定を記録するためのドキュメントである。 ADRを書く内容が決まっていても実際書いてみると人によって内容がバラついたり、そもそも何を書けば良いのか分からなかったりして、形骸化してしまうことがある。 私の経験上大事だと思うことを4つにまとめた。 1：意思決定を一つに絞る（Atomicit...
ADR（Architecture Decision Record）は、ソフトウェアアーキテクチャに関する重要な意思決定を記録するためのドキュメントである。 ADRを書く内容が決まっていても実際書いてみると人によって内容がバラついたり、そもそも何を書けば良いのか分からなかったりして、形骸化してしまうことがある。 私の経験上大事だと思うことを4つにまとめた。 1：意思決定を一つに絞る（Atomicit...
チームトポロジーとは何か？ チームトポロジーとは「ビジネス価値のフロー（流れ）を最大化するための、適応型の組織設計モデル」である。 従来の組織設計（階層型組織図）と決定的に異なるのは、以下の点を最優先することである。 静的な「ヒエラルキー」ではなく、動的な「フロー」を重視する 「人間の認知負荷（Cognitive Load）」を設計の制約条件とする ソフトウェアアーキテクチャと組織構造をセットで...
ソフトウェア開発において「技術的に正しいか」を議論することは重要である。しかし、それだけでは不十分である。技術的な正解というものは、技術のトレンドや実行環境、あるいはビジネスフェーズの変化によって容易に変容するからである。 論理が整っていることは大前提だが、変化の激しい開発現場において、チームが一貫性のある評価軸を持ち続けるためには、拠り所となる「価値観」が必要不可欠である。 開発チームにおけるM...
Web配信の技術―HTTPキャッシュ・リバースプロキシ・CDNを活用するを読んだ。 Webのコンテンツ配信におけるキャッシュについて網羅的に書かれている。キャッシュ最適化を考える際に手元に置いておきたい。 ...
2025年の振り返りと来年の抱負 今年も1年を振り返り、来年の抱負を記す。振り返りブログを書き始めて今回で8回目になる。 2024年の振り返りと来年の抱負 2023年の振り返りと来年の抱負 2022年の振り返りと来年の抱負 2021年の振り返りと来年の抱負 2020年の振り返りと来年の抱負 2019年の振り返りと来年の抱負 2018年の振り返りと2019年の目標 プライベート 設計に関すること...
ソフトウェア設計の結合バランス 持続可能な成長を支えるモジュール化の原則を読んだ。 この本は結合をテーマにした珍しい本で、アーキテクチャ設計の複雑性をどう管理するかを理論的に学べる本。 複雑性をどう管理するかはアーキテクチャの寿命を決めるようなものだと思っているが、そのための分析観点として結合について深く学ぶことができる。 一回読んだだけでは頭に入り切らなかったので、設計するときなど辞書的に参照で...
問いのデザイン: 創造的対話のファシリテーションを読んだ。 問いをデザインする、つまり問いをどのように立てるか、考えるかということを考える本。 アイデアの源泉や問題解決の本質は全て問いにあると思っており、問いの質がそのまま成果の質に繋がっていると日々感じている。 イノベーションというのは問いから始まるのだということを感じされて、創造性を刺激される本でもある。 問いをデザインするだけではなく、問いを...
目的ドリブンの思考法を読んだ。 この本は目的・目標・手段のフレームワークで、仕事の成果をどう創出していくか語っている本。 個人的に前半の話は結構退屈してしまったのが、後半部分から真髄のようなものを感じて面白かった。 方針、実行、成果の3要素は戦略に依存しており、戦略の源泉は企業の文化、行動様式である 薄利多売が良いか悪いかといった答えのない問題は、組織に所属するメンバーが何をしたいかすべきか...
具体と抽象 ―世界が変わって見える知性のしくみを読んだ。 抽象的な思考の大事さについて語れている本。 この本は、具体と抽象のそれぞれの考え方の対比について主に焦点を当てている。 抽象が分からない人に向けたメッセージを感じる部分が多い。 「大抵の人は、このことを体系的に学ばずに一生を終えてしまうのです」という一文を見てはっとした。 学業の中では抽象について学ぶような機会は少なかったように思う。社会に...