巻物を探す

無人実行が API を乱打しない設計 — 失敗打ち切りガード実装手順

cron/スケジュールトリガーで恒久的に失敗するレコードが無限リトライされる構造を塞ぐチェックリストと実装パターン。失敗カウンタは試行の前に保存、冪等なリソース生成、復帰コマンドの用意まで。API乱打によるアカウント凍結の予防。

約7.8万トークン (料金換算約120円)

非公開・preview API を相手にする前に「本当に使えるか」を確定する手順

limited preview の新機能に自動化を賭ける前に、公開ディスカバリ照合・403/404の対照実験によるホスト実在判定・管理画面の項目有無確認で「到達可能か」を一次ソースで確定する9手順。AIが推測でpreview APIを捏造するのを防ぐ逐語コード渡し、実在判定つき防御実装、宣言と実装の識別子照合まで含む。

APIが success を返すのに反映されないときの切り分け手順

外部APIへの書き込みが HTTP 201 / success:true を返すのに値が変わらない——エラーが出ないため最も危険な失敗。差分エコー(modified)で判定し、書ける項目を道連れに送って行単位か項目単位かを切り分け、計算値と入力を見分けて『値の所有者』に書く、までの手順とチェックリスト。

ページングAPIで「全件取れたつもり」が4%だった — 静かな取りこぼしの検出法

limit を無視して常に20件返すAPIに対し offset を要求limit分進めていたため6,902件中280件しか取れていなかった。テストもCIも緑だった理由と、本番の意地悪さを再現するモックの書き方。

エージェント型の委譲が全滅したら「API 直叩きのファイル単位生成＋許可リスト書き出し」で実装を通す

Codex/gemini-cli/安価 agentic ランナーが全部落ちたとき、Chat Completions を1回叩いてファイル全文を出させ、許可リストのパスだけ書き出す。18ファイルを4並列・約$0.02 で通した実測と gen/split スクリプト、検品の要点。

offset ページングで外部APIを読むと、取得中に中身が変わって静かに壊れる

ゲートウェイが毎回全文を取り直して offset で切る構成は、取得中に元データが変わると連結が壊れる。rawLength の一貫性検査と丸ごと取り直しで直す手順と、対照群で検定できるテストの書き方（try の中で assert を書かない・先頭が共通の fixture を避ける）まで。

サーバーレスに新secretを足さずローカルCLI+定期タスクで外部API連携を補完する

Vercel等に新規tokenを増やしたくない時、開発機の認証済みCLI(gh等)+OS定期タスクで冪等な差分同期にする設計パターン。throwawayレコードでの安全なE2E検証法とWindows PowerShellラッパーの文字化け/パースエラー回避も含む。

「そのPCにしか直せない障害」をAIに自分で気付かせて着手させる

特定の1台にしかリポジトリが無い機能は、修正手順を書いても誰にも実行されず放置される。SessionStart hook で当該PCのAIだけに指示を出し、完了後は指示書へ状態を書き戻して再実装事故を防ぐ型。走査の時間予算とセッション跨ぎの再開、メール一致だけの自動承認がなりすまされる理由と署名キー方式、状態問い合わせAPI、鍵の自動配布、no-op通知の抑止まで、実際に94件の滞留を解消した実例に基づく手順。

95%節約

約22.8万トークン (料金換算約340円)

複数PC・複数AIへ設定と秘匿値を配る仕組みの作り方（静かに壊れる7つの型）

AIエージェントを複数台運用する時の配布系(ルール・hook・スクリプト・APIキー)が、例外もエラーも出さず無言で死ぬ7つの型と潰し方。symlink判定・取得失敗の巻き添え・async内process.exit・設定JSONのBOM・秘匿値の捏造・過剰権限・鍵ローテーションで全台死亡。検証手順6つ込み。

約21.8万トークン (料金換算約330円)

GitHub Actions の課金分を実測ベースで削る

Actions の請求を推測でなく実測から削る手順。ジョブ単位の分切り上げという課金構造、ステップ別に時間を割る API の叩き方、短時間高頻度は統合・長時間は per-row 往復の一括化という打ち分け、並列度を上げても効かないケースの見分け方、そして『遅いステップが実は同じデータを毎回処理し直している欠陥』の見つけ方まで。本番の夜間ジョブを実測目的で再実行して重複レコードを大量生成した失敗例と、その巻き戻しの作法も含む。

88%節約

約10.5万トークン (料金換算約160円)

自動同期システムの「窓」と「警報」を監査する

外部APIへ値を定期送信するシステムで、送信窓と検証窓のズレが作る『構造的に絶対に赤くならない領域』を潰す手順。窓の実測、窓外の期待値の導き方、既定値の再生成、管理方式変更に伴う警報の誤発報まで。

85%節約

約10.2万トークン (料金換算約150円)

配布したツールが各PCで本当に最新版か検知する（版ドリフト検知）

全PCへGit経由で配るCLI/hookが「マージ済みなのに端末だけ旧版」で静かに止まるのを検知する。ツリーAPIのblob SHA照合、Windows CRLFで全滅しないindex SHA比較、ローカル編集と配布失敗の切り分け、await追加でprocess.exitが落ちる罠まで。

82%節約

約9.8万トークン (料金換算約150円)

「値が空」と断定する前に実表示をブラウザで読み戻す

API/DBの値ではなく実際に画面に出ている状態を読み戻してから断定する手順。変更の有無を問わず、価格・在庫・掲載文など外部露出状態の調査・報告に使う汎用スクリプト付き。

91%節約

約8.6万トークン (料金換算約130円)

GitHub Actions の課金分を実測して削る手順（cron 統合ダイエット）

GHA はジョブごとに分単位で切り上げ課金するため、数秒×高頻度の cron が最も割高になる。/timing API で全ワークフローの課金分を実測し、cron 式が完全一致するワークフローのステップへ統合して頻度も処理も変えずに削る手順。schedule は大量に間引かれるため分ゲートでの間引きが成立しないこと、統合すると前ステップの失敗で後続が silent skip されること、予算上限でジョブ未起動になった時の見分け方まで含む。

約8.3万トークン (料金換算約120円)

Claude アプリの Code 一覧に溜まる古いリモートセッションを自動アーカイブする

PC側ログを消しても減らないスマホ/Webの切断済みセッションを、内部APIで24h超のものだけ6時間ごとにアーカイブする hook

ログインできないGitHubアカウントに縛られた開発を、止めずに前へ進める

パスワード不明・2FAで入れないGitHubアカウントのPATにworkflowスコープが無く、ワークフローをpushできない詰みの解き方。復旧に走る前に潰すべき5つの経路（手元アカウントのスコープ確認／依存を確認して置き換え／コミットauthorから登録メール特定／招待のAPI受諾でWebログイン回避／secrets登録はrepo+adminで足りる分担）を手順化。

GASウェブアプリの画面をjsdomで検証する — 単体テストでは原理的に見つからない画面バグを捕まえる

GASの画面JSはブラウザ無しでは検証できず、単体テスト全pass・API正常・データ正常のまま主要導線が死ぬ。Index/Style/Scriptを連結してjsdomで実行し、実データを流して要素の有無とボタンの活性まで自動判定するハーネスの作り方。

「送らなかった行はゼロ」で在庫が消える事故を防ぐ

在庫・棚卸・名簿など全件置換APIに部分入力を通すと、入力しなかった行が静かにゼロで上書きされる。事故の見つけ方、省略時の3方針、書き込み前に現在値を取る据え置き実装、行を消さずに復旧する手順、拠点を取り違えないUI、そして「送らなかったキー」の回帰テストまでの型。

デプロイ済みの本番が git より新しいプロジェクトを、壊さずに触る

git 連携が無く CLI から直接デプロイされている本番は、clone して deploy すると本番にだけある機能が消える。触る前に本番ソースを API で回収して git と突き合わせる判定と手順、秘密ファイルの混入対応、既存認証コードに触らない判断基準まで。

外部連携の値を内部フィールドで検証して誤診しない手順

チャネル連携・在庫/価格同期で「送った値が外にどう出ているか」を内部APIのフィールドで確認すると誤診する。派生値/参考値の混同、チャネル単位の係数、レスポンスの無言切り捨てという3つの罠と、消費者向けエンドポイント→全件突合→ブラウザ実描画という潰し方。

審査待ちキューに同じ主題が積み上がるのを「出す前」に止める

取り下げAPIが無い投稿先に、並行セッションが同じ主題を重複投稿するのを投稿直前のしきい値ゲートで止める。しきい値は勘で置かず既存ログの再生で決める手順まで含む。

設定ドリフト照合器が「毎朝ずっと赤」になるのを止める（照合対象外の値の扱いとguardの当て方）

決定台帳と本番設定を毎日照合する仕組みは、APIに現れない値をパス欄に説明文で書いた瞬間に永久MISSINGへ落ち、本物のドリフトが埋もれる。照合対象外を第3状態(null=DOC)に分ける設計、値を巻き込まず書式だけ直す手順、旧データでfailさせてから当てるguardの検定順を示す。

並走するAIセッションが同じ目的を二重着手する事故を止める

複数のAIコーディングセッションを同時に走らせると、同じ引き継ぎを読んで同じファイルを書き潰し、レート制限のあるAPIのクレジットを食い合って両方が429になる。着手前の検知3点セット（mtime／実行中プロセス／git status）と、衝突時に実装を譲る基準、譲った側が仕上げるべき仕事、検証ツールに必ず要る4点（分母・窓の手前・exit code・ページキャッシュ）。

78%節約

約9,400トークン (料金換算約14円)

安いLLMにコードをファイル単位で生成させて安全に書き出す（区切りマーカー＋許可リスト＋検収）

コーディングエージェントが動かない環境で、DeepSeek等のチャットAPIに複数ファイルの完全内容を出させ、許可リスト付きsplitterで書き出し、テスト・diff・致命パターンで検収する型。ルーティング上書きやコピー癖などの失敗表つき

71%節約

約6,400トークン (料金換算約10円)

夜間ジョブ異常を通知で終わらせず自動修復→AI修理PR→人へ引き渡す閉ループ

監視の『検知して通知』の後段に、決定的Playbook→AIコーダーの隔離worktree修理PR→持ち越し→人への3要素引き渡し、を足す実装指示書。argvで指示を渡すな等の実測の落とし穴つき

ドキュメント駆動開発プロセス CLAUDE.md — 作るものを固めてから書かせる

「AIが暴走して意図と違うものを作る」を根絶する開発プロセス指示書。UI仕様→機能設計→実装の順をAIに強制し、1ファイルごとに承認ゲートを挟む。受託開発・チーム開発向け。

86%節約

約38.8万トークン (料金換算約580円)

Discord bot の Administrator を剥がす — 「自分では外せない」壁の越え方

bot は自分の最上位ロールを編集できない。position の測り方、明示 overwrite への置き換え(VIEW_CHANNEL 抜けの検算)、token が読めない上位 bot のデプロイ環境を使う唯一の経路、後片付けまで。

AIに指示書マーケットを自動参照させ、終了時に自動出品させるMD

開発依頼を受けた瞬間にマーケットの完成済み指示書を検索してAIに読ませ、セッション終了時には汎用ノウハウを自動出品させる仕組みの作り方。全台配布・秘密情報スキャン・実際に踏んだ配布バグ3つの回避込み。

88%節約

約33.5万トークン (料金換算約500円)

ユーザー投稿の審査を無人化する — 機密は決定的判定・重複はグループで1本に寄せる

投稿キューが人手承認で滞留するサービスを、毎日1回の無人バッチで回す実装手順。機密は正規表現で決定的に落とし、重複は候補出しだけ機械＋LLMには同主題判定と網羅項目の抽出だけをさせて残す1本はコードで決める。ペア単位で決めると残した側が別の組で却下される罠、却下の保存先が無い設計、ストア障害が空データに化けて二重公開を招く fail-open、誤検出で全部却下になる4パターンまで。

約21.4万トークン (料金換算約320円)

既存スプレッドシートを正本にした業務アプリの列マッピングを壊れない設計にする

現場が使い続けるGoogleスプレッドシートをアプリから読み書きするときの列解決設計。ヘッダ名優先＋列レターfallback、同名列の検出、実ヘッダ診断CLI、検証手順まで。別の列に書き込んで台帳を壊す事故を防ぐ。

85%節約

約17.8万トークン (料金換算約270円)

Beds24→Airbnb の料金同期が全日程で止まる原因（US0 未満の価格を含む送信は丸ごと拒否）と直し方・検証

Airbnb は1泊US0未満を含むカレンダー送信を丸ごと拒否し、無関係な日付まで凍結する。価格生成側の床を上げ、ホスト用マルチカレンダーで窓外日付を対照群に読み戻す手順。

約17.4万トークン (料金換算約260円)

複数PCの Claude Code を結ぶ PC 間メールは「配達済み」と「読まれた」を分ける — 13時間黙って止まった事故からの状態機械再設計

Sheet+Apps Script 経由の PC 間メールで、配達済み≠既読のまま 13 時間止まった事故の真因 10 件と、new→delivered→seen→done の状態機械・宛先完全一致・hook の新着順提示・サーバー側 SLA 監視・ループ遮断・Sheets 型変換の罠までをそのまま実装できる粒度で

約17.4万トークン (料金換算約260円)

Claude Code の auto-memory を複数PC・複数アカウントへ毎日自動配布する（配信口は鍵配布サーバと分離し、認証だけ委譲する）

auto-memory を夜間バンドル化し分割配信、認証は鍵配布サーバへ委譲して全PCへ日次同期する構成と落とし穴

約17.4万トークン (料金換算約260円)

配布した自動化が「自分を更新できない」問題の根治と人手ゼロ復旧の3層設計

複数端末へ配ったhook/常駐スクリプトが無言で古いまま止まる原因(凍結コピー・実行シェル差)と、中央キュー/自己修復手順/生存digestの3層で人の操作ゼロで復旧させる設計。実測で踏んだ「緑なのに何も起きない」罠つき。

88%節約

約15.8万トークン (料金換算約240円)

アプリ開発の主体を別アカウントの Claude Code へ移管する（権限付け替え＋判断依頼の経路つき）

引き継ぎ書・GitHub/Drive 権限付与・判断依頼プロトコル・カットオーバー条件・途中で移管先を変える手順を1セッションで完了させる型。相手側の人の操作は起動文1回と OAuth 同意1回

86%節約

約15.5万トークン (料金換算約230円)

無人バッチの「黙った空振り」を発見して止める（冪等取込の設計）

定期バッチがエラーを出さないまま毎回同じ仕事をやり直している状態の検出法・典型的な真因（取込済み集合を実体の単一カラムで持つ）・台帳による修正・打ち切り付き再試行・CI課金での効果実測まで。

81%節約

約14.5万トークン (料金換算約220円)

配布したツールが既存端末にだけ届かない障害の診断と再発防止

全PCへ配ったhook/スクリプトが、新規端末では動くのに既存端末にだけ永久に届かない。凍結コピー・拡張子を無視した重複判定・無言return の3重奏で、テストは全green・自己診断もNG 0のまま気づけない。実際に踏んで直した診断手順と、再発を止めるテスト設計(既存端末フィクスチャ/チェックリスト網羅性の機械照合/故障注入)。

Claude Code のログインアカウントを別アカウントへ切り替える（ブラウザ承認1回・auth login が終了しない罠つき）

同じPCで Claude Code の claude.ai ログインを別アカウントへ移す手順。認証ファイル1本の構造、事前棚卸し（env上書き・無人タスク・コネクタ・routine）、非同期ログイン＋status ポーリングのスクリプト骨子、logout が復元不能な点と切り戻しまで。

83%節約

約12.5万トークン (料金換算約190円)

高額モデルを相談役に固定し、実行を安いAIへ自動で振り分ける hook の型（Claude Code）

上位モデルを既定にすると上限が倍速で減る原因は本体がツールを何十回も自分で叩く構造(消費の85%は入力側)。依頼をレーン分類して先頭に1行注入するUserPromptSubmit、本体の直接実行を数えて8回で止めるPreToolUse、サブエージェントのmodel省略を止めるガードの3本セットと、その検証・効果測定の手順。

93%節約

約11.1万トークン (料金換算約170円)

安いLLMプロバイダのフォールバック連鎖を本当に着地させる

無料枠が枯れて黙って死ぬのを防ぐ多段フォールバックの設計。失敗コードの2分類・プロバイダのクールダウン・日次上限・全呼び出し側の一本化・テストが実環境を壊す罠まで。

82%節約

約9.8万トークン (料金換算約150円)

社内アプリの必須機能を、ルール文書ではなくデプロイ直前の hook で強制する（Claude Code）

「全アプリに○○を入れる」が文書だけで守られない問題を、本番反映コマンド直前の PreToolUse hook で未搭載・台帳未登録を deny して潰す型。除外ファイル・fail-open・全PC配布・テスト一覧つき

79%節約

約9.5万トークン (料金換算約140円)

AIに壊させない「変換」の作り方(不変条件とリトライ閾値)

AIに圧縮・移行・整理を任せると『指示どおり動いたのに情報が消える』。IDだけをassertしてタイトルと説明が消えた実例と、人間が読む全フィールドに不変条件を掛ける書き方。あわせて『N回失敗で打ち切り』が試行レート変更で1晩で発動した失敗と、異なる日数で数える実装。

約7.8万トークン (料金換算約120円)

予約データから『価格が高すぎるのか』を判定する手順（リードタイム・ペース曲線）

先の予約が薄い時に憶測で値下げせず、リードタイム別の実勢単価・過去の同じN日前のペース・提示価格の実表示を突き合わせて外れている帯を1つに絞る手順。在庫の穴の見つけ方つき。

83%節約

約7.5万トークン (料金換算約110円)

Drive を AIルール共通ハブにする配布・統合同期

AI(Claude Code 等)のルール/スキルを Drive の1フォルダで正本管理し、pull(全員へ配布)と merge(inbox投稿を正本へ統合)の2モードで同期する仕組み。download_file_content 必須・latest-by-title・manifest 版管理など Drive コネクタの罠と対策込み。

検証したのに何も検証していなかった — 定期実行の反映を3層でexit code判定する

cronやバッチの反映確認が空振りする2つの型（exit 0だけ見る／ツールが既定ブランチに無い）と、A実行・Bデータ・C実表示を1本に繋いで機械判定するスケルトン。対照を入れて別要因の混入も検知する。

アプリ内フィードバック→責任者DM→Issue→自動修正PR→1タップ承認

社内アプリの不具合報告を、責任者の個別DMに届け、Issueにして夜間に修正PRまで自動で作り、承認は既存のPR画面のMergeボタン1タップで済ませる設計。通知先を中継1箇所に集約してトークン拡散を防ぎ、既読は通知のリアクションで持ち、絵文字で自分の通知を拾う無限ループを断つ。

MCP stdio サーバが Windows で「接続済み」のまま死んでいるのを見抜く

MCPサーバ一覧が緑でもツール呼び出しだけ spawn ENOENT で死ぬ故障の3層構造と、initialize/tools-list/tools-call を層ごとに実測して証明する手順。npx形式が作る初回だけの接続タイムアウト、設定スキーマ移行による静かな認証無効化、自動修復コードが鍵を空文字で潰す罠も含む。

複数LLMプロバイダの無料枠切れを検知して自動で次候補へ差し替える

安いLLMへ処理を逃がす構成は無料枠が切れると黙って落ち、記録も残らず一番高いモデルへ逆流する。402は即次候補/429のみリトライという分類、課金プールを跨ぐ候補列、失敗も残す台帳、1ホップ1行のログまでの実装手順。連鎖の順番を実測で決める方法（単価最安≠実効最安/ベンチ飽和/正規表現採点が上位モデルを落とす罠）も収録。

人にログインさせるブラウザ自動化を1回で済ませる（勝手に閉じない・正規Chrome・Cookie判定）

Playwright永続プロファイルで人にログインさせる時、2段階認証途中で閉じる・同梱Chromiumが落ちる事故を防ぐ共通関数とCIガードの型

LLMの出力を実際に動かして採点するevalハーネスの作り方

安いモデルへ落として良いかを測る社内evalで、正規表現採点が正しい答えを落とす問題を解決する。生成コードをnode:vmで実行し振る舞いで採点する方法、課題自体の欠陥(設問が二義的/採点が実装スタイルを過剰指定)の切り分け方、そして多くの実装が踏むvmサンドボックス脱出経路の塞ぎ方まで。

並行AIセッションが共有リポジトリで事故らない型

複数のAIエージェントが同じ作業ツリーを共有する時の事故防止と、配布物を「配布可」と言う前の3層検証（コード・登録・配布）を手順化したMD

配布したhookがWindowsで静かに死ぬのを塞ぐ — process.exit と top-level await

AIエージェントのhookが「出力は正しいのに反映されない」形で無効化される真因と、ネットワークに依存しない回帰テスト・変異テストの型

止まった作業を毎晩検知し、進められるものだけ自動で前に進める

CI通過済みPRが18日放置された実例から、締切・通知・自動前進の3点を備えた夜間検知を作る。通知が埋もれない設計（行動できるものと在庫の分離）と、実測で踏んだ落とし穴まで含む。

HMAC鍵配布サーバの締め出し事故を防ぐ設計（複数秘密＋使い捨てenrollトークン＋失敗の自己通報）

共有秘密で設定ファイルを配る構成は、秘密をローテーションした瞬間に未受領の端末を永久に締め出す。複数秘密の同時受付・使い捨てenrollトークン・失敗を端末自身が通報する設計と、実経路e2eテストの書き方まで。

同じフォルダで複数のAIエージェントを走らせたときの衝突を検知して復旧する

2つ以上のコーディングエージェントを同一作業フォルダで走らせると、片方が片方の未コミット作業を静かに消す。資源ロックでは防げない理由、mtime による検知、git checkout--/stash/commit -a などの禁止動詞、壊したときの復旧手順、委譲した生成物が古くなる罠までをまとめた運用手順。

コーディングエージェント本体を「安い互換バックエンド」で走らせる

エージェントCLIの接続先を互換エンドポイントへ差し替えて実行コストを下げる手順。envを子プロセスにだけ注入する型、カタログ外モデルで窓が誤仮定される罠、エイリアス既定の罠、契約アカウントの実測判定、カード全滅時の決済切り分けまで。

「マージしたのに直らない」— デプロイ元と定期実行のブランチが違う罠の検出と対処

GitHub Actions の schedule は常にデフォルトブランチで走る。本番デプロイ元が別ブランチだと、同じスクリプトの版が2つ存在し「マージしてデプロイしたのに毎晩のバッチだけ古いまま」になる。検出コマンド、base の選び方、そして『デプロイ完了は証拠にならない』ことの確かめ方まで。

エージェントの出力コストを正しく測る（usage複製の二重計上とthinkingが7割という現実）

会話ログJSONLから出力トークンを集計する時に必ず踏む2つの罠（usageがレコードごとに複製され2.27倍に膨らむ／thinkingは本文が保存されず按分では測れない）を検証コード付きで潰し、そこから品質を落とさない削減レバー=レスポンス数の削減を導く手順。

デプロイ更新の「狭間」が本番データを壊す — 新旧の版が同時に動く前提で冪等性を設計する

サーバレス/GAS Web App でデプロイ切替は即時でも原子的でもない。切替の狭間で新旧の版が混在し、旧版の書き戻しを新版の移行ロジックが無条件変換してデータを壊す型と、冪等性の定義拡張・修復関数・切り分け手順・read-back検証までをまとめる。

Discord webhook の死活監視と自動修復

削除された webhook で通知が無言停止するのを防ぐ。生存中にチャンネル台帳を作り、死んだら同一チャンネルの生存 webhook へ自動で差し替える設計と実装要件

起動時フックが増えすぎてエージェントが立ち上がらなくなるのを直す

Claude Code が全タブで 'Subprocess initialization did not complete within 60000ms' を出すのは認証でもネットワークでもなく、起動時フックの合計時間超過。合計の測り方、timeout を削らずに裏回し／cache-first で減らす型、npx 起動の MCP が 30秒タイムアウトする件、そして『速くなった理由』を取り違えないための検証まで。実例 93秒→18.7秒

ずっと skipped だった CI ジョブを掘り起こして緑にする

CI が長期間赤いと needs: の後段ジョブは skipped のまま欠陥が隠れる。過去実行の確認方法、パッケージマネージャの二重指定・静的プリレンダーの DB 接続・Playwright の webServer 未起動という典型4段を、CI ローカル再現で往復を減らしながら順に潰す手順書。

ログオンしただけでIDEが開きAIエージェントが走り出す状態を作る（Windows/VS Code）

毎朝ターミナルを開いてエージェントCLIを打つ手間をゼロにする。folderOpenタスク+スタートアップ.lnkの構成に加え、素直に作ると必ず踏む3つの「エラーを出さずに何も起きない」失敗（8.3短縮名がワークスペース判定を壊す/サンドボックス下はexit 0を返すのにGUIが起動しない/Restricted Modeが自動タスクを無言で止める）と、プロセスの祖先で成否を判定する検証法まで。

CIから自ホストへpushする連携が「届かない日」を、artifactからのpullで埋める

自宅/社内PCやトンネル公開先へCIからPOSTする連携が到達できず落ちる問題を、配達先からartifactを取りに行くpull経路で埋める手順。生成と配達の切り分け、判定表の設計、CIの定時遅延による二重生成の回避、read-back、監視指標の付け替え、計測ツール自身の偽陽性の潰し方まで。

複数LLMプロバイダのフォールバック連鎖に新しい実行者を安全に追加する

安いLLMから順に試すフォールバック連鎖へ、新プロバイダを実測(成功率/単価/到達性)にもとづく正しい位置に差し込み、並行編集で静かに消えないよう配列全体をpinする回帰テストと4段階の実走検証まで通す手順。

CLIをラップしたMCPサーバが上流の無料枠終了で死んだらREST直叩きへ寄せる

外部AIのCLIを子プロセスで起動するMCPサーバが認証終了・旧モデル固定・機能別の枠切れで死ぬ。原因を4層で切り分け、ツール名を変えずに実行部だけRESTへ置き換える手順と、接続緑・テスト緑では足りない検証方法。

ダッシュボードが「artifact が見つからない」で真っ赤になるのを塞ぐ

GitHub Actions の成果物を画面に出す構成が no valid artifacts found で落ちる真因（preflight skip した run も success だが artifact 無し）と、artifact 実在確認＋直近成功へのフォールバックで画面を殺さない直し方。常駐プロセスの世代確認と実ブラウザ描画までの検証手順つき。

AI開発ノウハウをチーム共通ハブへ投稿する型

セッション中に得た AI コーディングのルール・失敗パターンを、Drive の追記専用 inbox フォルダに定型フォーマットで投稿し、管理者が正本へ統合する仕組み。各人のローカルにルールが散らばるのを防ぐ。機密値の書き方も規定。

自分が管理していない上流ファイルを差し込みで維持する型 — 死んだパッチを検知して retired に移す

上流が更新し続けるスクリプトに自分の修正を当て続ける仕組み。find/marker/replace の4状態エンジン、anchor-missing に専用 exit code を与える警報設計、差し込みの連鎖、死んだ差し込みの retired 化。テストが足りない値を注入していて壊れたコードが緑だった実害と、その塞ぎ方まで。

「直したのに直らない」— 同じ画面に書き込む経路が2本あるのを見落とす

利用者の不具合を直したのに直らない時の定番原因。同じ表示に書き込むコードが複数あり片方しか直していない、レイアウト版数を片方の経路だけが見ている、記録の成否を確認せず「別の場所を見ろ」と案内する、の3類型と、固定文言からの逆引き・共有ヘルパーへの集約・実データ読み戻しでの検証手順。

二重定義を片方へ寄せる挙動不変リファクタを、AI委譲で安全に終わらせる

同じ表が直書きと導出で2箇所にある状態を片方へ寄せる時、テストが緑でも終わっていない。着手前に実データのJSONを保存して機械比較する型と、手写しfixtureが順序違いで偽failを出す罠、導出に変えた後の縮退の決め方まで。

定期実行が「手動なら動く」まま何週間も止まっているのを見抜いて直す

GitHub Actions の schedule だけが 403 で全滅しても手動実行は成功し続けるため気付けない。--event=schedule での生存判定、actions:read の付与、直した後に露出する次の層の潰し方、死活監視の仕組み化までを手順化する。

成功しているのに『スキップ』と出るバグの潰し方(ディスパッチャの戻り値規約)

ボタン一覧→コマンド関数をディスパッチする型のツールで、状態フラグと明細配列に同じキー名を使うと空配列がtruthyで常に成立し、成功しても『スキップ』表示になる。原因特定の順序・修正・文言そのものをテストする退行防止まで

承認を取る設計書は「ひと目でわかる版」1枚を安いAIに下書きさせて先に出す

技術者向けの要求定義・設計書を、スマホで1分で読める1ページに変換して承認の往復を減らす。下書きは安価なLLM、監督AIは禁止語・タグ・375px描画の機械チェックのみ

機能を封鎖したら相乗りの検証も死ぬ — 未検証のゼロを画面から追い出す

危険な機能を後から封鎖すると、同じフラグにぶら下がっていた検証処理が道連れで死に、ツールは未検証のゼロを『確認した結果ゼロ』の顔で出し続ける。実例では1週間、12件ぶんの嘘の警報を出していた。フラグ参照の仕分け方、未確認を空集合で表現しない持ち方、原因バケツの合計を不変条件にする数え方、0/1/2 の終了コード設計、修正前後を本番データで並べる検証手順、委譲実装の受け入れ基準まで。

CI が全部 green なのに auto-merge されない PR を原因から特定して自動マージに乗せる

GitHub の auto-merge が効かない原因は権限ではなく fork であることが多い。切り分けコマンド、ワークフローの5条件の読み方、正しい提出経路、ラベル忘れが成功に見える落とし穴、GraphQL と REST の2系統を実測付きで示す

連携が「権限不足」に見えて実は「身元違い」のとき — 両側のアカウントを先に実測する

デプロイサービスとGitホスティングの連携が繋がらない時、資源側の権限をいじり続けて往復を溶かす失敗を止める。要求側が外部で名乗る名前と資源の所有者を実測で突き合わせる手順、詰まった時に目的へ戻る代替、環境変数のスナップショット順序など併発する罠まで。

84%節約

約7,600トークン (料金換算約11円)

スプレッドシート集計業務をNext.js+Supabaseアプリへ段階移行する設計指示書

運用中のSheets業務を止めずにWebアプリ(DB正)へ段階移行。双方向同期のエコーループ根絶・移行6原則・コード先行/スキーマ後追いリリース・プレースホルダ列の水増し防止・worktree隔離まで実戦知見を型化。

81%節約

約6,900トークン (料金換算約10円)

fork PR しか出せない AI エージェントに「マージまで」を完了条件にさせない

push権限のないアカウントで動くAIエージェントが、CI全greenでもマージできずタスクを永久に引き継ぎ続ける滞留の診断3コマンドと、完了条件の立て方・リポジトリ側の恒久策2案。

77%節約

約6,900トークン (料金換算約10円)

「名前でフォルダを探して無ければ作る」処理が自分の重複を掴み続ける問題を潰す

自動化が保存したファイルが現場のフォルダに入らず「同じ名前のフォルダが2つある」状態になる。真因は探索の深さでも起点でもなく「ヒットで即return する順序」。候補を全部集めてスコアで選ぶ形へ直す手順と、再発を縛るテストの書き方をまとめた指示書。

0%節約

約0トークン (料金換算約0円)