このブログの記事の読み方
このブログの記事は、私たちが公開中のサービスを作る中で、実際にぶつかったことを題材にしています。「なぜそう作ったのか」を設計判断として書き、クイズに答えながら読み進める作りです。この記事では、その流れと楽しみ方を紹介します。
題材は、公開中のサービスの開発です
テストの書き方、型の置き場所、ビルドの仕組みなど、毎日の実装の中にある小さな判断を扱います。実際に手を動かした中で出てきた、コードや数字をそのまま載せているので、自分の現場に置き換えて読めます。
しかも、題材のサービスは公開されていて、実際に触れます。記事で「こう作った」と書いたものが、どんな画面になっているかを、自分の目で確かめられます。
実際に触れます:Life Atelier
題材の中心は、人生の構造を図にして眺めるサービス、Life Atelier です。年齢を横軸に、出来事(ノード)を並べ、そのつながりから、人生の筋(レーン)が浮かび上がるのを見ます。

【Life Atelier の作品閲覧画面】
中央の横線が、年齢(0〜85歳)の軸です。そこから枝分かれする線(ピアノ、陸上部、せどり、カフェ接客、交際)が、出来事の連なりです。画面の下には、西暦・勤続年数・結婚歴という、3つの参照軸が並び、同じ出来事を別の時間の物差しで読めます。
記事の中で、「この画面の、この部分をこう作った」という話が出てきたら、リンクから開いて、見比べてみてください。
切り口は、設計判断です
設計判断とは、選択肢が2つ以上ある中から1つを選び、別の何かを手放すことです。選ばなかった案にも、ちゃんと良いところがあります。だから、正解は1つに決まりません。どんな条件なら成り立つのかも、一緒に書いています。
動くコードだけを見ても、自分の現場で同じ選択が正しいかは分かりません。何と何を比べ、何を優先し、何を手放したのかが分かれば、自分の条件と照らして、「うちならどうするか」を考えられます。
保守コストは、開発コストと何が違うのか
このブログは、設計判断が良かったかどうかを、保守コストの増え方で見ます。保守コストは、開発コストと並べると、違いがはっきりします。
| 開発コスト | 保守コスト | |
|---|---|---|
| 何に払うか | 作るために | 動かし続け、変更し続けるために |
| いつ払うか | 作るときに、まとめて | 変更するたびに、払い続ける |
| 見積もりやすさ | 見積もりやすい(作る前に概算が出る) | 見えにくい(増えて初めて気づく) |
| 終わりがあるか | リリースで区切りがつく | 実装が残る限り、終わらない |
| 設計判断の影響 | 比較的小さい | 大きい。判断ごとに増え方が変わる |
開発コストは、1回払って終わりです。一方、保守コストは、「変更1回あたりに払う量」×「変更の回数」で、払い続けます。設計判断が左右するのは、主に前者の「1回あたりに払う量」です。
AIがコードを書く時代には、この違いがもっと大きくなります。作る速さ(開発コスト)は下がっても、読む・直す・確かめるために払う量(保守コスト)は、残るからです。AIがコードを読み書きする現場での現れ方は、AI開発の保守コストを、4つの連鎖で説明する理由にまとめています。
記事の流れ
多くの記事は、次の流れで進みます。
- 【経営翻訳】: 現状を、部署や業務のような、身近な会社の話に置き換えます。そのあとに、改善の大きさを4択で予想するクイズが出ます。
- 【保守コスト】: クイズの答え合わせです。数値はコードから数え直せるもので、数え方も書いてあります。変更のたびに払う量が、どう変わったかが分かります。
おすすめの読み方は、経営翻訳の話を読んだら、答えを見る前に、自分で予想してみることです。そのあとで保守コストの節を読むと、自分の見立てと実際のずれが分かって、おもしろくなります。
クイズの画面
経営翻訳の節の最後に、クイズが出てきます。

【回答前のクイズ画面】
「待ちの上限時間(500ms)を変更するとき、書き換えが要る箇所の数: 20箇所」のように、現状の数値が先に示されます。そこから、どれくらい改善できそうかを、4つの選択肢(10%未満/10〜30%/30〜70%/70%以上)から選びます。選ぶまで、「予測を送信」ボタンは押せません。
予測を送信すると、答えが開きます。

【回答後のクイズ画面】
上に正解かどうかが出て、続いて、答えの説明が出ます。いちばん下には、他の読者がどの選択肢を選んだかの割合が並びます。この画像は、手元の環境で1件だけ回答した状態の画面です。そのため、割合は、実際の読者の回答ではありません。実際の記事では、読者みんなの回答が、ここに集計されます。
対応していない過去の記事もあります
すべての記事が、この流れになっているわけではありません。古い記事には、昔の構成のままのものがあります。また、問題にぶつかって解決するまでの経過をそのまま残した、症状・原因・解決策・学びの形の記事には、クイズも保守コストの節もありません。これらは、設計判断の記録ではなく、経験の記録です。
この流れに沿った例は、次の記事で見られます。まずは、クイズに答えるつもりで読んでみてください。