chore: base イメージに shellcheck を入れる（言語サーバによる Bash の診断に要る）

[takemi-ohama]

何をしたいか

base イメージに shellcheck を入れる。 コンテナの中で Bash スクリプトの静的検査と、言語サーバによる Bash の診断を使えるようにする。

なぜ要るか

• 言語サーバによる Bash の診断は shellcheck に依存する。 bash-language-server は shellcheck を内部で呼んで診断を返す。shellcheck が無いと診断は出ず、エラーも警告も出ないため、動いていないことに気付けない（Claude Code の plugin LSP で、実在しないコマンドを宣言しても何も表示されないことを実測済み。NDF の利用者が Claude Code と Codex で Python / PHP / TypeScript の言語サーバ（定義・参照・診断）を使えるようにする ai-plugins#818 §4）
• NDF の利用者が Claude Code と Codex で Python / PHP / TypeScript の言語サーバ（定義・参照・診断）を使えるようにする ai-plugins#818 で、Claude Code と Codex に言語サーバ（Serena / plugin LSP）を使わせる設計を進める。 対象言語は導入先から検出し、bash も含める。検出された bash を診断できるかは、コンテナに shellcheck があるかで決まる
• Bash の量が多い。 ai-plugins は追跡対象の .sh が 71 個・14,499 行（hook と plugins/ndf/scripts が中心）。区切りや終了コードの思い込みによる不具合が繰り返し出ており、shellcheck が拾える種類が多い
• devbase 自身も CI で shellcheck を使っている（.github/workflows/ci.yml の ShellCheck ジョブ、chore: shellcheck bin/devbase の既存 9 件を片付け、CI の severity を warning へ下げる #247）が、コンテナの中では同じ検査を手元で走らせられない

確かめたこと（2026-09-23）

• devbase のコンテナ（Ubuntu 26.04.1 LTS）で which shellcheck は見つからない
• containers/base/Dockerfile の apt の導入（17 行目・63 行目付近）に shellcheck は無い

案

containers/base/Dockerfile の apt-get install -y --no-install-recommends の一覧に shellcheck を足す。末尾の版の確認（187 行目の RUN ... --version）に shellcheck --version を加える。

受け入れ条件

• base から作ったコンテナで shellcheck --version が終了コード 0 で終わる
• 派生イメージ（general / php など）でも同じく使える

範囲外

• bash-language-server の導入。Serena は自分で入れる。Claude Code の plugin LSP で要るかは NDF の利用者が Claude Code と Codex で Python / PHP / TypeScript の言語サーバ（定義・参照・診断）を使えるようにする ai-plugins#818 の設計で決める
• 既存の指摘の片付け（chore: shellcheck bin/devbase の既存 9 件を片付け、CI の severity を warning へ下げる #247）

進行

モード: standard / 作業ツリー: .worktrees/feature/plan67-shellcheck / 計画: issues/PLAN67_base-shellcheck-impl.md

• 要求と受け入れ条件 — 2026-09-23 14:51
• 作業場所の用意 — 2026-09-23 14:52
• 設計 — 2026-09-23 14:55
• 素材の収集と出典の確定
• ドキュメント再構成 — 2026-09-23 14:56
• ドキュメントレビュー — 2026-09-23 14:57
• 計画 — 2026-09-24 08:02
• 実装 — 2026-09-24 08:03
• 構造改善 — 2026-09-24 08:09
• 実装レビュー — 2026-09-24 08:32
• 完了判定 — 2026-09-24 08:49
• Pull Request — 2026-09-24 08:08
• 確定仕様化 — 2026-09-24 08:50
• 後片付け — 2026-09-24 08:02
• 配布 — 2026-09-24 08:55
• 体裁レビュー
• リリース後テスト — 2026-09-24 09:43
• 振り返り — 2026-09-24 09:51

振り返り: #249 (comment)

[takemi-ohama]

振り返り（2026-09-24）

対象: issue #249 / PR #252（設計 PR #250）

base イメージに shellcheck を入れた。containers/base/Dockerfile の 1 回目の apt-get install の一覧へ足し、版の確認の RUN に shellcheck --version を足して入れ損ないをビルドで止める。派生 7 つ（general / go / php / php85 / bi-tools / latex / trygroup）は Dockerfile を変えずに入る。モードは standard、2026-09-24 09:42 JST に main へマージ（= 本番への配布、マージコミット 676cba5）。版数は上げず [Unreleased] に積んだ。

何が起きたか

観点	事実
受け入れ条件	1〜9 を途中で変えていない
手戻り	構造改善で 1 回。cross-refactoring のテスト整備ラウンドが差分と関係しない既存の命令（Chrome の分岐・npm のグローバル・AWS CLI 等の arch 分岐・bao・agy）の現状固定テストを 4 コミット・約 350 行積み、ループを止めて e379a6c で戻した。実装レビュー（cross-review）は 2 ラウンドで収束し、指摘は minor 1 件（5990a30）
見落とし	無し。リリース後テストで条件 1〜3・6 を main から --no-cache で建て直したイメージで確かめ全件合格。条件 6 は「変更前のイメージ」が要るが、マージ前の検証で devbase-base:latest が既に置き換わっていたため、fd5fa48 の containers/base から建て直して比べた（約 3 分）
範囲	範囲外は実装中に #251（文書の表のベース列）、配布の承認準備で #254（v3.7.0 のタグ・Release）として起票。amd64 は既存の #242 へ追記。bash-language-server は devbasex/ai-plugins#818
工程	体裁レビュー以外をすべて通った（体裁レビューは documentation モードの工程で対象外）。本番の関門は設計 PR のマージと本番への配布の 2 回で、どちらも承認後に進めた

起票の取りこぼし: 無し。quality-gates の「範囲外」（#818・#247・#251・CI・版の固定・lfm/snapshot）はすべて番号を持つか設計で外した非目標。cross-refactoring の「見送った項目」8 件は戻したループの提案で、#249 と関係しない既存の命令の現状固定テストのため起票しない（Dockerfile の文字列を固定するだけで、建てて壊れることは捕まえられない）。

context window の大きさ

層	持ち場	モデル	件数	固定費の中央値	実作業の中央値	実作業 < 固定費	最大充填の最大	印
conductor	-	claude-opus-5-5	1	30828	77297	0	108125
supervisor	設計	claude-opus-5-5	1	31565	200111	0	231676	割る候補
supervisor	実装	claude-opus-5-5	1	31316	107259	0	138575
supervisor	検査	claude-opus-5-5	1	31256	149852	0	181108
supervisor	取り込み	claude-opus-5-5	1	31423	91507	0	122930
supervisor	仕上げ	claude-opus-5-5	1	31561	63967	0	95528
worker	調査	claude-opus-5-5	1	31030	32594	0	63624
worker	修正	claude-opus-5-5	2	31510	24646	1	68947
worker	検証	claude-sonnet-5	1	35323	19008	1	54331

層	件数	固定費の合計	実作業の合計	総消費
conductor	1	30828	77297	108125
supervisor	5	157121	616156	773277
worker	4	129372	100894	230266
合計	10	317321	794347	1111668

持ち場	supervisor	supervisor の実作業	worker の件数	supervisor と worker の固定費の合計	印
設計	1	200111	2	94474
検査	1	149852	2	97719

（仕上げの行は測定の時点までの値。この持ち場はリリース後テストと振り返りを続けた）

• 設計（割る候補）: そのまま。要求・設計・再構成・ドキュメントレビュー・設計 PR の関門までを 1 つの持ち場で通し、最大充填は 23 万で上限まで余裕がある。割ると設計の判断の文脈を引き継ぐ固定費が増える

次に変えること

変えること	落とし先	状態
差分の本番コードがテストから文字列としてしか検査できない宣言（Dockerfile など）だけのときは、cross-refactoring を起動せず refactoring 単独へ退避する条件にする	development-workflow / cross-refactoring の手順（飛ばしてよい条件）	devbasex/ai-plugins#494 へ事例と条件の案を追記（--scope がファイル単位である点は #622 に追記済み）
受け入れ条件に「変更前のイメージと比べる」ものがあるときは、マージ前の検証で latest を建て直す前に変更前のイメージへタグを付けて残す	次の変更で試すこと（devbase のイメージを変える変更の検証手順）	起票しない。起点のコミットから建て直せば約 3 分で同じ比較ができ、今回もそうした。手順として固定するほどの損失が無い

途中で起票した課題

番号	何を見つけたか	見つけた場面
#251	container-operations.md の「イメージの詳細」の表のベース列が実際の FROM と違う	実装中
#254	v3.7.0 のタグと GitHub Release が無い（CHANGELOG の compare リンクが 404）	配布の承認準備
#242（追記）	amd64 での shellcheck の確認を持ち越し	配布の承認準備