このブログの記事の読み方

著者: ClaudeMix Team |

このブログの記事は、私たちが公開中のサービスを作る中で、実際にぶつかったことを題材にしています。「なぜそう作ったのか」を設計判断として書き、クイズに答えながら読み進める作りです。この記事では、その流れと楽しみ方を紹介します。

題材は、公開中のサービスの開発です

テストの書き方、型の置き場所、ビルドの仕組みなど、毎日の実装の中にある小さな判断を扱います。実際に手を動かした中で出てきた、コードや数字をそのまま載せているので、自分の現場に置き換えて読めます。

しかも、題材のサービスは公開されていて、実際に触れます。記事で「こう作った」と書いたものが、どんな画面になっているかを、自分の目で確かめられます。

実際に触れます:Life Atelier

題材の中心は、人生の構造を図にして眺めるサービス、Life Atelier です。年齢を横軸に、出来事(ノード)を並べ、そのつながりから、人生の筋(レーン)が浮かび上がるのを見ます。

Life Atelier の作品閲覧画面。人生の出来事が、年齢の軸に沿った点と線で並んでいる

【Life Atelier の作品閲覧画面】
中央の横線が、年齢(0〜85歳)の軸です。そこから枝分かれする線(ピアノ、陸上部、せどり、カフェ接客、交際)が、出来事の連なりです。画面の下には、西暦・勤続年数・結婚歴という、3つの参照軸が並び、同じ出来事を別の時間の物差しで読めます。

記事の中で、「この画面の、この部分をこう作った」という話が出てきたら、リンクから開いて、見比べてみてください。

切り口は、設計判断です

設計判断とは、選択肢が2つ以上ある中から1つを選び、別の何かを手放すことです。選ばなかった案にも、ちゃんと良いところがあります。だから、正解は1つに決まりません。どんな条件なら成り立つのかも、一緒に書いています。

動くコードだけを見ても、自分の現場で同じ選択が正しいかは分かりません。何と何を比べ、何を優先し、何を手放したのかが分かれば、自分の条件と照らして、「うちならどうするか」を考えられます。

保守コストは、開発コストと何が違うのか

このブログは、設計判断が良かったかどうかを、保守コストの増え方で見ます。保守コストは、開発コストと並べると、違いがはっきりします。

開発コスト 保守コスト
何に払うか 作るために 動かし続け、変更し続けるために
いつ払うか 作るときに、まとめて 変更するたびに、払い続ける
見積もりやすさ 見積もりやすい(作る前に概算が出る) 見えにくい(増えて初めて気づく)
終わりがあるか リリースで区切りがつく 実装が残る限り、終わらない
設計判断の影響 比較的小さい 大きい。判断ごとに増え方が変わる

開発コストは、1回払って終わりです。一方、保守コストは、「変更1回あたりに払う量」×「変更の回数」で、払い続けます。設計判断が左右するのは、主に前者の「1回あたりに払う量」です。

AIがコードを書く時代には、この違いがもっと大きくなります。作る速さ(開発コスト)は下がっても、読む・直す・確かめるために払う量(保守コスト)は、残るからです。AIがコードを読み書きする現場での現れ方は、AI開発の保守コストを、4つの連鎖で説明する理由にまとめています。

記事の流れ

多くの記事は、次の流れで進みます。

  • 【経営翻訳】: 現状を、部署や業務のような、身近な会社の話に置き換えます。そのあとに、改善の大きさを4択で予想するクイズが出ます。
  • 【保守コスト】: クイズの答え合わせです。数値はコードから数え直せるもので、数え方も書いてあります。変更のたびに払う量が、どう変わったかが分かります。

おすすめの読み方は、経営翻訳の話を読んだら、答えを見る前に、自分で予想してみることです。そのあとで保守コストの節を読むと、自分の見立てと実際のずれが分かって、おもしろくなります。

クイズの画面

経営翻訳の節の最後に、クイズが出てきます。

経営翻訳の節に出てくるクイズの画面。会社の状況の説明、現状の数値、4つの選択肢、予測を送信するボタンが並んでいる

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

予測を送信すると、答えが開きます。

クイズに回答したあとの画面。正解の表示、答えの説明、4つの選択肢ごとの回答の割合が並んでいる

【回答後のクイズ画面】
上に正解かどうかが出て、続いて、答えの説明が出ます。いちばん下には、他の読者がどの選択肢を選んだかの割合が並びます。この画像は、手元の環境で1件だけ回答した状態の画面です。そのため、割合は、実際の読者の回答ではありません。実際の記事では、読者みんなの回答が、ここに集計されます。

対応していない過去の記事もあります

すべての記事が、この流れになっているわけではありません。古い記事には、昔の構成のままのものがあります。また、問題にぶつかって解決するまでの経過をそのまま残した、症状・原因・解決策・学びの形の記事には、クイズも保守コストの節もありません。これらは、設計判断の記録ではなく、経験の記録です。

この流れに沿った例は、次の記事で見られます。まずは、クイズに答えるつもりで読んでみてください。