派手に壊れてくれるバグより、音もなく紛れ込むバグのほうがずっと怖い——今週は、その感覚を立て続けに味わった一週間でした。
2014年からアプリの個人開発を続けてきて、いまは複数のサイトとアプリを一人で回しています。運用が長くなるほど、トラブルの形は「クラッシュして止まる」から「止まらないのに何かがおかしい」へと変わっていきました。今週公開した記事も、磨き直した記事も、振り返ってみるとすべて「静かに混入するもの・静かに溜まるもの」をどう断つか、という一本の線でつながっていたように思います。
前回の中身が今回に紛れ込む — 固定名一時ファイルの怖さ
今週いちばん背筋が冷えたのは、この記事の題材になった事故でした。
前回の記事本文が別の記事に紛れ込む — 固定名の一時ファイルに残る残骸の罠 は、バッチ処理が /tmp の固定名ファイルを使い回していたせいで、書き込みが無言で失敗した回に「前回の中身」がそのまま次の成果物へ流れ込んだ、という実体験を書いたものです。
恐ろしいのは、エラーが一切出ていなかったことです。ログの上ではすべて成功。それなのに出力だけが静かに汚染されている。この型の事故は、気づくまでの時間がどうしても長くなります。対策そのものは地味で、一時ファイルにスラッグ入りのユニーク名を使うこと、そして挿入後に grep で「入っているはずのもの」を照合すること。Claude Code に「この処理が失敗しても気づけない箇所はどこですか」と問いかけながら設計を見直したことで、同じ型の事故を仕組みごと塞げました。検証は失敗を見つけるためではなく、成功を証明するために書くものなのだと、身をもって学び直した一本です。
git add -A が .bak まで連れてくる
二本目も、自動化と Git の境界線で起きた話です。
git add -A が .bak バックアップまで巻き込む — in-place 修正スクリプトと自動コミットの落とし穴 は、設定ファイルを in-place で書き換える修正スクリプトが残した .bak ファイルを、後続の git add -A が拾い上げ、複数のリポジトリへそのままコミットしてしまった記録です。
git add -A は便利な反面、「いま作業ツリーにあるものは全部コミットしてよい」という暗黙の前提を抱えています。人間が手で作業しているときは成り立つ前提でも、スクリプトが副産物を残す自動化の文脈では崩れる。修正ファイルを add 対象として明示的に列挙するか、push 前に副産物を掃除する一手を挟むか。どちらにしても「何をコミットするか」を暗黙にしない、という結論に落ち着きました。リポジトリを汚してから気づくより、コミット対象を一行多く書くほうがずっと安い、というのが今週の偽らざる実感です。
ENOSPC は「容量を空ける」ではなく「溜まらない構造にする」
磨き直しの一本目は、ディスク容量の話です。
Claude Code の ENOSPC エラーを根本から片付ける は、以前から公開していた記事を、実際に自分の自動化環境が ENOSPC で停止した経験をもとに書き直したものです。原因は node_modules の膨張という、わかってしまえば何でもないものでした。ただ、当時の私は復旧を急ぐあまり、空き容量を作っては npm install をやり直す、という悪手を繰り返していました。
書き直した記事の軸は「その場で空ける」から「溜まらない構造にする」への転換です。空き容量がしきい値を割ったら使っていないリポジトリやキャッシュを順に解放する、インストールをそもそもパイプラインから外せないか考える。祖父たちが大工仕事で道具場を「散らかったら片付ける」のではなく「散らからない置き方」にしていたことを、ふと思い出しながら書きました。
「待つべきか、直すべきか」を最初に見分ける
磨き直しの二本目は、Claude が応答しなくなったときの切り分けです。
Claude が応答しない・止まるとき — 原因の見分け方と、すぐ効く対処 は、対処法の羅列だった旧版を、診断ファーストの構成に組み替えました。ブラウザやアプリ側の問題なのか、API 側の問題なのか。待てば直るのか、リロードすべきなのか、コードを直すべきなのか。判断の入口を最初に置いただけで、記事としての使い勝手が大きく変わったと感じています。夜間バッチで 429 に遭遇してから指数バックオフを入れ、手動の再実行が消えた、という自分の運用の変化もそのまま書き込みました。
あわせて、はじめてのClaude — 登録から最初の会話まで 10分チュートリアル も全面的に手を入れました。初心者の方が最初につまずくのは操作ではなく、「検索のように単語を投げてしまう」ことです。検索ではなく依頼として話しかける、という一点を軸に書き直しています。入門記事こそ、書き手の実感が試されるのだと改めて感じました。
来週に向けて
今週の記事はどれも、「失敗しても気づけない箇所」を一つずつ潰していく作業の記録でした。もしご自身の自動化スクリプトをお持ちなら、その中で「ここが無言で失敗したら気づけないな」という箇所を一つだけ探して、検証を一行足してみてください。私の場合、その一行が後から何度も自分を救ってくれています。
最後までお読みいただき、ありがとうございました。同じように小さな運用を積み重ねている方の参考になれば嬉しいです。