座標が生の Float ペア、燃料量が裸の Float で持ち回られ、単位取り違えも座標系混同も「数値としては通ってしまう」静かな事故になっていた。半年前の 0.3 光秒到着ズレ near-miss の航海日誌を読み返し、応急処置が結果は直したが根の位置は値そのものだったと気づく。値そのものを不変の小さなクラスにくるむ Value Object パターンで引き直します。Ruby 3.2+ の `Data.define` で座標系識別子と単位を型に閉じ込め、生成時 raise と演算時 raise の 2 系統で混在を弾き、`Struct` との使い分けまでを Minitest で解説します。
外周センサーの一部が欠測しているだけで、集計側には `if sensor.nil?` の見張りが六箇所並び、一箇所書き忘れれば深宇宙で `NoMethodError` が鳴る予告になっていた。呼び出し側の nil チェックを消すために、本物と同じインターフェースを持つ「何もしない」実装 NullSensor を用意する Null Object パターンで引き直します。ダックタイピングと組み合わせて集計側の分岐を消し、`&.`（safe navigation）との役割分担、そして「隠していい nil / 隠してはいけない nil」の線引きまでを Ruby と Minitest で解説します。
出航前点検の手順書は「点検を1回呼ぶ」と1行なのに、実コードのブリッジ側では四系統の呼び出しが11手続き分並び、同じ11手続きが7箇所に散らばっていた。下位の内部順序が変わるたびに7箇所全部を直す羽目になる旧設計を、一枚の窓口 PreflightCheck に段取りを集約する Facade パターンで引き直します。Rubyのキーワード引数のデフォルト値による依存注入で、既定の入口を提供しつつ下位への直接アクセス余地を残す実装を解説します。
操舵訓練の一手をキーストロークで打ち間違えたとき、既に実行した yaw と thrust を戻す手段がコードに無く、日誌には "yaw変更" とだけ残っていた。動作をオブジェクトに引き上げ、実行と戻し方の両方をそのオブジェクトが持つ Command パターンを、Rubyの兄弟クラス群と履歴スタックで解説します。
接舷シーケンスの状態を文字列フラグと巨大case文で回した旧設計が、書き漏らしから「許されない遷移」を通してしまう。状態そのものをクラスに引き上げ、書けない場所を作って構造的に防ぐStateパターンを、Rubyのシンボルとダックタイピングで解説します。
積荷の保冷・防振・保険という3オプションを組み合わせごとのサブクラスで表現し、クラス数が指数的に増殖した旧設計を、Decoratorパターンで独立したラッパークラスの重ね掛けに引き直します。Rubyの継承と合成（is-a/has-a）の使い分けを解説します。
港ごとに通信規格が違う管制システムへの対応で、交信コード本体がcase分岐で方言を吸収し港が増えるたび本体を開ける旧設計を、Adapterパターンで港ごとの通訳に隔離。Rubyの委譲とダックタイピングの協調を解説します。
探査プローブの生成case文が通常発進と緊急再発進の2箇所に散在し、新型追加のたび修正が連鎖する旧設計を、Factory Methodで生成専用の窓口に隔離。クラスもオブジェクトというRubyの特性を登録簿に活かす手順を解説します。
船外センサーが通知先を直接呼び出す密結合で、新設区画だけ警報が届かない事故に。購読者の名簿へ一斉通知するObserverパターンで、通知先の増減がセンサー無改変になる設計をRubyで解説します。
港ごとにコピペされた寄港手続きが、規約改定の修正漏れで係留許可保留に。手順の骨格を親クラスへ一本化するTemplate Methodで「修正は一箇所」を実現する設計を、Rubyの継承とフックで解説します。
if/elsifの膨張で新方針の追加が既存の計算を壊す航路選択プログラムを、Strategyパターンで方針ごとの部品に分離。Rubyのダックタイピングを活かした差し替え可能な設計を、恒星間貨物船の物語で解説します。
開演直前、扉番人形が沈黙する。積み上げた十の備えを全部使いたくなる誘惑と、Router・Function Calling・Stateだけを選び取るKISS原則の実装を追う、コードパペッティア完結編。
「もう十分」の一言が来ないまま描き直す肖像人形。自然文のキーワード一致が終了判定として機能しない理由と、CriticVerdict(Pydantic)の型判定とmax_iterationsで自己評価ループに終止符を打つ設計を追う。
観客へ合図なく引き金を引く猟師人形。同期input()の確認がイベントループごと舞台を止める理由と、asyncio.Eventで安全に一時停止・再開するHuman-in-the-Loopの実装を追う。
灯りと大道具、二体の人形が出番を譲り合ったまま暗転する舞台。内部状態を直接読み書きする密結合設計はなぜ二度目で壊れるのか。共有する進行表と短い制御ループで疎結合に協調させるBlackboard PatternのPython実装を追う。
