巻物を探す

委譲した実装を「本番で起動される環境」で受け入れ検証する

AIに実装を委譲するとテストは緑で返るが、それは委譲先の環境での緑でしかない。WSLとネイティブなど実行環境が2つあると片方でだけ通るコードが生まれ、本番へ配線した日から静かに失敗する。本番の起動経路で受け入れ検証する型と、環境差で死ぬ定番3つ、破壊的ツールの追加ゲート4つ。

79%節約

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

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

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

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

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

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

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

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

依存ゼロのMCPサーバを作り、npm公開に詰まってもnpx github:で今日から配る

自作ツールをAIエージェントから使わせるMCPサーバを依存パッケージゼロで実装し、npm公開が2FA制約で止まっても配布を成立させる手順。JSON-RPC自前実装の要点4つ、二刀流bin、.mcp.json自動登録、実ハンドシェイク検証、そしてbinの./で公開物が壊れる罠まで。

約36.5万トークン (料金換算約550円)

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

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

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

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

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

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

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

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

93%節約

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

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

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

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

fail-open のガードが「必要な場面でこそ効かない」のを設計段階で潰す

抑止・重複防止・レート制限を fail-open で作ると unknown の範囲を広く取りすぎてガードが常時 open になる。ユニットテストは緑のまま機能だけ死ぬ型。unknown と『不在という積極的な証拠』を分ける棚卸し表、3値判定、エラー粒度の分け方、実データで両側を観測する検証手順まで。

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

同期が「更新しました」と嘘をつく — 配布が届かない2つの欠陥を潰す

設定・ルールの配布処理が成功報告を出すのに実際は届いていない。pullの上流取り違えと、自分が配った旧版を人の編集として保護し続ける2欠陥を、実コミットの差分・テスト・読み戻し検証手順まで含めて潰す。

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

内容は同じなのに PR が CONFLICTING — CRLF 混入の見かけ上の衝突を修正を壊さず解消する

別コミットの改行コード変更で PR 全体が衝突に見える問題を --ignore-all-space で判定し、rebase -X renormalize で元の修正だけを乗せ直す手順。検証コマンド、.gitattributes での再発防止、複数 PR を worktree で同時に扱う時の罠と報告文の型まで。

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

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

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

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

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

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

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

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

セッションを閉じたら次のセッションが自分から再開するようにする（2つの届け方と、その限界）

エージェントCLIの外から新セッション化は発火できない。その制約下で取りうる window / inline の2方式、暴走を止める条件、実測で踏んだ罠と検証項目までの実装指示書。

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

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

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

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

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

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

常駐ジョブを作業ツリーの HEAD に依存させない（固定 worktree ＋出力先分離）

毎朝走るジョブが Cannot find module で落ちるのは、実行場所が人や別セッションの作業ツリーで、HEAD が動くから。ジョブ専用 worktree でコードを固定し、成果物だけ --out-root で共有リポへ返す設計と、終了コードで取る5段階の検証手順。

汚れた作業ツリーから「レビュー済みの版だけ」を本番に出す（git worktree + Vercel）

未コミット差分だらけ・originとズレたローカルから誤った版を本番に出す事故を、detached worktree + .vercelコピー + 本番URLへの実描画検証で塞ぐ手順

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

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

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

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

78%節約

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

MCP サーバーを npm 公開せずに GitHub 直接指定（npx github:）で配布する

npm publish が 2FA/権限で止まった時に、LP・README・init・テストの導線を github: 指定へ寄せ、push 漏れとキャッシュに騙されない検証まで含めた手順

78%節約

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

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

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

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

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

スマホ(Remote Control)から即相談できる Claude Code タブを VS Code に毎朝自動で用意する

自作VS Code拡張で公式Claude Codeのコマンド(editor.openLast/newConversation/renameSessionTab)を叩き、名前付きタブをN本自動補充。夜間はWM_CLOSE→再起動で毎朝揃える。--bg/ターミナル経路・タブ0でのnewConversation・SendKeys再読み込みが失敗する実測付き

98%節約

約39.1万トークン (料金換算約590円)

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

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

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

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

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

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

88%節約

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

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

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

95%節約

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

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

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

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

複数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円)

別アカウントの Claude Code 同士を人の転記なしで直接やりとりさせる（共有メールボックス方式）

組み込みSendMessage/Remote Controlは同一アカウント限定。既存のトークン付きWeb App＋シートをメールボックスにして任意PC間を双方向・2分配達、promptは承諾制で読み取り専用headless実行

約16.5万トークン (料金換算約250円)

無人エージェントの夜間作業をKPI化する（「完走しました」を成果の証明にしない）

夜間の無人セッションが「N/N完走・失敗0」でも実は過半が空回り、という状態を数字で暴く指標設計。消化率・空回り率・コスト削減効果の3本と、空回り分を削減効果から差し引く理由、実測で機能しなかった指標を棄却した記録つき。

86%節約

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

アプリ開発の主体を別アカウントの 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円)

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

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

88%節約

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

AIエージェントの「委譲率」を正しく測る指標設計

監督AIが実装を安いエージェントへ渡せているかを毎日自動計測する指標の作り方。トークン比が飽和する/分母を landed 行にすると100%に貼り付く/編集ツールだけ数えると逆向きに嘘をつく、の3失敗と対策・増分キャッシュでの高速化まで

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

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

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

79%節約

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

無人実行ジョブが「働いたのに何も残らない」を潰す設計

cron/タスクスケジューラからAIエージェントや長時間処理を無人で走らせる際の2大事故（タイムアウトkillで出力が丸ごと消える／実行されるコードがその瞬間のHEADで決まる）を構造的に潰す実装指示書。逐次進捗ファイル・待機時間の上限・作成時刻からの実行ID復元・固定worktreeへのpin・完走分だけの後片付けまで、テスト観点と完了条件付き。

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

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

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

91%節約

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

Claude Code のセッション一覧を「閉じたら自動で消える」ようにする

C:/Program Files/Git/clear は削除コマンドではない。hook + 閉じた台帳 + 常駐ウォッチャーで、セッションを閉じたら一覧から自動退避（削除せず move）する実装手順と、並行タブ・凍結コピー配布の落とし穴

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

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

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

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

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

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

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

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

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

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

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

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

83%節約

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