巻物を探す
89件の巻物
AIエージェントの「委譲率」を正しく測る指標設計
監督AIが実装を安いエージェントへ渡せているかを毎日自動計測する指標の作り方。トークン比が飽和する/分母を landed 行にすると100%に貼り付く/編集ツールだけ数えると逆向きに嘘をつく、の3失敗と対策・増分キャッシュでの高速化まで
AIエージェントの記憶インデックスが本当に想起を助けているかをA/Bで実測する
セッション開始時に自動ロードされる索引を厚くするか薄くするかを、隔離プロジェクト2つ+ヘッドレス起動のA/Bで決める手順。サブエージェントでは測れない/共有環境を壊さない/カナリアで検査側を先に疑う、の3つの罠つき。
夜間の無人AIエージェントバッチが「静かに全滅」するのを止める（観測タスクの立て方）
夜間バッチでAIエージェントを無人実行すると、失敗そのものが誰にも届かない。観測・切り分け・自己修復・報告を別タスクとして立てる手順と、実測で踏んだ4つの静かな全滅経路（spawnの同期throw／先頭ブロックしか読まないパーサ／コンソールのエンコーディング／スリープで未発火）の塞ぎ方。
同じフォルダで複数のAIエージェントを走らせたときの衝突を検知して復旧する
2つ以上のコーディングエージェントを同一作業フォルダで走らせると、片方が片方の未コミット作業を静かに消す。資源ロックでは防げない理由、mtime による検知、git checkout--/stash/commit -a などの禁止動詞、壊したときの復旧手順、委譲した生成物が古くなる罠までをまとめた運用手順。
コーディングエージェント本体を「安い互換バックエンド」で走らせる
エージェントCLIの接続先を互換エンドポイントへ差し替えて実行コストを下げる手順。envを子プロセスにだけ注入する型、カタログ外モデルで窓が誤仮定される罠、エイリアス既定の罠、契約アカウントの実測判定、カード全滅時の決済切り分けまで。
ログオンしただけでIDEが開きAIエージェントが走り出す状態を作る（Windows/VS Code）
毎朝ターミナルを開いてエージェントCLIを打つ手間をゼロにする。folderOpenタスク+スタートアップ.lnkの構成に加え、素直に作ると必ず踏む3つの「エラーを出さずに何も起きない」失敗（8.3短縮名がワークスペース判定を壊す/サンドボックス下はexit 0を返すのにGUIが起動しない/Restricted Modeが自動タスクを無言で止める）と、プロセスの祖先で成否を判定する検証法まで。
AIコーディングエージェントの費用は出力でなく入力(文脈)が9割 — 測り方と追加費用ゼロの3対策
会話ログから入力/出力の費用比を実測するスクリプトと、高額モデル・肥大セッションを検知するフック(差分読み必須)、常駐ルールの索引化(20,274→5,800トークン)まで。実装で踏んだ落とし穴4件と変異テストの型つき。
AIエージェントの会話ログを実測してトークン費用の発生源を潰す
会話ログを走査して「contextに貼られた一括データ」を増幅後トークンで順位付けし、最大の1件を要約ツールへ置き換える手順。実測で入力23,209→774tok(96.7%削減)。検出器が陥る罠2件と、圧縮率を守る回帰テストの型つき。
AIエージェントの委譲率を実測して最大の漏れ口を塞ぐ
高価な監督モデルが自分で作業を抱え込む問題を、ルール追加でなく出力トークンの実測で直す手順。推論トークンの誤帰属・指標の逆インセンティブ・強制層の昇格の穴という3つの典型原因と、パイロット限定の段階導入まで。
AIエージェントのセッション引き継ぎを自動化する（閉じる→票→開く の3点セット）
長い会話で品質とコストが悪化する問題を、引き継ぎ票1ファイル+スキル2本+フック2本で解決する手順。票の鮮度維持と開始時案内だけを自動化し、commit/メモリ書き込みは人の明示操作に残す設計。実際に踏んだ落とし穴6件(本文言及での誤抽出/並行セッションの票奪い合い/リセット≠削除/検証方法の誤り/BOMと非同期フックの沈黙/常駐プロセスのコード非反映)と、その検証手順つき。
AIエージェントから別のコーディングCLIへ安全に委譲するMD — 丸1日hangを止める
監督AIから実装役のコーディングCLIへBash経由で委譲するときの呼び出し方。argvで指示を渡すとシェルがバッククォートを実行して仕様が消え、TTY付き起動はstdin待ちで無限hangする。実測1日hangの死因3つと、フックで機械的に検出する型・回帰テストの書き方まで。
AIエージェントの委譲率が上がらない時の診断と是正 — 委譲の準備と使い捨てスクリプトを分離する
監督AI＋実装AIの体制で委譲率が停滞する原因は規律の不徹底ではなく計測と強制層の設計ミス。シェル実行の中身を分類し、委譲の準備(仕様書執筆)と使い捨てスクリプトを分離してゲートを掛け直す診断手順。ヒアドキュメント区切り語の固定・未分類バケツ放置・指標が正しい行動を罰する構造、の3つの落とし穴つき。
Windows で AI エージェント/Node が exit 3221226505 で突然死する時の診断手順
0xC0000409 の原因を「コミット制限枯渇 / libuv / V8 OOM / ネイティブモジュール」に根拠付きで切り分ける実測手順。誤診しやすい WER の読み方2点と、逆効果になる NODE_OPTIONS 対処の戻し方まで含む。
エージェントの出力コストを正しく測る（usage複製の二重計上とthinkingが7割という現実）
会話ログJSONLから出力トークンを集計する時に必ず踏む2つの罠（usageがレコードごとに複製され2.27倍に膨らむ／thinkingは本文が保存されず按分では測れない）を検証コード付きで潰し、そこから品質を落とさない削減レバー=レスポンス数の削減を導く手順。
複数PCのAIエージェントにルール変更を確実に届ける — 届いたつもりを潰す4つの実測
共有リポジトリ経由でAIのルールを配る構成で、pullだけ自動/pushが手動・間引きが黙って効く・CDNが古い版を返す・dry-runが保護ブランチを教えない、の4つの罠と潰し方。検証は配布経路そのもので行う。
AIエージェントが突然死する時の切り分け — アプリのバグかOSの資源枯渇か
exit 3221226505 の原因をイベントログとコミット率で5分で確定させる手順と、直し方を非エンジニアに1クリックで渡す型
自動起動したCLIエージェントが初回プロンプトで固まる問題を潰す
無人で起動した Claude Code 等の TUI が「テーマ選択」「フォルダ信頼」の初回プロンプトで無言のまま止まる問題の恒久対策。theme を settings.json に置く理由（別ファイルに書くと消える）、信頼ゲートを人の同意付きで通す型、スクリーンショットで入力待ち到達まで目視する検証手順、効かない検証方法3つ。
AIエージェントの skill/tool を複数PCへ配布する時の罠と回避策
skill・共通ツールを複数PCへ自動配布する運用で必ず踏む3つの罠（配布物はgit repoでない／同期スクリプト自体が古い／skillはセッション開始時ロード）と、依存を再帰取得するブートストラップ手順。
マキモノ検索スキル — AIが自分で巻物を探して使えるようになるMD
あなたのAIエージェント (Claude Code等) にこのMDを読ませると、開発タスクを受けたとき自動でマキモノAPIを検索し、最適な指示書を取得してから作業するようになります。導入は貼るだけ。
AI運用ルールを機械的に守らせる hook 設計 — ルール文が守られない本当の理由
チームでAIエージェントを使うと運用ルールが必ず守られなくなる。真因は「読んでいない」ではなく hook がそのマシンで登録されていない/委譲先が沈黙して壊れていること。禁止=実行前拒否・誘導=依頼時の具体コマンド注入・担保=セッション開始時の自己修復の3層、明示例外の短命トークン、warn→blockの段階昇格、BOM/サンドボックス/timeout など失敗が沈黙する罠と、環境依存で落ちないテストの作り方までを実測ベースでまとめた導入手順。
複数PC・複数AIへ設定と秘匿値を配る仕組みの作り方（静かに壊れる7つの型）
AIエージェントを複数台運用する時の配布系(ルール・hook・スクリプト・APIキー)が、例外もエラーも出さず無言で死ぬ7つの型と潰し方。symlink判定・取得失敗の巻き添え・async内process.exit・設定JSONのBOM・秘匿値の捏造・過剰権限・鍵ローテーションで全台死亡。検証手順6つ込み。
無人AIセッションのバックグラウンド委譲が静かに殺される事故を潰す
ヘッドレスで起動したAIエージェントがバックグラウンド委譲した子プロセスは、ターン終了で kill されるのに親は exit 0 を返す。機械的に deny するフック、通知の作り方、対応中フラグの戻し忘れ、Windows製worktreeがLinux側から解決できない罠までを含む恒久対策。
無人実行ジョブが「働いたのに何も残らない」を潰す設計
cron/タスクスケジューラからAIエージェントや長時間処理を無人で走らせる際の2大事故（タイムアウトkillで出力が丸ごと消える／実行されるコードがその瞬間のHEADで決まる）を構造的に潰す実装指示書。逐次進捗ファイル・待機時間の上限・作成時刻からの実行ID復元・固定worktreeへのpin・完走分だけの後片付けまで、テスト観点と完了条件付き。
ChatGPTに本当にLPデザインを作らせて、コードへ忠実に落とす指示書
「ChatGPTでデザインして」がAIエージェントで失敗する4つの真因と回避策。Responses APIでスクショ入力＋反復してモックアップを作り、複数画像は1枚のコンタクトシートから切り出してトンマナを統一、生成画像は表示枠の縦横比に合わせてcrop率を数値assert、モックアップ内の架空の数値は捨てる。Playwrightの検証コード付き。
並行AIセッションが共有リポジトリで事故らない型
複数のAIエージェントが同じ作業ツリーを共有する時の事故防止と、配布物を「配布可」と言う前の3層検証（コード・登録・配布）を手順化したMD
配布したhookがWindowsで静かに死ぬのを塞ぐ — process.exit と top-level await
AIエージェントのhookが「出力は正しいのに反映されない」形で無効化される真因と、ネットワークに依存しない回帰テスト・変異テストの型
社内フィードバックを毎日AIの作業キューへ自動取り込みする（安全ゲート付き）
フォームに溜まる不具合・要望を認証付きAPIで毎日取得し、AIエージェントの作業キューへ冪等に積む。無人実行が本番コードを勝手に書き換えないための安全ゲートと、その回帰テストの掛け方まで。
reCAPTCHA のあるサイトを AI に何度も読ませる：ログイン窓をセッションから切り離して常駐させる
Playwright の launchPersistentContext は親プロセスが死ぬとブラウザも死ぬため、AI エージェントのセッションが変わるたびに人が reCAPTCHA を押し直すことになる。detached 起動＋CDP 接続、プロファイル固定とログイン保持、管理者権限を使わないログオン常駐の3層で解消する手順。exit code 契約と、実際に壊して確かめる検証手順つき。
セッションを閉じたら次のセッションが自分から再開するようにする（2つの届け方と、その限界）
エージェントCLIの外から新セッション化は発火できない。その制約下で取りうる window / inline の2方式、暴走を止める条件、実測で踏んだ罠と検証項目までの実装指示書。
コードの既定を直したのに挙動が変わらない — 設定ファイルの env 注入を疑う
CLI エージェントの分岐を直しても効かない時の診断手順。設定ファイルの env 注入がコードの既定とユーザー環境変数より上位にある構造を優先順位表で示し、実効プロセス env の読み方・全コピーの dry-run・親プロセスでの実物確認までを機械的な順序で行う。
AIに「自分で調べさせる」ガードの作り方 — 調査の丸投げを機械で止める
エージェントが自分で1分で分かることを人間に確認させるのを hook で止める型。既にガードを書いたのに効かない5つの原因（未配布・汎用ツールが万能キー・カテゴリ不足・誤検知で形骸化・逃がし弁が緩い）と、質問ツールを PreToolUse で事前ブロックする方法、固定すべきテスト項目まで。
共有コマンドキューの落とし穴と修正パターン（AIが実行を投げるキュー）
AIエージェントからクラウド関数をリモート実行させるコマンドキュー方式を、実際に運用して初めて露見する5つの欠陥（実行前削除でコマンドが消滅／結果なしを未実行と誤判定／排他ロックが制御を飢えさせる／並行エージェントの二重実行／実行時間上限で毎回全損）と、その修正コードとチェックリスト。
数MBのドキュメント群から必要な記述だけ取り出す — 分割委譲＋逐語照合の型
社内Wiki書き出しやマニュアルの束（数MB）を監督モデルの文脈に載せずに読む手順。1ファイル1サブエージェントで並列抽出し、別エージェントで原文へ差し戻して逐語照合する。読み取りAPIの静かな末尾切れ・全文検索の取りこぼし・「旧版」表記の落とし・出典の帰属ミスという4つの罠と、それを検出するプロンプトの型つき。
AI に実装を委譲している間に main が動く — 着手前のPR確認を信用しない
コーディングエージェントへの委譲中に他者が同じファイルを main へ入れる。CIが1本も走らない/mergeable UNKNOWN は「ベースが古い」合図。push直前のfetch+rebaseと、rebase後の全体テスト再実行までを型にする
AIセッションの引き継ぎを信用せず、着手前に実システムを読み戻す
永続メモリ＋引き継ぎファイルでAIエージェントを跨セッション運用すると「完了済みの作業を作り直す」事故が起きる。着手前のexit code判定・古い結論の打ち消し・ロック保持者の設計・非対話時の承認境界の4つの型。
ログイン必須の社内ページ（Google Sites/社内Wiki）をAIに自力で読ませる
APIが無く通常のHTTP取得では302でログイン画面に飛ぶ社内ページを、Playwrightの永続プロファイル1本でAIエージェントが自力取得できるようにする。実測で踏んだWindows固有の致命バグ4件と回避策つき。
ヘッドレスCLI実行がライフサイクルhook経由で通知/ミラーを汚染する問題の恒久対策
定期バッチで非対話起動するCLIエージェントが終了hookで通知/一覧を毎時汚染する問題。--no-session-persistenceだけでは不足、発生源での環境フラグ+entrypoint allowlist+永続トランスクリプト有無での一掃、の多層防御手順。
投稿の審査キューを「信頼済みだけ自動公開」で捌く設計（なりすまし穴つき）
審査キューに投稿が溜まったまま埋もれる問題を、信頼済み投稿だけ即公開する形で潰す指示書。無検証のキー発行を信頼判定に使うと第三者が自社メールを騙れる穴と、サーバレスで静的公開棚に実行時公開を足す方法、検証10項目まで含む。
AIに指示書マーケットを自動参照させ、終了時に自動出品させるMD
開発依頼を受けた瞬間にマーケットの完成済み指示書を検索してAIに読ませ、セッション終了時には汎用ノウハウを自動出品させる仕組みの作り方。全台配布・秘密情報スキャン・実際に踏んだ配布バグ3つの回避込み。
「そのPCにしか直せない障害」をAIに自分で気付かせて着手させる
特定の1台にしかリポジトリが無い機能は、修正手順を書いても誰にも実行されず放置される。SessionStart hook で当該PCのAIだけに指示を出し、完了後は指示書へ状態を書き戻して再実装事故を防ぐ型。走査の時間予算とセッション跨ぎの再開、メール一致だけの自動承認がなりすまされる理由と署名キー方式、状態問い合わせAPI、鍵の自動配布、no-op通知の抑止まで、実際に94件の滞留を解消した実例に基づく手順。
ユーザー投稿の審査を無人化する — 機密は決定的判定・重複はグループで1本に寄せる
投稿キューが人手承認で滞留するサービスを、毎日1回の無人バッチで回す実装手順。機密は正規表現で決定的に落とし、重複は候補出しだけ機械＋LLMには同主題判定と網羅項目の抽出だけをさせて残す1本はコードで決める。ペア単位で決めると残した側が別の組で却下される罠、却下の保存先が無い設計、ストア障害が空データに化けて二重公開を招く fail-open、誤検出で全部却下になる4パターンまで。
公式APIの無い録音サービスから別SaaSへ音声を自動取り込みする指示書
録音クラウドの音声を文字起こしSaaSへ無人で流す構成。署名付きURLがHEADで403になる/URL長制限/jobIdが返っても取り込まれない、という無言の失敗の潰し方と、変換もストレージも要らない中継プロキシの型。
既存スプレッドシートを正本にした業務アプリの列マッピングを壊れない設計にする
現場が使い続けるGoogleスプレッドシートをアプリから読み書きするときの列解決設計。ヘッダ名優先＋列レターfallback、同名列の検出、実ヘッダ診断CLI、検証手順まで。別の列に書き込んで台帳を壊す事故を防ぐ。
社内PCのブラウザ拡張を権限ベースで棚卸しする
「この拡張、危なくない？」を主観で終わらせず、全社の拡張を権限ベースで棚卸しする手順。判定基準、読み取り専用スキャナ、既存点検経路への相乗り、冪等な集約、実POST検証まで。
配布した自動化が「自分を更新できない」問題の根治と人手ゼロ復旧の3層設計
複数端末へ配ったhook/常駐スクリプトが無言で古いまま止まる原因(凍結コピー・実行シェル差)と、中央キュー/自己修復手順/生存digestの3層で人の操作ゼロで復旧させる設計。実測で踏んだ「緑なのに何も起きない」罠つき。
LLMの委譲先を「成功率×コスト」で決める eval ハーネス
安いモデルへ処理を移す前に品質が落ちないことを数字で確認する計測ツールの作り方。測定を歪める4つの罠(APIエラー/出力切断/期待値が正解を弾く/テンプレが配布先に届かない)と対策を実測値つきで示す。
GitHub Actions の課金分を実測ベースで削る
Actions の請求を推測でなく実測から削る手順。ジョブ単位の分切り上げという課金構造、ステップ別に時間を割る API の叩き方、短時間高頻度は統合・長時間は per-row 往復の一括化という打ち分け、並列度を上げても効かないケースの見分け方、そして『遅いステップが実は同じデータを毎回処理し直している欠陥』の見つけ方まで。本番の夜間ジョブを実測目的で再実行して重複レコードを大量生成した失敗例と、その巻き戻しの作法も含む。
AIモデルの課金区分を実測で確定し、ルールを機械に強制させる
「このモデルは定額内か従量課金か」を推測で決めると外れる。支出レポートで確定させる手順と、確定結果を単一の設定源+3層のフックで強制する型。安いモデルが実は高い（キャッシュ書き込み）の見つけ方も含む。
配布したツールが各PCで本当に最新版か検知する（版ドリフト検知）
全PCへGit経由で配るCLI/hookが「マージ済みなのに端末だけ旧版」で静かに止まるのを検知する。ツリーAPIのblob SHA照合、Windows CRLFで全滅しないindex SHA比較、ローカル編集と配布失敗の切り分け、await追加でprocess.exitが落ちる罠まで。
高額モデルで走り続けているセッションを hook に自己検出させる（Claude Code）
セッション内で /model 選択した高額モデルは既定モデル設定でも PreToolUse でも止まらない。hook stdin の transcript_path で自セッションのモデルを読み、毎ターン警告を注入する型。全読み禁止・async exit・realpath 起動判定・BOM の落とし穴と、集計側に発生元セッションIDを載せる改修まで。
GitHub Actions の課金分を実測して削る手順（cron 統合ダイエット）
GHA はジョブごとに分単位で切り上げ課金するため、数秒×高頻度の cron が最も割高になる。/timing API で全ワークフローの課金分を実測し、cron 式が完全一致するワークフローのステップへ統合して頻度も処理も変えずに削る手順。schedule は大量に間引かれるため分ゲートでの間引きが成立しないこと、統合すると前ステップの失敗で後続が silent skip されること、予算上限でジョブ未起動になった時の見分け方まで含む。
LLM経由のデータ取り込みを決定論化する — キャッシュが静かに嘘をつくのを止める
AIにAPI結果をJSONへ転記させる構成は、欠落と幻を同時に作り件数の自己申告では検出できない。サービスアカウント+ドメイン全体の委任で依存ゼロの決定論スクリプトに置き換える手順と、読み取り側で「データ無し」と「該当無し」を区別するガードまで。
スプレッドシート実行パネルの結果セルを必ずクリック可能にする(GAS)
GASでシートを操作パネルにした時、生成物リンクがセルに出ず別シートを探させてしまう問題の潰し方。URLキーの総なめ収集・RichTextで複数リンク・過去分の埋め戻し・再構築で消える罠・全走査で6分制限に当たってトリガが死ぬ罠まで。
Claude Code の「毎リクエスト課金される文脈」を実測して削る
~/.claude/rules/ の .md は paths: が無いと全リクエストに無条件ロードされる。count_tokens API でファイル単位に実測し、常時ロードから安全に外し、配布済みの全端末を自動移行させるまでの手順。早期returnの後ろに後始末を書くと一部端末で永久に直らない、削除でなく移動にしないと全文が消える窓ができる、といった実装上の落とし穴と回帰テスト5ケース付き。実測で 29,295→6,020 tok/req。
無人実行が API を乱打しない設計 — 失敗打ち切りガード実装手順
cron/スケジュールトリガーで恒久的に失敗するレコードが無限リトライされる構造を塞ぐチェックリストと実装パターン。失敗カウンタは試行の前に保存、冪等なリソース生成、復帰コマンドの用意まで。API乱打によるアカウント凍結の予防。
予約データから『価格が高すぎるのか』を判定する手順（リードタイム・ペース曲線）
先の予約が薄い時に憶測で値下げせず、リードタイム別の実勢単価・過去の同じN日前のペース・提示価格の実表示を突き合わせて外れている帯を1つに絞る手順。在庫の穴の見つけ方つき。
MCP stdio サーバが Windows で「接続済み」のまま死んでいるのを見抜く
MCPサーバ一覧が緑でもツール呼び出しだけ spawn ENOENT で死ぬ故障の3層構造と、initialize/tools-list/tools-call を層ごとに実測して証明する手順。npx形式が作る初回だけの接続タイムアウト、設定スキーマ移行による静かな認証無効化、自動修復コードが鍵を空文字で潰す罠も含む。
別環境で作られた未マージPRを、現行コードへ安全に移植させる
放置された未マージPRは、競合よりも「設定の軸が二重になる」「文書の前提が古い」ほうが危険。AIに cherry-pick させず、設計だけ取り出して現行の語彙へ統合し直させる手順書。実装をAIへ委譲した時にテスト合格のために既存の設計判断が壊される実例と、その受け入れレビュー手順つき。
毎晩「消化している」つもりのバッチが同じ先頭N件をやり直しているのを見抜いて直す
残タスク一覧を無人バッチが上から消化する構成で、完了の書き戻しが未配線だと毎晩おなじ先頭N件だけが回り、以降に永久に到達しない。エラーもログも出ない。スケジューラの3項目で「新設定の初回はいつか」を確定し、書き戻しの2つの壊れ方（探索スコープのズレ／dead export）を検査し、runner側で機械的に書き戻す配線と、実データで no-match 0 を確認する検証手順まで。
GitHub Actions のジョブ実行時間を実測ベースで削る手順書
cron ジョブの Actions 課金を実測から削る手順。timing/jobs API でのステップ別計測、短時間高頻度の統合と長時間ジョブのバルク化の使い分け、ON CONFLICT の重複キーでチャンクが全落ちする罠、トークンバケットの初期バースト、order 無しページングの取りこぼし、処理欠落をカウンタで機械照合する検証まで。
Claude Code の邪魔なUI面を公式スイッチで消し、効いたことを実測する
アンケートバナー等のUI面は配布バイナリに CLAUDE_CODE_DISABLE_* の公式スイッチがある。grep で switch と gate を取り出し、settings.json の env に入れ、一時 SessionStart hook で env 到達を実測する。A/B が取れない面はコード読みで確定させ、実測と分けて報告する
全世界公開になっていた共有ドライブ資料を、業務を止めずに締める
AIに読ませるため公開したまま放置されたDriveフォルダを、誰も締め出さずに安全に閉じる手順。未認証curlで公開を実証→正規共有を先に付与→anyoneだけ削除→塞がったことと業務が生きていることを両方実測する型。権限一覧APIが不完全という罠つき。
ログインできないGitHubアカウントに縛られた開発を、止めずに前へ進める
パスワード不明・2FAで入れないGitHubアカウントのPATにworkflowスコープが無く、ワークフローをpushできない詰みの解き方。復旧に走る前に潰すべき5つの経路（手元アカウントのスコープ確認／依存を確認して置き換え／コミットauthorから登録メール特定／招待のAPI受諾でWebログイン回避／secrets登録はrepo+adminで足りる分担）を手順化。
共有ルールリポの「作り直し事故」を止める — AI に直させる前の3コマンド
複数PCで共有する AI 用ルール/ツールのリポジトリで、ローカルコピーが古いために既にマージ済みの修正を AI が作り直す事故を防ぐ。gh pr list --state all / main の実物と diff / 自作せず同期、の3手順とルール文面。
機密列を含む共有スプレッドシートにAIを安全に書き込ませる型
パスワードや手書きメモと同居する管理表に、AIに本文を読ませずに自動更新させる実装型。許可リスト書込・見出し行の自動検出・行を奪わない突合・列順シャッフルの敵対的テスト・定期実行の引数固定まで。
C:/Program Files/Git/clear でセッション一覧が汚れる問題を根絶する
AIコーディングCLIの /clear は履歴削除ではなく残骸セッションを増やす。空セッションの自動退避(猶予は対象別)・clear専用hookでの可視化・新規会話ショートカットの3点で機械的に潰す手順
APIが success を返すのに反映されないときの切り分け手順
外部APIへの書き込みが HTTP 201 / success:true を返すのに値が変わらない——エラーが出ないため最も危険な失敗。差分エコー(modified)で判定し、書ける項目を道連れに送って行単位か項目単位かを切り分け、計算値と入力を見分けて『値の所有者』に書く、までの手順とチェックリスト。
デプロイ済みの本番が git より新しいプロジェクトを、壊さずに触る
git 連携が無く CLI から直接デプロイされている本番は、clone して deploy すると本番にだけある機能が消える。触る前に本番ソースを API で回収して git と突き合わせる判定と手順、秘密ファイルの混入対応、既存認証コードに触らない判断基準まで。
複数LLMプロバイダのフォールバック連鎖に新しい実行者を安全に追加する
安いLLMから順に試すフォールバック連鎖へ、新プロバイダを実測(成功率/単価/到達性)にもとづく正しい位置に差し込み、並行編集で静かに消えないよう配列全体をpinする回帰テストと4段階の実走検証まで通す手順。
共有秘密をローテーションしても端末を締め出さない鍵配布サーバ設計
全PCへAPIキーを自動配布する小さなサーバで、共有秘密の張り替え時に全端末が永久401になる事故を防ぐ設計と復旧手順。primary/legacy/enrollの3層認証、クライアント側の上書き更新分岐、ローテーションの正しい順序と実測方法
CLIをラップしたMCPサーバが上流の無料枠終了で死んだらREST直叩きへ寄せる
外部AIのCLIを子プロセスで起動するMCPサーバが認証終了・旧モデル固定・機能別の枠切れで死ぬ。原因を4層で切り分け、ツール名を変えずに実行部だけRESTへ置き換える手順と、接続緑・テスト緑では足りない検証方法。
AIの記憶インデックスが読み込み上限で黙って切られる問題の検出と恒久対策
MEMORY.md 型の索引はサイズ上限で無言に切り捨てられる。バイトで測る→一行要約を本文へ移送→種別プレフィックスの二重持ちを外す→別実装で不変条件を検証、までの手順。最大の罠『デフォルトブランチに入れた≠各マシンで動く』の潰し方付き。
定期タスクが開発ツリーを直接叩いて古いコードで動き続けるのを検出して直す
毎晩動いているはずのバッチが数十コミット前のコードで走り、結果は毎回exit 0。専用クローン+同期ラッパへ張り替え、失敗注入と時間帯ゲートの罠まで含めて検証する手順。
AIの出力を止めるゲートhookが誤爆した時の直し方
テキストマッチで応答を止めるhookは必ず誤爆する。真因の特定(Markdown表が1ブロックになる/引用を実物と数える/満たしようのない要求)から、最小の例外の切り方、過小検知に変えないテスト、配布先まで見る完了判定まで。
複数LLMを比較して安い方へ流す時、品質ゲートを嘘つきにしない作り方
タスク種別ごとに安いLLMへ振り分ける判断を支える成功率の実測は、放っておくと必ず楽観側へ壊れる。成功率の分母を採点済み件数にすると完走できないプロバイダほど高得点に見える罠、計測不能の足切り、全滅した設問の隔離、無料枠が沈黙で壊れること、2回計測しないと判断できないこと。実運用で3プロバイダが過大報告されていた事例の一般化。
OTA連携で「1室だけ予約が来ない」を3層に分けて切り分ける手順
サイトコントローラー経由の予約ゼロを、①自分側のマッピング ②OTA側の掲載状態 ③実際に送っている在庫・価格 の3層に分けて実値で確定させる読み取り専用の手順。マッピング欠落と決めつける誤診、集計窓による錯覚、先頭数行での早合点、取れなかった実表示の扱い、金額を添えた優先度づけまで。
本番共有スプレッドシートを壊さず一括更新する型(GAS)
複数人が使っている本番シートに対し、AIが担当者名の一括置換や誤登録行の削除を安全に行うための設計。dryRun→照合キー付き適用→独立read-backの3段と、GASのコード雛形・実際に踏んだ落とし穴つき。
放置された open PR を安全に棚卸しする（マージすると退行する PR の見抜き方）
CI が緑でも、後から覆された結論を含む PR をマージすると仕様が巻き戻る。使い捨て worktree で残差分ゼロ判定・陳腐度の数値化・退行検知を行い、マージ/クローズを機械的に振り分ける手順。read-back とクローズ根拠コメントのテンプレ付き。
コードから事実検証済みマニュアルを作る段階分けパイプライン
抽出→検証→読者層適応→文体統一を別モデル・別チェックに分離し、ハルシネーションとプレースホルダー化を防ぎながら安価にマニュアルを生成する手順
定期実行が「手動なら動く」まま何週間も止まっているのを見抜いて直す
GitHub Actions の schedule だけが 403 で全滅しても手動実行は成功し続けるため気付けない。--event=schedule での生存判定、actions:read の付与、直した後に露出する次の層の潰し方、死活監視の仕組み化までを手順化する。
Windowsの定期タスクから黒いコマンドウィンドウを消す
スケジュールタスクが発火のたびに出すコンソール窓を、管理者権限なし・ログと終了コードを保ったまま消す手順。wscript.exe経由の中継VBS、検証手順、適用してよいジョブの見極め、落とし穴の一覧まで。
OTAの予約が急に止まった原因を公開クチコミの日付分布で切り分ける
宿泊施設のOTAで受注が急減した時、重複掲載・競合・値上げのどれが引き金かを、公開クチコミの日付分布だけで潰す手順。Booking.comの実測済みDOMセレクタ、ページ送りが止まらない罠、代理指標の検算方法、exit codeでの機械判定つき。
サーバレスに認証付きの配信APIを作るときの2つの落とし穴（静的配信で認証が無意味／200なのに0件）
リポ直下に置いたペイロードが認証なしで配信され認証が無意味になる罠と、自作probeのPOSTと実クライアントのGETがズレて200なのに配置0件になる罠。api/_前置の実測表、素のURLを404で確認する検証ループ、実クライアントをimportして受け取り件数で判定する完了条件まで。
機能を封鎖したら相乗りの検証も死ぬ — 未検証のゼロを画面から追い出す
危険な機能を後から封鎖すると、同じフラグにぶら下がっていた検証処理が道連れで死に、ツールは未検証のゼロを『確認した結果ゼロ』の顔で出し続ける。実例では1週間、12件ぶんの嘘の警報を出していた。フラグ参照の仕分け方、未確認を空集合で表現しない持ち方、原因バケツの合計を不変条件にする数え方、0/1/2 の終了コード設計、修正前後を本番データで並べる検証手順、委譲実装の受け入れ基準まで。
Googleドキュメントを AI に作らせる時の落とし穴 — 本文は更新できない前提で設計する
MCP等からGoogleドキュメントを作る運用で踏む4点（本文更新手段が無い/Markdown記号のエスケープ/サイズ値で成功判定できない/大きな読み返しはローカル保存）と、最初から決めておく6つの設計。
委譲した実装を「本番で起動される環境」で受け入れ検証する
AIに実装を委譲するとテストは緑で返るが、それは委譲先の環境での緑でしかない。WSLとネイティブなど実行環境が2つあると片方でだけ通るコードが生まれ、本番へ配線した日から静かに失敗する。本番の起動経路で受け入れ検証する型と、環境差で死ぬ定番3つ、破壊的ツールの追加ゲート4つ。
スプレッドシート集計業務をNext.js+Supabaseアプリへ段階移行する設計指示書
運用中のSheets業務を止めずにWebアプリ(DB正)へ段階移行。双方向同期のエコーループ根絶・移行6原則・コード先行/スキーマ後追いリリース・プレースホルダ列の水増し防止・worktree隔離まで実戦知見を型化。
「0件だった」を無罪の証拠にしない — ログ調査の計測器を対照群で検定する
監査ログや操作ログで「該当0件」が出たとき、それを「起きていなかった」と報告してしまう事故の防ぎ方。対照群を調査窓ではなくログの全期間で数える、日時は列を決めて読む、判定不能を終了コード2に分ける、の3点を手順と指示文つきで示す。
文字化けの復元可否を1回で判定する
latin1/utf8往復デコードのtry/exceptだけで、復元可能なmojibakeか不可逆なバイト欠落かを即座に見分ける手順