Rubyパッケージ：設定から探索パスを追う

職務経歴書の8エピソード一覧から、今回は一つだけ選ぶ。同じページの他の経験には広げず、関連知識の補強もこのエピソードに沿って行う。

セッション：Rubyパッケージの不具合調査・サービスチームとの連携

正常版比較と探索パスの解析、回避策検証、再現手順と根拠を添えたサービスチームへのエスカレーション。英語での連携も振り返る。

ChatGPT開始文：Rubyパッケージの不具合調査・サービスチームとの連携

https://github.com/MFQWKMR4/tech2026 のAGENTS.md、CHATGPT.md、
src/content/docs/projects/ruby-packaging-investigation.md、reviews/experience-ruby-packaging.yaml、
src/content/docs/career/interview-tips.md、.github/ISSUE_TEMPLATE/session-sync.md、reviewが参照する必要な過去sessionを読んでください。
読めた資料とcommit SHAを示し、読めない場合は読んだとせずsession packを求めてください。
今回はtopic: experience-ruby-packaging、session_type: experienceです。
選択エピソード：Rubyパッケージの不具合調査・サービスチームとの連携。1エピソード1セッションとし、他の開始文は実行しないでください。
対象：正常版比較と探索パスの解析、回避策検証、再現手順と根拠を添えたサービスチームへのエスカレーション。英語での連携も振り返る。
既存needs_revisitのうち今回の話に関係するものを優先し、無関係な項目は次回に残してください。
なければ最初の一問は「顧客環境固有の問題かパッケージ側の問題かを、何を比較して切り分けましたか。」。一度に一問だけ尋ね、回答を待ってください。
当時の課題・観測→自分の担当と行動→判断理由と代案→検証・結果を、回答に応じて思い出す手助けをしてください。
覚えていない事実はunknownで止め、今知りたい仕組みを一つ選んで学び直してください。
技術補強の候補：Rubyのライブラリ探索とビルド時設定、パッケージ配置、暫定回避策と恒久対応、再現条件を絞った不具合報告。
前提知識を短く説明し、一次資料のURLと対象バージョンを示してから、条件を一つ変えた問いで理解を確かめてください。
注意：私の調査・英語での連携と、サービスチームによる修正を分けてください。非公開のやり取りを転載せず、修正版の出荷や効果は確認できる範囲だけ扱ってください。
当時の経験、今の学び、AIの補足・演習条件を分け、経験・成果・不足を推測で補完しないでください。
会社名・顧客情報・非公開情報・職務経歴書の連絡先は教材や同期Issueへ転載しないでください。
最後に私自身がこのエピソードを短く説明し、根拠のある担当・判断・結果と、まだ確認が必要な点を整理します。模範回答を先に出さないでください。
開始時刻が分かれば記録し、40分付近で区切りを提案。時刻不明なら経過を推測しないでください。
終了時は既存形式の[Session Sync]（YAML＋Session narrative）を作成し、summaryとnarrativeに選択エピソード名、実際の回答・ヒント、当時の経験と今の学びを残してください。
フィードバックではtipsから今回に関係する観点を選び、実際の回答を根拠に伝わった点・説明を補う点・未確認を分け、narrativeに残してください。全問の消化は目標にしません。
repository_requestsにはこのprojectページへ戻す想起内容・技術解説を指定し、別エピソードの記録を上書きしないでください。
Issueを作成できなければ未作成と明示し、コピーできるタイトルと本文を返してください。

GitHubを読めない場合は npm run session:pack -- experience-ruby-packaging の出力を渡す。パック内に複数の開始文があっても、選択した一件だけを扱う。

このページの使い方

当時の判断を思い出すことを入口に、今の自分の知識を更新する。思い出せない事実はunknownのまま、必要な仕組みを学び直してよい。 対話はChatGPT、編集と同期はCodexで行う。ケース一覧から別のケースも選べる。

2026-09-14、Issue #16としてObsidianの Untitled. 3 から整理した初稿。元ノートの要約であり、全ログ・コードの独立確認や今回の再実験ではない。実際の学習sessionはまだない。原文の観測と解釈、AIによる補足を分ける。

本人の経験：元ノートにあること

問題と調査の経緯

AL2023のRuby 3.4関連パッケージで、コマンドのリンクが作られない問題と、Gem::GemNotFoundExceptionが発生する問題を調べた。ノートはRuby 3.2との比較、探索パスの計算、回避策の検証を記録している。

段階	ノートの観測・行動	解釈・残る確認
起動できる状態を作る	alternativesを手動登録するとリンクはできたがgemの例外が残る	コマンドへの到達と、実行後のライブラリ探索を分離した
探索先と実物を照合	Gem.pathが示す場所とgemspecの配置が不一致。GEM_PATH指定でbundlerが動く	この条件の探索パスが原因候補。すべてのgemの正常動作は意味しない
正常版と比較	Ruby 3.2/3.4のRbConfigとディストリビューション側のパス計算コードを比較	RUBY_INSTALL_NAMEのsuffix差とvendordirの要素不一致を追った。元のRPM/build成果物は今回未取得
提案を再検証	RbConfig修正だけでは探索先と実物がなお不一致。追加のsymlinkで動作と記録	一部修正だけでは十分でないことを示した。全回帰試験の範囲はunknown
回避策を比較	gem install、設定変更＋symlink、GEM_PATH指定を比較。GEM_PATHだけでは別gemの拡張が動かない	一つのversionコマンドの成功で回避策全体を完成扱いしなかった

結果と未確認事項

ノートでは再現手順・設定差・計算過程を整理し、担当先へ情報を渡した。修正版の予定について記録があるが、これは当時の記述であり、現在の公開リリース状況や適用結果はunknown。非公開のやり取りや未確認の修正予定を教材の事実として転載しない。本人がどこまで調査を担当したかは対話で確認する。

AIによる技術補足：今の理解を更新する

Default / Why：どのプログラムが、どこを探すか

shellがコマンドを見つけるPATHと、RubyGemsがgemを探すGEM_PATHは別。コマンドが存在しても、使うRubyとgemのインストール先が合わなければ動かない。GEM_HOMEは主なインストール先、GEM_PATHは複数のgem探索先を指定するための設定として区別する。RubyGems gem environment。

RbConfigにはRubyのビルド時の構成が残る。元ノートのコード解析は、入力の構成値 → パス計算 → 実際のファイル配置を順に照合した点に価値がある。ディストリビューション固有の計算ロジックをRuby一般の仕様と混同しない。Ruby 3.4 RbConfig。

Trade-off / Exception：動いた回避策をどう戻すか

環境変数で動けば変更箇所は小さいが、serviceの起動環境にも伝わるかを確認する。設定ファイルやsymlinkの修正は広い探索へ影響し、RPM更新による上書きや残存物の管理が必要になる。gem installはRPMとは別の配置・更新経路になり得る。

原文の「dnf updateでRPM版に戻す」は、それだけで手動導入物が消えることを保証しない。/usr/local/bin 等に残ったコマンドが引き続き優先される可能性がある。適用した差分と削除・復帰条件を記録し、修正版導入後に実行ファイルと探索先を再確認する。

Production / Troubleshooting：確認を何段階に分けるか

今なら行う確認の案：コマンドの実体、Rubyの実体と版、Gem.path、gemspecの配置、native extensionのロード、実アプリの起動を順に確認する。これは当時の検証実績ではない。bundlerのversion表示成功と、別gemを含むアプリ全体の動作成功を分ける。

恒久対応では、設定を手で直すだけでなく、パッケージの導入後テストで実行ファイル・探索パス・拡張のロードを確認する案がある。テスト対象を増やすコストと、利用者環境の全組合せは網羅できない限界もある。ソフトウェアテストと接続する。

次の対話：当時から今へ

• 当時：どの差分に気づいてコードを読み始め、入力値と出力をどう追ったか。
• 仕組み：コマンド探索とライブラリ探索の違いを、Ruby以外の環境でも説明できるか。
• 今なら：回避策を採用する前に、適用範囲と撤去方法をどう確認するか。
• 設計判断：修正版を待つ間の回避と、保守可能な恒久対応をどう分けるか。

経験の核は、正常系との差分をコード上の計算へ結び付け、提案された修正も自分で確かめたこと。未公開の修正情報や未観測の成果を面接用の経験へ足さない。

出典・対象環境

元ノート：AL2023 / Ruby 3.2・3.4比較。正確なRPM release・RubyGems版はunknown。一次資料は2026-09-14確認のRuby 3.4 RbConfigとRubyGemsの現行ガイド。特定RPMのバグの現在の状態を検証したものではない。今回のパッケージ導入・修正は未実施。

セッションと次の更新

元資料の参照は2026-09-14。原文は変更せず、顧客情報・内部情報を転載していない。本人の独力回答や深掘りsessionは未登録。質問候補と補足は学習済みの証拠ではない。ChatGPTのSession Sync後に、当時の経緯と今の理解の変化を区別して追記する。