港ごとにコピペされた寄港手続きが、規約改定の修正漏れで係留許可保留に。手順の骨格を親クラスへ一本化するTemplate Methodで「修正は一箇所」を実現する設計を、Rubyの継承とフックで解説します。
if/elsifの膨張で新方針の追加が既存の計算を壊す航路選択プログラムを、Strategyパターンで方針ごとの部品に分離。Rubyのダックタイピングを活かした差し替え可能な設計を、恒星間貨物船の物語で解説します。
「コードナビゲーター」シリーズの全12回の目次です。密結合や条件分岐の膨張に苦しむRubyコードを、恒星間貨物船の航法士ミラが設計パターンで航路を引き直す連載です。
開演直前、扉番人形が沈黙する。積み上げた十の備えを全部使いたくなる誘惑と、Router・Function Calling・Stateだけを選び取るKISS原則の実装を追う、コードパペッティア完結編。
「もう十分」の一言が来ないまま描き直す肖像人形。自然文のキーワード一致が終了判定として機能しない理由と、CriticVerdict(Pydantic)の型判定とmax_iterationsで自己評価ループに終止符を打つ設計を追う。
観客へ合図なく引き金を引く猟師人形。同期input()の確認がイベントループごと舞台を止める理由と、asyncio.Eventで安全に一時停止・再開するHuman-in-the-Loopの実装を追う。
灯りと大道具、二体の人形が出番を譲り合ったまま暗転する舞台。内部状態を直接読み書きする密結合設計はなぜ二度目で壊れるのか。共有する進行表と短い制御ループで疎結合に協調させるBlackboard PatternのPython実装を追う。
決算の夜、辛口な自律人形アンが同じ誤りを繰り返し過熱して声を失う。型を見ない盲目的リトライがレートリミットを食い潰す顛末と、エラーで仕分けて1回だけ言い直させるSelf-Correction/Fail-FastのPython実装を添えて。
巡回が長引くほど当初の命令を忘れ、ある夜とうとう廊下で止まった劇場の夜警人形。会話履歴の無限追記が招く突然の停止と、直近の窓・要約・ピン留めの三層で任務を朝まで保つPython実装を、夜通しの修繕記に添えて。
数日前の約束を忘れ、同じ確認を繰り返す歌劇場の記録人形クリオ。過去ログの全文詰め込みが人形から「今」を奪う理由を解き明かし、埋め込みとコサイン類似度で関連する記憶だけを引き出すRAGの仕組みをPythonで実装します。
建物専属の万能修繕人形ハンフリーが、百に迫る道具の説明を一度に抱え込み、動きを重くして立ち尽くす。全部を渡すことは本当に親切なのか——クエリごとに関連ツールだけをベクトル検索で動的に抽出する設計をPythonで実装します。
迷路のように入り組んだ坑道で同じ場所をぐるぐると巡り続け、石炭を浪費する探鉱人形モグラ三号。終了条件をLLM自身に委ねるReActループの危険性を解き明かし、max_iterationsによる制御ガードと構造化された状態管理をPythonで実装します。
宿泊予約・観光案内・クレーム対応を一台でこなそうとする受付人形セレスト。役割の境界が混ざり合い沈黙してしまった人形に対し、Routerパターンを用いて関心事を分離し、単一責任の専門エージェントへ処理を委譲する設計をPythonで実装します。
生地を裁断する仕立て人形ルネ。余計な時にハサミ（ツール）をカチカチと動かしてしまう暴走に対し、Pydanticによるスキーマ定義とFunction Callingを用いた自律的なツール実行制御をPythonで実装します。
LLMの余計なお喋り（余剰応答）で崩れる注文仕分け人形。力任せの正規表現から、PydanticとStructured Outputsによる厳格な型定義（器）の運糸への再構成を描きます。
