巻物を探す
344件の巻物
X(Twitter) 予約投稿Bot 開発指示書
スプレッドシートに書いた投稿文を指定時刻に X へ自動ポストする Bot を AI に作らせる MD。API v2 の無料枠制限・画像添付・スレッド投稿の対応込み。
Next.js + Supabase + Vercel 立ち上げ完全自動化MD
新規Webサービスの立ち上げ (GCP/GitHub/Vercel/Supabase のプロジェクト作成〜環境変数〜本番デプロイ) を AI に一気通貫でやらせる指示書。人間の作業はログイン1回だけ。
Google スプレッドシートの数式・外部参照を xlsx エクスポート＋openpyxl で AI に監査させる（開放範囲の切り詰め表示の罠つき）
数万数式・多数の IMPORTRANGE を持つスプレッドシートを読み取り専用で丸ごと解析する手順。DUMMYFUNCTION の復元、開放範囲が xlsx で切り詰め表示される罠をキャッシュ値の再計算で見抜く方法、QUERY の列対応、バインド GAS を直す前に clasp pull する理由まで。
Codex CLI が WSL 経由でだけ 401 token_revoked になる時の復旧（ブラウザ再ログイン不要）
Windows と WSL で別々の auth.json を持つ Codex の片方だけが失効した時の切り分け2コマンドと、生きている側の認証を安全にコピーして復旧する手順
Codex 委譲の指示書で「シェル禁止」を書くと変更ゼロで止まる — テンプレと差分ベースの成否判定
Claude→Codex の指示書に受け渡し規約の『シェル禁止』を転記すると Codex が確認待ちで止まり exit 0・変更ゼロになる。原因・指示書テンプレ・exit code でなく git diff とテスト件数で成否判定する手順。
検証したのに何も検証していなかった — 定期実行の反映を3層でexit code判定する
cronやバッチの反映確認が空振りする2つの型（exit 0だけ見る／ツールが既定ブランチに無い）と、A実行・Bデータ・C実表示を1本に繋いで機械判定するスケルトン。対照を入れて別要因の混入も検知する。
Node CLI が黙って exit 13 で止まる — ESM の動的 import 循環をテストで止める
トップレベル await の CLI と動的 import の循環で起きる exit 13 の原因・直し方と、循環を CI で検出する node:test 一式
「エラー番号しか出ない」Next.js 本番不具合を、本番を壊さずに原因まで追い詰める
Next.js の error digest だけが出る本番障害を、書き込みゼロの再現・スキーマ読み取り・hidden input required の罠の3点で特定し、Server Action から throw を無くして二度と番号だけにしない手順
X(旧Twitter)自動投稿を従量課金時代に立ち上げる手順書
無料枠廃止後のX APIでGitHub Actions定期投稿を構築する。403を生む権限変更とトークン再生成の順番、リンク有無で13倍変わる単価の正しい見積り方、鍵を人に中継させない投入スクリプト、送信前ガードまで。
Windows で AI エージェント/Node が exit 3221226505 で突然死する時の診断手順
0xC0000409 の原因を「コミット制限枯渇 / libuv / V8 OOM / ネイティブモジュール」に根拠付きで切り分ける実測手順。誤診しやすい WER の読み方2点と、逆効果になる NODE_OPTIONS 対処の戻し方まで含む。
従量課金 SNS API の送信前ガードを実装する手順（X/Twitter 例・誤検知の教訓付き）
1投稿ごとに課金される X API で、壊れた本文(空文・280字超・プレースホルダ・文字化け)を送信直前に止めるガードの実装・テスト・CI・本番確認の全手順。裸の TODO が本文の普通語を誤検知した実測と回避策、委譲時に防護解除を禁止する1行を含む
X API 従量課金で「リンク付き投稿13倍」を避ける — 本文URL除去とプレ送信ガード
X APIはリンク付き投稿が/usr/bin/bash.20と13倍高い。未投稿キューのURLを一括除去してプロフィール欄リンクに集約し、送信前にURLを検知して止めるfail-closedガードと生成プロンプト修正まで一式
Vercel「pushしても反映されない」の見えない原因とNext.jsビルド検証の穴
VercelプロジェクトがlinkされていてもGitHub App未インストールだと自動デプロイされない。直し方と、tsc PASSがnext buildの成功を保証しない落とし穴、Playwrightのrole=alertがNext.js内部要素と衝突する罠も併記
依存ゼロのMCPサーバを作り、npm公開に詰まってもnpx github:で今日から配る
自作ツールをAIエージェントから使わせるMCPサーバを依存パッケージゼロで実装し、npm公開が2FA制約で止まっても配布を成立させる手順。JSON-RPC自前実装の要点4つ、二刀流bin、.mcp.json自動登録、実ハンドシェイク検証、そしてbinの./で公開物が壊れる罠まで。
DB型サイトを「一覧だけ会員限定・個別ページは残す」に切り替える指示書（Next.js App Router）
自社DBで集客していたサイトが競合のリスト抜き取りに気づいた時の改修手順。名前が並ぶバルクな一覧だけを会員限定にし、個別ページはtitle/H1とCTAを残す。ItemList JSON-LDやsitemapの漏れ、force-dynamic化のコスト副作用、Layer1(HTML)+Layer2(Playwright実描画)の受け入れテストまで含む。
AIの応答を止める番人hookを1ランナーに統合し、書き直しを最大1回にする（誤爆率をfixtureで先に測る）
Stop hook を9本積んだら Stop の65%が書き直し・最多ゲートの91%が誤爆だった。誤爆測定→否定文除外→1プロセス合流→再試行上限統一→全PC移行→KPIで効果確認までの手順。
配布したhookがWindowsで静かに死ぬのを塞ぐ — process.exit と top-level await
AIエージェントのhookが「出力は正しいのに反映されない」形で無効化される真因と、ネットワークに依存しない回帰テスト・変異テストの型
社内アプリの不具合報告に「対応したら本人の Discord へ返信」を付ける（Next.js + Discord Bot）
報告者を名簿から選ばせて Discord ユーザーIDを確定し、対応完了時に Bot が本人へ DM を返す。二重送信防止・DM不可の可視化・特権インテントの有効化と本番検証手順まで。
社内名簿シートから選択式スタッフ入力を作る — メールをブラウザに出さない Next.js 設計
認証なしの公開業務アプリで、手入力の氏名を名簿由来のプルダウンに置き換えつつ、個人情報をクライアントへ配らない設計と検証手順。Server Component で {id,name} だけを渡し、サーバが id から氏名とメールを解決する。配信物へのメール混入を grep で実測する検証と、実際に踏んだ落とし穴7件つき。
Square の決済データを月次集計して Next.js のトップに売上ダッシュボードを出す
Square Payments API をページングして JST で月次集計（COMPLETED・返金控除）、30分キャッシュ＋stale フォールバックの API、スマホ向け進捗カードと月別表。生成AIが実際に出したバグ2件のレビュー観点と本番検証手順つき
Node.js ESM の CLI が無言で exit 13 — 循環 import × top-level await デッドロックの診断と修正
テストは通るのにCLI直接起動だけ止まる原因（TLAで待つエントリへ動的import先が循環import）の確認手順・コード無変更の回避策・恒久修正・スモークテスト
WSL/Codex導入がBIOSで止まる原因切り分け
wsl --installが失敗/停止したとき、ネットワーク起因・管理者権限不足・BIOS仮想化無効のどれかを切り分ける診断コマンドと自動化エージェントとしての対処方針
MCP サーバーを npm 公開せずに GitHub 直接指定（npx github:）で配布する
npm publish が 2FA/権限で止まった時に、LP・README・init・テストの導線を github: 指定へ寄せ、push 漏れとキャッシュに騙されない検証まで含めた手順
スプレッドシート集計業務をNext.js+Supabaseアプリへ段階移行する設計指示書
運用中のSheets業務を止めずにWebアプリ(DB正)へ段階移行。双方向同期のエコーループ根絶・移行6原則・コード先行/スキーマ後追いリリース・プレースホルダ列の水増し防止・worktree隔離まで実戦知見を型化。
定期スクレイピング→Googleスプレッドシート自動集計MD
競合価格・在庫・ランキングなどを毎日自動取得してスプレッドシートに蓄積するバッチを AI に作らせる指示書。robots.txt 尊重・レート制限・差分検知のベストプラクティス込み。
複数PC・複数AIへ設定と秘匿値を配る仕組みの作り方（静かに壊れる7つの型）
AIエージェントを複数台運用する時の配布系(ルール・hook・スクリプト・APIキー)が、例外もエラーも出さず無言で死ぬ7つの型と潰し方。symlink判定・取得失敗の巻き添え・async内process.exit・設定JSONのBOM・秘匿値の捏造・過剰権限・鍵ローテーションで全台死亡。検証手順6つ込み。
LLMで既存スプレッドシート明細の更新案を作る — 本番で壊れない7か条（GAS）
議事録・メールからLLMに明細の更新案を作らせ、元シートの複製に元の行位置で書いて値貼付で反映できる形にする。rowIndex突合・行位置保持・空ブロック除去・非致命read-back・顧客文ガードなど本番6回で確定した設計
安いAIレーンが壊れたまま何週間も放置される問題を、ヘルス判定と応答ゲートで潰す
委譲先AI(Codex等)が環境要因で落ちても監督AIがフォールバックで作業を続け、故障が放置される。ヘルス判定のseverity設計・失敗の誤分類・応答ゲートの軽い免除を直し、修理報告を機械検査で必須化する手順。WindowsでCodexのWSL経路を管理者権限なしで復旧する実測手順付き
freee会計API 取引先自動連携ガイド(OAuth/トークンローテーション/DRY-RUN)
Next.js+SupabaseアプリからfreeeのOAuth接続・refresh_tokenローテーション対応・取引先の自動紐付け/新規作成をDRY-RUN安全に実装する手順
無人AIセッションのバックグラウンド委譲が静かに殺される事故を潰す
ヘッドレスで起動したAIエージェントがバックグラウンド委譲した子プロセスは、ターン終了で kill されるのに親は exit 0 を返す。機械的に deny するフック、通知の作り方、対応中フラグの戻し忘れ、Windows製worktreeがLinux側から解決できない罠までを含む恒久対策。
無人自動化が「成功ログを出して何も起きない」3つの理由（Windows・外部CLI経由でURIを撃つ型）
exit 0 を返して実際には何も起きない無人ジョブの3つの構造的原因と回避策。cmd.exe が未引用の & でコマンドを分断して一部パラメータだけ消える／spawn イベントは配送完了ではなく親が先に終了して届かない／更新したプラグインは再読み込みまで旧版が動きディスク版で分岐すると恒久的に詰む。2信号ゲートと判定表、end-to-end を実行できない時の誠実な報告の型まで含む。
配布したツールが各PCで本当に最新版か検知する（版ドリフト検知）
全PCへGit経由で配るCLI/hookが「マージ済みなのに端末だけ旧版」で静かに止まるのを検知する。ツリーAPIのblob SHA照合、Windows CRLFで全滅しないindex SHA比較、ローカル編集と配布失敗の切り分け、await追加でprocess.exitが落ちる罠まで。
AIエージェントの会話ログを実測してトークン費用の発生源を潰す
会話ログを走査して「contextに貼られた一括データ」を増幅後トークンで順位付けし、最大の1件を要約ツールへ置き換える手順。実測で入力23,209→774tok(96.7%削減)。検出器が陥る罠2件と、圧縮率を守る回帰テストの型つき。
高額モデルで走り続けているセッションを hook に自己検出させる（Claude Code）
セッション内で /model 選択した高額モデルは既定モデル設定でも PreToolUse でも止まらない。hook stdin の transcript_path で自セッションのモデルを読み、毎ターン警告を注入する型。全読み禁止・async exit・realpath 起動判定・BOM の落とし穴と、集計側に発生元セッションIDを載せる改修まで。
スプレッドシート実行パネルの結果セルを必ずクリック可能にする(GAS)
GASでシートを操作パネルにした時、生成物リンクがセルに出ず別シートを探させてしまう問題の潰し方。URLキーの総なめ収集・RichTextで複数リンク・過去分の埋め戻し・再構築で消える罠・全走査で6分制限に当たってトリガが死ぬ罠まで。
Drive を AIルール共通ハブにする配布・統合同期
AI(Claude Code 等)のルール/スキルを Drive の1フォルダで正本管理し、pull(全員へ配布)と merge(inbox投稿を正本へ統合)の2モードで同期する仕組み。download_file_content 必須・latest-by-title・manifest 版管理など Drive コネクタの罠と対策込み。
無人のAI委譲が「毎日成功」の裏で全滅する3つの穴と塞ぎ方
受け取りファイルの置き場所・上限エラーの保留化・作業種別の振り分けで、Codex 等への無人委譲が静かに全滅するのを防ぐ。完了の定義は実環境1件の成功ログだけ
内容は同じなのに PR が CONFLICTING — CRLF 混入の見かけ上の衝突を修正を壊さず解消する
別コミットの改行コード変更で PR 全体が衝突に見える問題を --ignore-all-space で判定し、rebase -X renormalize で元の修正だけを乗せ直す手順。検証コマンド、.gitattributes での再発防止、複数 PR を worktree で同時に扱う時の罠と報告文の型まで。
エージェント型の委譲が全滅したら「API 直叩きのファイル単位生成＋許可リスト書き出し」で実装を通す
Codex/gemini-cli/安価 agentic ランナーが全部落ちたとき、Chat Completions を1回叩いてファイル全文を出させ、許可リストのパスだけ書き出す。18ファイルを4並列・約$0.02 で通した実測と gen/split スクリプト、検品の要点。
外部サイトの「異常」を報告する前に計測器を対照群で検定する
自社の掲載が検索に出ない・売切表示になる等を疑ったとき、対照群をツールに実装して測定不能をexit 2で止める手順。UA未設定で空ページを掴む罠、分母が列挙可能かの見方、履歴のない画面で「いつ落ちたか」を測らない原則つき。
値下げが元を取れたかを RevPAR で判定する（宿泊・OTA運用）
稼働率だけ見ると値下げの評価を必ず外す。予約明細だけから RevPAR を出し、前年側のイベント汚染を外し、shift-share でチャネル構成変化と自単価変化を分離して、値下げが元を取れたかを exit code で機械判定する手順。
MCP stdio サーバが Windows で「接続済み」のまま死んでいるのを見抜く
MCPサーバ一覧が緑でもツール呼び出しだけ spawn ENOENT で死ぬ故障の3層構造と、initialize/tools-list/tools-call を層ごとに実測して証明する手順。npx形式が作る初回だけの接続タイムアウト、設定スキーマ移行による静かな認証無効化、自動修復コードが鍵を空文字で潰す罠も含む。
翌朝のバッチ結果で判定するゲートを朝を待たずに閉じる
夜間バッチの変更を明朝のレポートで確認する宿題を、--dry と出力先差し替えで当日中に判定する型。出力先を入力として読む前日比の処理が黙って壊れる罠と、grep exit 2 を0件と誤読しない判定手順つき。
商品画像を無料素材+社内スライドから量産し目視検証してECに反映するパイプライン
pptx埋め込み写真の抽出とOpenverse CC0素材取得の2経路で商品画像を低コスト調達。コンタクトシートで1枚ずつ検証。curl配列引数・1〜2語クエリ等の落とし穴込み
GAS Web アプリの画面をブラウザ操作なしで検証する（google.script.run 偽装・差し込み値置換・Sheets API 無効でも gviz で実データ）
ログイン必須の Apps Script Web アプリでも、index.html を Chromium で実描画して DOM を assert できる。偽 google.script.run は head に埋め込む（addInitScript は setContent で走らない）、サーバー差し込み値の置換、file:// が要る条件、Sheets API 無効時に OAuth トークンだけでタブ別 CSV を読む URL、書き込みはコマンドキューで read-back。
毎晩「消化している」つもりのバッチが同じ先頭N件をやり直しているのを見抜いて直す
残タスク一覧を無人バッチが上から消化する構成で、完了の書き戻しが未配線だと毎晩おなじ先頭N件だけが回り、以降に永久に到達しない。エラーもログも出ない。スケジューラの3項目で「新設定の初回はいつか」を確定し、書き戻しの2つの壊れ方（探索スコープのズレ／dead export）を検査し、runner側で機械的に書き戻す配線と、実データで no-match 0 を確認する検証手順まで。
SSGサイトへ商品を一括投入し、CC0画像を安全に付けて一覧まで反映させる指示書
Next.js App Router + DB の商品カタログにスクリプトで商品をまとめて追加する手順。Openverse CC0画像の実用的な取得・目視選別、透かし/他社ブランドの排除、そして「詳細は200なのに一覧が古い」静的生成の罠と revalidate の正しい発火方法、Layer1/Layer2 の検証まで。
AIが「報告された不具合」を否定する事故を Stop hook で機械的に止める
ユーザーが見たエラーをAIが『問題ありません』と否定して調査が止まる事故を、応答検査の3ルール(報告の否定禁止・証拠とベンダーの一致・到達不能な証拠は同じメッセージで依頼)で潰す。実際の事故文面をfixtureにする検証手順つき。
無人ジョブの「安いAIへの委譲」がWindowsで毎晩空振りする事故を潰す（spawnが.batを起動できない）
夜間の無人ジョブで「実装は安いモデル、失敗時だけ高いモデル」の二段構えを入れても、Windowsでは PATH上のCLIが.batラッパのため spawn が ENOENT で即死し、安い側が一度も起動しない。0.0x秒/出力0という失敗の署名で犯人を確定させ、実行ファイルの絶対パスを解決する純関数（shell:trueを使わない・.batを候補にしない・版はディレクトリ名で比較）を入れる型。あわせて「起動できない機体」と「起動したのに空」を台帳で分けて直せない宿題の自動起票を止め、force上書きで配られる共有ツールへの修正を冪等な再適用＋依存ジョブ前の予約実行で守る。
WSL が「ディストリが無い」ように見える時、疑うのは導入状態ではなく滞留プロセス
wsl --status は即答するのに wsl -e が無限ハングする非対称が誤診を生む。真因は滞留した wsl.exe クライアント。切り分け・復旧・時間制限付き呼び出し・PATH interop の罠まで。
GAS Web App の「直したのに反映されない」を構造的に潰す
clasp push だけでは /exec に反映されず、--deploymentId 更新は成功表示のまま古いコードを配信し続ける。push→新規デプロイ→認証URL差し替え→疎通確認を1本化する型（PowerShell 5.1 の落とし穴込み）
GASウェブアプリの画面をjsdomで検証する — 単体テストでは原理的に見つからない画面バグを捕まえる
GASの画面JSはブラウザ無しでは検証できず、単体テスト全pass・API正常・データ正常のまま主要導線が死ぬ。Index/Style/Scriptを連結してjsdomで実行し、実データを流して要素の有無とボタンの活性まで自動判定するハーネスの作り方。
公開ページの総額から料金の階段（閾値と単価）を逆算し、変更の前後を対照群つきで判定する
管理画面の設定値ではなく客が見る画面の総額から料金構造を割り出す計測器の作り方。両端2点で割ると実在しない単価が出る罠、同名別商品の取り違え、取れなかったを0と混同する罠を潰し、前後比較は中央値＋対照群で exit 0/1/2 に落とす。
テストが全部緑でも検出器は死んでいる — 変異テストでテストの検出力を機械的に検定する
hook/gate などの検出器を無害化した変異体に同じテストを流し、通ってしまうテスト(=検出力なし)を摘発する。実測で34本中2本が該当。node --test の子プロセスが NODE_TEST_CONTEXT 継承で失敗を exit 0 にする罠と、sha256 台帳で未検定を止める hook まで。
大きいGoogleスプレッドシートをAIに全件読ませる（自然言語の書き出しは黙って切られる）
行数の多いシートはコネクタの自然言語書き出しだと途中で切れ、AIは成功と報告する。xlsxをbase64で取りZIPとして自力で開いて全件取り込む手順と、部分一致の誤ヒットを止めるガードまで。
reCAPTCHA のあるサイトを AI に何度も読ませる：ログイン窓をセッションから切り離して常駐させる
Playwright の launchPersistentContext は親プロセスが死ぬとブラウザも死ぬため、AI エージェントのセッションが変わるたびに人が reCAPTCHA を押し直すことになる。detached 起動＋CDP 接続、プロファイル固定とログイン保持、管理者権限を使わないログオン常駐の3層で解消する手順。exit code 契約と、実際に壊して確かめる検証手順つき。
起動時フックが増えすぎてエージェントが立ち上がらなくなるのを直す
Claude Code が全タブで 'Subprocess initialization did not complete within 60000ms' を出すのは認証でもネットワークでもなく、起動時フックの合計時間超過。合計の測り方、timeout を削らずに裏回し／cache-first で減らす型、npx 起動の MCP が 30秒タイムアウトする件、そして『速くなった理由』を取り違えないための検証まで。実例 93秒→18.7秒
ログオンしただけでIDEが開きAIエージェントが走り出す状態を作る（Windows/VS Code）
毎朝ターミナルを開いてエージェントCLIを打つ手間をゼロにする。folderOpenタスク+スタートアップ.lnkの構成に加え、素直に作ると必ず踏む3つの「エラーを出さずに何も起きない」失敗（8.3短縮名がワークスペース判定を壊す/サンドボックス下はexit 0を返すのにGUIが起動しない/Restricted Modeが自動タスクを無言で止める）と、プロセスの祖先で成否を判定する検証法まで。
文字化けで宛先が決まらない1件がキューを永久に詰まらせるのを直す
自動処理キューで宛先解決に失敗したアイテムは「失敗」ではなく「スキップ」になり、exit 0 のまま毎晩リトライされ続ける。詰まりの検出、化けた文字列から元テキストを同定する指紋照合、壊れにくい第2キーへの許可リスト型フォールバック、そして「対象外にする」出口までを実例で通す。
定期タスクが開発ツリーを直接叩いて古いコードで動き続けるのを検出して直す
毎晩動いているはずのバッチが数十コミット前のコードで走り、結果は毎回exit 0。専用クローン+同期ラッパへ張り替え、失敗注入と時間帯ゲートの罠まで含めて検証する手順。
Airbnb ホスト画面の閲覧数・成約率を、ログイン済みの常駐ブラウザから自動で読む（クリックなし・JSON 化）
ホスト実績ページ（閲覧数・成約率）を CDP の常駐ログイン窓から読み、掲載別の JSON にする手順。本文の4行構造・下位10件しか出ない表の詳細ページ補完・browser.close 禁止などの安全規則・実ページ本文を fixture にする検証まで
AIエージェントが突然死する時の切り分け — アプリのバグかOSの資源枯渇か
exit 3221226505 の原因をイベントログとコミット率で5分で確定させる手順と、直し方を非エンジニアに1クリックで渡す型
google.script.run の null が undefined になる罠 — 本番だけ出る NaN 表示の自動検出
GASウェブアプリでサーバ側の null がブラウザで undefined になり、=== null の分岐が素通りして NaN が表示される。単体テストでもJSON fixtureでも再現しない理由と、null を落とした fixture で描き直して自動検出する方法。
AI開発ノウハウをチーム共通ハブへ投稿する型
セッション中に得た AI コーディングのルール・失敗パターンを、Drive の追記専用 inbox フォルダに定型フォーマットで投稿し、管理者が正本へ統合する仕組み。各人のローカルにルールが散らばるのを防ぐ。機密値の書き方も規定。
自分が管理していない上流ファイルを差し込みで維持する型 — 死んだパッチを検知して retired に移す
上流が更新し続けるスクリプトに自分の修正を当て続ける仕組み。find/marker/replace の4状態エンジン、anchor-missing に専用 exit code を与える警報設計、差し込みの連鎖、死んだ差し込みの retired 化。テストが足りない値を注入していて壊れたコードが緑だった実害と、その塞ぎ方まで。
二重定義を片方へ寄せる挙動不変リファクタを、AI委譲で安全に終わらせる
同じ表が直書きと導出で2箇所にある状態を片方へ寄せる時、テストが緑でも終わっていない。着手前に実データのJSONを保存して機械比較する型と、手写しfixtureが順序違いで偽failを出す罠、導出に変えた後の縮退の決め方まで。
同期で巻き戻る設定を「固定時刻の貼り直し」で守ろうとして失敗する — 状態の検出で駆動する収束に変える
配布物の同期で上書きされる設定にパッチを当て続けたい時、同期の直後の時刻に貼り直しジョブを置くと失敗する。上書き側がN時間ガードで発火するため壁時計時刻が毎日漂うから。時刻でなく「当たっているか」で駆動する収束への作り替え方、no-opを無音・exit0にする理由、本番を触らず対照群で検定する手順、cmdのexit=行が消える罠まで。
監視の想定値を復元せず日次スナップショットの実値で照合する（偽警報の根絶）
動的に動く値（価格・在庫・配信設定）の監視で、想定値に今日の値や計算復元を使うと出る偽警報を根絶する。追記型JSONLの日次スナップショット＋発生時刻以前の最新を選ぶ純関数＋実値が無ければ判定不能(exit 2)で止まる設計と検証チェックリスト。
Windowsの定期タスクから黒いコマンドウィンドウを消す
スケジュールタスクが発火のたびに出すコンソール窓を、管理者権限なし・ログと終了コードを保ったまま消す手順。wscript.exe経由の中継VBS、検証手順、適用してよいジョブの見極め、落とし穴の一覧まで。
OTAの予約が急に止まった原因を公開クチコミの日付分布で切り分ける
宿泊施設のOTAで受注が急減した時、重複掲載・競合・値上げのどれが引き金かを、公開クチコミの日付分布だけで潰す手順。Booking.comの実測済みDOMセレクタ、ページ送りが止まらない罠、代理指標の検算方法、exit codeでの機械判定つき。
AIエージェント同士の非同期メッセージで「未返信」を誤判定しない
受信箱の無出力・exit 0・バウンス通知の3つが重なり、実際は送信済みなのに「N回連続で未返信」と引き継がれ続ける壊れ方。行為ログで1分で潰す手順と、作る側の設計チェックリスト。
offset ページングで外部APIを読むと、取得中に中身が変わって静かに壊れる
ゲートウェイが毎回全文を取り直して offset で切る構成は、取得中に元データが変わると連結が壊れる。rawLength の一貫性検査と丸ごと取り直しで直す手順と、対照群で検定できるテストの書き方（try の中で assert を書かない・先頭が共通の fixture を避ける）まで。
承認を取る設計書は「ひと目でわかる版」1枚を安いAIに下書きさせて先に出す
技術者向けの要求定義・設計書を、スマホで1分で読める1ページに変換して承認の往復を減らす。下書きは安価なLLM、監督AIは禁止語・タグ・375px描画の機械チェックのみ
AIセッションの引き継ぎを信用せず、着手前に実システムを読み戻す
永続メモリ＋引き継ぎファイルでAIエージェントを跨セッション運用すると「完了済みの作業を作り直す」事故が起きる。着手前のexit code判定・古い結論の打ち消し・ロック保持者の設計・非対話時の承認境界の4つの型。
Claude Code の hook が「登録済みなのに毎回死ぬ」のを潰す
Windows パスのバックスラッシュ破損で hook が MODULE_NOT_FOUND で死ぬ。JSON として valid・自己点検が名前の部分一致・失敗しても会話が続く、の3層をすり抜けるので放置される。全hookのパス実在を exit code で機械判定する検証スクリプトと、多層エスケープを踏まない修復スクリプト。
並走するAIセッションが同じ目的を二重着手する事故を止める
複数のAIコーディングセッションを同時に走らせると、同じ引き継ぎを読んで同じファイルを書き潰し、レート制限のあるAPIのクレジットを食い合って両方が429になる。着手前の検知3点セット（mtime／実行中プロセス／git status）と、衝突時に実装を譲る基準、譲った側が仕上げるべき仕事、検証ツールに必ず要る4点（分母・窓の手前・exit code・ページキャッシュ）。
PWA デプロイ即反映 — Service Worker 自動 reload レシピ
PWA のスマホ側で新版が反映されない問題を、SW の VERSION+postMessage+updateViaCache=none+版タグ表示 の3点セットで「デプロイ即・全tab自動 reload」に変える完全レシピ。Next.js/Vite/Vanilla 共通
AEO/GEO 施策の型 — AI検索で自社を推薦・引用されやすくする
ChatGPT/Perplexity/AI Overviewで自社が引用される状態を作る実行手順。JSON-LD/llms.txt/robotsのオンページ、比較メディア掲載、投稿メディア→Yahoo!ニュース→取材誘発、Wikidata/Wikipedia、月次無料の効果測定、落とし穴まで。
営業スライド資料をHTML→16:9 PDFで量産＋写真整備パイプライン
HTMLでスライド設計→Playwrightで16:9 PDF化→実写真とAI画像を混在。ImageMagick無しでDrive/Google Photos取得・HEIC変換・EXIF回転焼き込み縮小・ロゴcanvasモザイク・gpt-image-1生成・Drive URL不変更新まで。固定px設計時の@page一致(フッター重なり)の罠も収録。
GASデプロイ上限20エラーでもpushは反映済み — トリガーはHEADで動く
clasp deploy が20件上限で失敗しても push は通っており、時間トリガーは HEAD を使うので反映済み。/exec だけ旧版。判定と古いデプロイの整理手順
Windows の .cmd に日本語コメントを書くと REM 断片が命令として実行される（ASCII only で防ぐ・判定はコンソール行数）
タスクスケジューラ用の .cmd/.bat に日本語 REM があると cmd.exe が行の断片を命令として実行する。chcp を先頭に移しても直らない。ASCII only にし、非 ASCII 数とコンソール出力行数の2判定で機械確認する手順とテンプレート。
文字化けの復元可否を1回で判定する
latin1/utf8往復デコードのtry/exceptだけで、復元可能なmojibakeか不可逆なバイト欠落かを即座に見分ける手順
Google Meet 自動参加&動画配信Bot 開発指示書
指定した時刻に Google Meet へ自動参加し、動画を再生しながら画面共有する Bot を、Claude Code に一発で作らせる開発指示 MD。朝会の定例動画配信・ウェビナーの自動放送に。
AIっぽくない提案書を作る — ハイブリッド企画書モデル（コードAI組版×画像モデル写真×スライドAI配置参照）
コード生成AIの組版・画像編集モデルの写真合成・スライド生成AIの配置文法を分担させ、経営者の差し戻し3回→0回にした提案書パイプラインの作り方と失敗パターン
受信メール添付を案件フォルダへ自動取込するパイプライン
メールを読むアプリとドライブに書くアプリが別、という現実的な構成で顧客メールの添付を案件フォルダへ無人保存する設計。権限追加を避ける理由、実行時間制限下の予算3本立て、二重の重複防止、base64url/行数上限/変換判定などの実装罠、案件と顧客のマッチング、名寄せは候補提示＋人の承認にする型まで。
スマホ(Remote Control)から即相談できる Claude Code タブを VS Code に毎朝自動で用意する
自作VS Code拡張で公式Claude Codeのコマンド(editor.openLast/newConversation/renameSessionTab)を叩き、名前付きタブをN本自動補充。夜間はWM_CLOSE→再起動で毎朝揃える。--bg/ターミナル経路・タブ0でのnewConversation・SendKeys再読み込みが失敗する実測付き
夜間ジョブ異常を通知で終わらせず自動修復→AI修理PR→人へ引き渡す閉ループ
監視の『検知して通知』の後段に、決定的Playbook→AIコーダーの隔離worktree修理PR→持ち越し→人への3要素引き渡し、を足す実装指示書。argvで指示を渡すな等の実測の落とし穴つき
Discord bot の Administrator を剥がす — 「自分では外せない」壁の越え方
bot は自分の最上位ロールを編集できない。position の測り方、明示 overwrite への置き換え(VIEW_CHANNEL 抜けの検算)、token が読めない上位 bot のデプロイ環境を使う唯一の経路、後片付けまで。
投稿の審査キューを「信頼済みだけ自動公開」で捌く設計（なりすまし穴つき）
審査キューに投稿が溜まったまま埋もれる問題を、信頼済み投稿だけ即公開する形で潰す指示書。無検証のキー発行を信頼判定に使うと第三者が自社メールを騙れる穴と、サーバレスで静的公開棚に実行時公開を足す方法、検証10項目まで含む。
Vercel の Sensitive 環境変数が誰にも読み戻せない状態を作り直さずに解消し、Development 正本＋毎日の差分監視で恒久化する
本番 env が全て Sensitive で共有不能なとき、skip-domain の一時本番デプロイ＋RSA 暗号化で1回だけ取り出し、Development を正本化、env:set 入口と GitHub Actions の parity 監視で再発を止める手順
「人が集まる」告知バナーを画像生成AIで作る — 広告の型＋会場実写を参考画像に、部分修正は edit
エージェントのHTML自作では差し戻され続けた告知バナーを、OpenRouter経由の画像モデルに広告の型と会場写真を参考画像で渡して一発承認まで持っていく手順と指示書テンプレート
GAS完全自動化テンプレ — Driveコマンドキュー方式
Google Apps Script の「毎回エディタで▶実行」を根絶。Drive 経由のコマンドキューで、初回1クリック以降は AI がすべての GAS 関数をリモート実行できるようになるテンプレート指示書。
AIに指示書マーケットを自動参照させ、終了時に自動出品させるMD
開発依頼を受けた瞬間にマーケットの完成済み指示書を検索してAIに読ませ、セッション終了時には汎用ノウハウを自動出品させる仕組みの作り方。全台配布・秘密情報スキャン・実際に踏んだ配布バグ3つの回避込み。
散らばったタスクを1枚に統合し、AIが1件ずつ実行して人が直す「タスク台帳」の作り方
複数の機能やシートに散らばった残タスクを1枚に統合し、人がヌケモレを見て、AIが1件ずつ実行し、人が修正指示を書いて再生成させるループを、無人で暴走しない形で回す設計。冪等なマージ規則、外部送信の自動実行禁止、失敗3回で人手に落とす打ち切り、実行環境の時間制限で中断された場合の扱い、復旧コマンドまで含む。
クラウド契約とプロジェクト所在を1枚のスプレッドシート台帳に自動集約する
複数PC・複数クラウドの「どのアカウントの・どこにある・何のプロジェクトか分からない」を、各PCと中央が自動で書き込む3タブの台帳で解消する。支払い情報を安全に扱う許可リスト設計と、実装中に必ず踏む『成功したのに空』の罠4つ(CLIがstderrに表を出す/Windowsの.cmdシム/GASのファイル評価順/クライアントtimeout≠未達)まで含む。
人間の手入力台帳を壊さずに自動更新する — GAS Web App upsert 設計
各PC/各拠点の点検結果を、人間が手運用しているスプレッドシート台帳へ自動反映する。手入力列とコメントを絶対に壊さない突合設計、タブ/列の解決、並行POST対策、配布シークレットの落とし穴まで。
AI運用ルールを機械的に守らせる hook 設計 — ルール文が守られない本当の理由
チームでAIエージェントを使うと運用ルールが必ず守られなくなる。真因は「読んでいない」ではなく hook がそのマシンで登録されていない/委譲先が沈黙して壊れていること。禁止=実行前拒否・誘導=依頼時の具体コマンド注入・担保=セッション開始時の自己修復の3層、明示例外の短命トークン、warn→blockの段階昇格、BOM/サンドボックス/timeout など失敗が沈黙する罠と、環境依存で落ちないテストの作り方までを実測ベースでまとめた導入手順。
Beds24 経由の Airbnb 追加人数料金は priceRule では変わらない — 本当の設定場所とログイン済み窓からの読み書き
Airbnb の追加人数料金/基本人数は Beds24 の priceRule でも API でもなく管理画面の Airbnb 専用欄(syncroniserairbnbroom)が制御する。&roomid= 無視の罠、コンテンツの確認での読み戻し、CDP 常駐窓で dry-run 既定・部屋照合つきに書くツールの仕様
「そのPCにしか直せない障害」をAIに自分で気付かせて着手させる
特定の1台にしかリポジトリが無い機能は、修正手順を書いても誰にも実行されず放置される。SessionStart hook で当該PCのAIだけに指示を出し、完了後は指示書へ状態を書き戻して再実装事故を防ぐ型。走査の時間予算とセッション跨ぎの再開、メール一致だけの自動承認がなりすまされる理由と署名キー方式、状態問い合わせAPI、鍵の自動配布、no-op通知の抑止まで、実際に94件の滞留を解消した実例に基づく手順。
LINEオープンチャットの投稿を自分のPCに取り込む（トーク履歴エクスポート方式）
LINEのオープンチャットは API も通知転送も塞がっている。唯一通る「トーク履歴エクスポート」を PWA の Web Share Target で受けて全文を蓄積する手順。塞がっている経路の実測結果、実ファイルの正確なフォーマット、全件再取込に耐える冪等設計、失敗検体の保存まで含む。
数式まみれの業務スプレッドシートを、Webアプリから壊さずに編集させる型
ArrayFormula と per-row 数式が混在する台帳を、セル単位 allowlist・dry-run 既定・適用前バックアップ・触っていないセルの数式不変検査で安全に書き換える設計手順。列ごとの数式復元と、テストが緑のまま壊れる典型例つき。
ユーザー投稿の審査を無人化する — 機密は決定的判定・重複はグループで1本に寄せる
投稿キューが人手承認で滞留するサービスを、毎日1回の無人バッチで回す実装手順。機密は正規表現で決定的に落とし、重複は候補出しだけ機械＋LLMには同主題判定と網羅項目の抽出だけをさせて残す1本はコードで決める。ペア単位で決めると残した側が別の組で却下される罠、却下の保存先が無い設計、ストア障害が空データに化けて二重公開を招く fail-open、誤検出で全部却下になる4パターンまで。
スプレッドシートの「○印」で回している業務の滞留を検知してDiscordで督促する
請求書発行・入金確認・書類回収など、現場がシートに○を打って管理している業務の遅れを自動検知し、担当者へDM・責任者チャンネルへ一覧を流す仕組み。集約シートが実は同期していない罠、既存夜間同期に相乗りしてAPIコールを増やさない方法、印パーサの4値設計、段階を直列にすると主目的が隠れる落とし穴、初日フラッド対策、退職者への誤送信防止まで、本番投入で踏んだ罠を全部収録。
スプレッドシートのボタンUIを複数人同時利用に耐えさせる(GASジョブキュー化)
▶チェックで処理が走るシートUIは複数人が同時に使うと予約が黙って消える。1押下=1キュー行+対象ごとにシート分離+claimワーカーで直す設計と、script lockの奪い合い・6分制限・並列検証の落とし穴
公式APIの無い録音サービスから別SaaSへ音声を自動取り込みする指示書
録音クラウドの音声を文字起こしSaaSへ無人で流す構成。署名付きURLがHEADで403になる/URL長制限/jobIdが返っても取り込まれない、という無言の失敗の潰し方と、変換もストレージも要らない中継プロキシの型。
既存スプレッドシートを正本にした業務アプリの列マッピングを壊れない設計にする
現場が使い続けるGoogleスプレッドシートをアプリから読み書きするときの列解決設計。ヘッダ名優先＋列レターfallback、同名列の検出、実ヘッダ診断CLI、検証手順まで。別の列に書き込んで台帳を壊す事故を防ぐ。
既存のGoogleフォームへGASから自動送信し、回答シートでread-back検証する
人が手入力しているフォームを業務システムから自動送信して手作業を消す。entry IDの取り出し、メール収集欄の罠、回答タブはgidで特定、getLastRow()が実データを超える罠、反映52秒に耐える非同期確認、off/test/liveの3段ゲートまで。
Beds24→Airbnb の料金同期が全日程で止まる原因（US0 未満の価格を含む送信は丸ごと拒否）と直し方・検証
Airbnb は1泊US0未満を含むカレンダー送信を丸ごと拒否し、無関係な日付まで凍結する。価格生成側の床を上げ、ホスト用マルチカレンダーで窓外日付を対照群に読み戻す手順。
スプレッドシートに心拍を書く死活監視の6つの罠（0930→930の自動変換・重複行・死活と業務状態の混同）
GAS+シートで作る死活監視で、スロット0930が数値化して偽missingになる・重複行が最新を隠す・業務警告で常時赤になる等を、正規化関数と3分類記録で直す手順
複数PCの Claude Code を結ぶ PC 間メールは「配達済み」と「読まれた」を分ける — 13時間黙って止まった事故からの状態機械再設計
Sheet+Apps Script 経由の PC 間メールで、配達済み≠既読のまま 13 時間止まった事故の真因 10 件と、new→delivered→seen→done の状態機械・宛先完全一致・hook の新着順提示・サーバー側 SLA 監視・ループ遮断・Sheets 型変換の罠までをそのまま実装できる粒度で
Claude Code の auto-memory を複数PC・複数アカウントへ毎日自動配布する（配信口は鍵配布サーバと分離し、認証だけ委譲する）
auto-memory を夜間バンドル化し分割配信、認証は鍵配布サーバへ委譲して全PCへ日次同期する構成と落とし穴
Androidアプリの通知をローカルPCへ取り込む（公式API非対応のチャット向け）
公式APIが無いチャットサービスの投稿を、Android通知経由で手元PCに集める指示書。着手前に『その通知が本当に発生するか』をADBの通知履歴で検証する手順、fail-closedなallowlist設計、個人名を残さない診断ログ、LLM要約の壊れ方と対策までを含む。
Windows定期タスクが同じ秒に起動すると片方が無音死する（隠しランナーの共有ログとcmd >> 排他）
result=1・ログ0行で死ぬ定期タスクの真因が、隠しランナーが全タスクのログを1ファイルに流し cmd の >> が排他で開くことだった件。再現手順・切り分け・ログ名分離と設置先の自己更新・同一秒起動テストまで
社内PCのブラウザ拡張を権限ベースで棚卸しする
「この拡張、危なくない？」を主観で終わらせず、全社の拡張を権限ベースで棚卸しする手順。判定基準、読み取り専用スキャナ、既存点検経路への相乗り、冪等な集約、実POST検証まで。
Claude Code の auto mode classifier に止められなくする — 実測に基づく3段階の根本対策
14日分の拒否を集計し、ルール衝突・cd&&連結・自己変更の3原因に分解。Bash規約とallowルール設計、最小単位の再試行、最終手段のbypassPermissions+deny+hookまで手順化
別アカウントの Claude Code 同士を人の転記なしで直接やりとりさせる（共有メールボックス方式）
組み込みSendMessage/Remote Controlは同一アカウント限定。既存のトークン付きWeb App＋シートをメールボックスにして任意PC間を双方向・2分配達、promptは承諾制で読み取り専用headless実行
無人でGoogle Meetに定時自動参加し音声付き配信
Playwright + Chrome 起動フラグ --auto-select-tab-capture-source-by-title で共有ピッカーを出さずタブ(音声込み)を自動選択し、定時に Google Meet へ無人参加して動画配信する仕組み。コンパニオンモード自動フォールバック・OOM対策(preload=metadata)・在室ウォッチドッグ・タスク登録の文字化け回避まで実運用ノウハウ込み。
配布した自動化が「自分を更新できない」問題の根治と人手ゼロ復旧の3層設計
複数端末へ配ったhook/常駐スクリプトが無言で古いまま止まる原因(凍結コピー・実行シェル差)と、中央キュー/自己修復手順/生存digestの3層で人の操作ゼロで復旧させる設計。実測で踏んだ「緑なのに何も起きない」罠つき。
定期バッチの「全面書き戻し」が新規行を消す事故を、検知・修正・復旧する
スプレッドシートの定期更新バッチが開始時スナップショットを全面setValuesで書き戻すと、その間に挿入された行が無痕跡で消える。間欠的でエラーも出ないこの事故について、真因の確定、競合検知による修正、消えた分の洗い出しと復旧までを一続きで行う手順。洗い出しで必ず踏む偽陽性4類型と、二重照合・dry-run・read-backの型つき。
GAS+スプレッドシートで数値・日付が静かに壊れる3つの罠と回避策
セルの表示形式とタイムゾーンに起因して、例外も出さずにデータが壊れる3パターン(TZ不一致/文字列の日付自動変換/列拡張時の書式引き継ぎ)の回避策と修復手順。単体テストでは検出できない層のバグを早期発見するための3原則つき。
Driveフォルダの資料を丸ごとLLMに読ませる（夜間ダイジェスト+再開可能バッチ）
案件フォルダのPDF/スライド/Office/写真を全部AIに読ませる設計。Office形式は直接読めないのでDrive変換を挟む、直添付+夜間ダイジェストの二層、1実行1チャンクの部分保存で再開、フィンガープリントで課金を止める、自分の生成物を読み直さない、まで実測ベースで記述。
無人エージェントの夜間作業をKPI化する（「完走しました」を成果の証明にしない）
夜間の無人セッションが「N/N完走・失敗0」でも実は過半が空回り、という状態を数字で暴く指標設計。消化率・空回り率・コスト削減効果の3本と、空回り分を削減効果から差し引く理由、実測で機能しなかった指標を棄却した記録つき。
Apps Script ダイアログを本人の Google 承認に依存させない — 「承認が必要です」全滅をWebアプリfetchフォールバックで塞ぐ
bound script のダイアログ内 google.script.run が複数アカウント同時ログインで承認エラーになる構造問題を、文脈のテンプレ埋め込み＋開発者権限 Web アプリへの fetch フォールバック（dedup・CORS・外部オリジン Playwright 検証）で解く
AI コーディング環境を Google Drive へ日次バックアップし別PCでダブルクリック1回で復元する型
Claude Code 等の設定・認証・定期タスク・作業中リポを検証付きで毎日 Drive へ退避し、非エンジニアが別PCで復元する.bat 1回で戻せる仕組み。全PC自動展開と落とし穴込み
アプリ開発の主体を別アカウントの Claude Code へ移管する（権限付け替え＋判断依頼の経路つき）
引き継ぎ書・GitHub/Drive 権限付与・判断依頼プロトコル・カットオーバー条件・途中で移管先を変える手順を1セッションで完了させる型。相手側の人の操作は起動文1回と OAuth 同意1回
チャットとメールを横断して「やること」を優先順位付きでスプレッドシートに集約する
Discord等のチャットと共有メールボックスから改善点・タスク・締切・決定待ちを毎日抽出し、1枚のスプレッドシートに優先順位順で積む。チャットだけ見ると「完了済みを未着手と誤報告」と「本当の締切を見落とす」が同時に起きるため両方を1つの台帳に入れる。Bot権限がそのままカバー率になる罠(実測2.5%)、件名の古い期日に騙される罠、収集だけ作って消化を作らず台帳が滞留する失敗まで含む
無人バッチの「黙った空振り」を発見して止める（冪等取込の設計）
定期バッチがエラーを出さないまま毎回同じ仕事をやり直している状態の検出法・典型的な真因（取込済み集合を実体の単一カラムで持つ）・台帳による修正・打ち切り付き再試行・CI課金での効果実測まで。
Google Drive のフォルダ整理を自動化を壊さず権限事故も出さずにやる
散らかった Drive を片付ける前に確認すべきこと。フォルダ移動は ID 不変なので安全だが、共有フォルダへ移すと権限が黙って広がる。簡易APIは権限を過少報告し、継承権限は子フォルダから削除できない。二重化を起こす名前検索の見分け方と、権限削除スクリプトの安全機構、再発源の潰し方まで。
宿泊ゲストのメッセージ1年分から誤解・キャンセル要因と改善点を週次で自動抽出する
PMS(Beds24等)のメッセージをキャンセル込みで差分取得し、Gemini の map-reduce で誤解を招く掲載文・訴求点・改善点を週次レポート化する手順と落とし穴
スプレッドシートを業務UIにする — フェーズ折りたたみ＋2種チェックボックスのパネル
Google Sheets を現場の操作画面にする GAS 設計テンプレ。工程ごとに行グループで畳み、押すと走る▶と進捗として残る✅を同居させる。可視列とメタ情報の衝突、無言で捨てる保存関数、集計が古い値で固まる順序ミス、6分制限との戦い方まで、実装で実際に踏んだ罠を対策込みで収録。
複数データ源→CIで日次AIサマリー生成→自作PWAへ配信する仕組み
毎朝データ源を横断してLLMに要約・優先順位付けさせ、結果を自作PWAダッシュボードに自動表示。重い取得とLLM呼び出しはシークレットを持つCI側、PWAは結果JSONをingest受信するだけ。CI空変数・本番ビルドstale・dry-run検証の罠つき。
配布したツールが既存端末にだけ届かない障害の診断と再発防止
全PCへ配ったhook/スクリプトが、新規端末では動くのに既存端末にだけ永久に届かない。凍結コピー・拡張子を無視した重複判定・無言return の3重奏で、テストは全green・自己診断もNG 0のまま気づけない。実際に踏んで直した診断手順と、再発を止めるテスト設計(既存端末フィクスチャ/チェックリスト網羅性の機械照合/故障注入)。
Claude Code のログインアカウントを別アカウントへ切り替える（ブラウザ承認1回・auth login が終了しない罠つき）
同じPCで Claude Code の claude.ai ログインを別アカウントへ移す手順。認証ファイル1本の構造、事前棚卸し（env上書き・無人タスク・コネクタ・routine）、非同期ログイン＋status ポーリングのスクリプト骨子、logout が復元不能な点と切り戻しまで。
定額プランの最上位モデルを枯渇させずに使う「二段レーン」設計
5時間/週の枠を桁違いに食う最上位モデルを、長時間タスクと失敗時の昇格だけに自動で当て、上限に当たったら既定モデルへ退避する委譲レーンの作り方。判定は純関数・検証まで含む。
日本語のPC名で vercel login が ByteString エラーで落ちる — PC名を変えずに os.hostname シムで直す
Windows の日本語コンピューター名が Vercel CLI の User-Agent に入り undici が拒否する問題を、NODE_OPTIONS --require の1ファイルで回避。team 複数時の --scope、.env.local 上書き、ブラウザ自動起動の罠つき
一覧が表記ゆれで割れるのを、DBを書き換えずに直す（集計キー正規化＋付け替えUI）
大小文字・全半角の違いだけで同じグループが複数カードに割れる問題を、DBの生値を保ったまま表示側の正規化キーで統合する。集計だけ直してフィルタを直さず「クリックしたら0件」になる最頻出の落とし穴、ページング・候補取得上限の罠、間違ったグループに入った行を後から移す付け替えUIまで含む。
Beds24 で最低泊数のせいで売れない1泊を、隣接ゲストへの延長案内オートアクションで埋める
飛び地1泊を [TURNOVERDAYSB]=1 のオートアクションで延長側だけに自動案内。管理画面をPlaywrightで設定する罠（ID0不可・隠れタブ・マニュアル保存→読み戻し→オート）付き
Discordで社内アンケート送信→回答回収→報告
メンバーマスタから user_id を引き、Discord のチームチャンネルにメンション付きで質問を投稿、リアクション/返信で回答を回収、SessionStart フックで追跡を再開し、揃ったらオーナーに集計報告する秘書スキル。YesNo/選択肢/自由記述の3形式に対応。
高額モデルを相談役に固定し、実行を安いAIへ自動で振り分ける hook の型（Claude Code）
上位モデルを既定にすると上限が倍速で減る原因は本体がツールを何十回も自分で叩く構造(消費の85%は入力側)。依頼をレーン分類して先頭に1行注入するUserPromptSubmit、本体の直接実行を数えて8回で止めるPreToolUse、サブエージェントのmodel省略を止めるガードの3本セットと、その検証・効果測定の手順。
Claude Code 自律ループ(autopilot)の型 — 目的1つで施策生成→実行→記録、人は Discord で判断だけ
目的ファイル+決定的 tick スクリプト+skill+ヘッドレス版の4部品。上限と番犬で自動停止し DM、人は『続けて/止めて』を返すだけ。配布の鶏卵問題と handoff 副作用の回避込み
在庫も価格も正しいのに1件も売れないときの切り分け手順
空室があり値下げもしたのに予約が入らない状態を、値下げに走る前に機械的に診断する手順。販売そのものを止めている設定の洗い出し、セット販売用リスティングを見て『チャネル障害』と誤診する罠、設定変更を success ではなく読み戻しで検証する作法。
スプレッドシートとGAS Web Appを画面操作ゼロで作成・公開し、外部アプリからHTTPで1行upsertする
clasp のトークンだけで、スプレッドシート作成→バインドされた Apps Script 作成→コード投入→Web App 公開まで REST で完結させる手順。DBを契約せず0円で「フォーム入力→通知→表に蓄積→月次集計」を実現する。人手は実行権限の承認1回だけ。未承認とポリシー禁止の切り分け、シート作成直後の未フラッシュで初回だけ壊れる罠、CSVエクスポートがread-backに使えない罠、再デプロイでURLとシークレットを変えない状態ファイル設計、後片付けまで含む検証スクリプトの型を実測ベースで収録。
GAS 新規立ち上げ標準手順(clasp+コマンドキュー)
clasp と自作コマンドキューで、run-function 封鎖の Workspace 環境でも AI から GAS を継続実行できる新規プロジェクト立ち上げ手順。人間の作業は setupOnce の1クリックのみ。ホワイトリスト実行・並走防止・機密値の置き場も規定。
スプレッドシート業務アプリに画面キャプチャ付き不具合報告フォームを付ける(GAS)
GASのOverGridImageにgetBlob()が無くシート貼付画像は読めない。HTMLダイアログでCtrl+Vを受ける正しい設計・記録列マイグレーション・read-back検証・画像を捨てない後片付けまでの実装指示書
LLMの委譲先を「成功率×コスト」で決める eval ハーネス
安いモデルへ処理を移す前に品質が落ちないことを数字で確認する計測ツールの作り方。測定を歪める4つの罠(APIエラー/出力切断/期待値が正解を弾く/テンプレが配布先に届かない)と対策を実測値つきで示す。
GitHub Actions の課金分を実測ベースで削る
Actions の請求を推測でなく実測から削る手順。ジョブ単位の分切り上げという課金構造、ステップ別に時間を割る API の叩き方、短時間高頻度は統合・長時間は per-row 往復の一括化という打ち分け、並列度を上げても効かないケースの見分け方、そして『遅いステップが実は同じデータを毎回処理し直している欠陥』の見つけ方まで。本番の夜間ジョブを実測目的で再実行して重複レコードを大量生成した失敗例と、その巻き戻しの作法も含む。
AIモデルの課金区分を実測で確定し、ルールを機械に強制させる
「このモデルは定額内か従量課金か」を推測で決めると外れる。支出レポートで確定させる手順と、確定結果を単一の設定源+3層のフックで強制する型。安いモデルが実は高い（キャッシュ書き込み）の見つけ方も含む。
GASウェブアプリが「読み込み中」で止まる・遅い — google.script.run の null 化と getValues 往復を計測で潰す
戻り値に Date が混ざると google.script.run が全体を null にする問題を JSON 文字列化で解消し、シート1枚ずつの getValues（1枚0.3〜1秒）を Sheets API batchGet に置き換えて約5秒→1秒にする。切り替え前に本番データで新旧を突き合わせ、日時シリアルの1ms誤差を丸める手順つき
AIエージェントの「委譲率」を正しく測る指標設計
監督AIが実装を安いエージェントへ渡せているかを毎日自動計測する指標の作り方。トークン比が飽和する/分母を landed 行にすると100%に貼り付く/編集ツールだけ数えると逆向きに嘘をつく、の3失敗と対策・増分キャッシュでの高速化まで
fail-open のガードが「必要な場面でこそ効かない」のを設計段階で潰す
抑止・重複防止・レート制限を fail-open で作ると unknown の範囲を広く取りすぎてガードが常時 open になる。ユニットテストは緑のまま機能だけ死ぬ型。unknown と『不在という積極的な証拠』を分ける棚卸し表、3値判定、エラー粒度の分け方、実データで両側を観測する検証手順まで。
安いLLMプロバイダのフォールバック連鎖を本当に着地させる
無料枠が枯れて黙って死ぬのを防ぐ多段フォールバックの設計。失敗コードの2分類・プロバイダのクールダウン・日次上限・全呼び出し側の一本化・テストが実環境を壊す罠まで。
AIコーディングエージェントの費用は出力でなく入力(文脈)が9割 — 測り方と追加費用ゼロの3対策
会話ログから入力/出力の費用比を実測するスクリプトと、高額モデル・肥大セッションを検知するフック(差分読み必須)、常駐ルールの索引化(20,274→5,800トークン)まで。実装で踏んだ落とし穴4件と変異テストの型つき。
同期が「更新しました」と嘘をつく — 配布が届かない2つの欠陥を潰す
設定・ルールの配布処理が成功報告を出すのに実際は届いていない。pullの上流取り違えと、自分が配った旧版を人の編集として保護し続ける2欠陥を、実コミットの差分・テスト・読み戻し検証手順まで含めて潰す。
社内アプリの必須機能を、ルール文書ではなくデプロイ直前の hook で強制する（Claude Code）
「全アプリに○○を入れる」が文書だけで守られない問題を、本番反映コマンド直前の PreToolUse hook で未搭載・台帳未登録を deny して潰す型。除外ファイル・fail-open・全PC配布・テスト一覧つき
アプリ内「不具合・要望」窓口を全アプリへ標準搭載する
利用者がその場で不具合・要望を送れる窓口を、npm依存ゼロ・CSS非依存・DBなしでも動く形で1コマンド後付けする手順。公開サイト向けの濫用対策、2段検証、配布物として崩してはいけない点まで含む。
無人実行ジョブが「働いたのに何も残らない」を潰す設計
cron/タスクスケジューラからAIエージェントや長時間処理を無人で走らせる際の2大事故（タイムアウトkillで出力が丸ごと消える／実行されるコードがその瞬間のHEADで決まる）を構造的に潰す実装指示書。逐次進捗ファイル・待機時間の上限・作成時刻からの実行ID復元・固定worktreeへのpin・完走分だけの後片付けまで、テスト観点と完了条件付き。
CI でだけ落ちるスクレイパの直し方 — WAF/bot判定を疑い、診断→自動復旧まで入れる
定期スクレイパが CI でだけ失敗しローカルでは成功する時の診断手順。失敗履歴の数え方、cookie 名で防御レイヤを特定する診断 artifact の作り方、セッション再作成リトライと部分成功の扱い、そして『IP ベースのブロックにリトライは効かないので実行場所を変える』という実測結論まで。
カレンダー空き抽出＋オンライン/オフライン日程調整秘書
業務カレンダーから空き時間を抽出し、【調整可/不可】マーカー分類・訪問の移動バッファ・拠点/出張の地域判定・オンライン/オフライン別の候補出しまで行う日程調整の型。予定登録の既定値とプレフィックス規約も同梱。
「値が空」と断定する前に実表示をブラウザで読み戻す
API/DBの値ではなく実際に画面に出ている状態を読み戻してから断定する手順。変更の有無を問わず、価格・在庫・掲載文など外部露出状態の調査・報告に使う汎用スクリプト付き。
GASの夜間バッチを必ず完走させる設計(6分制限・再開・作り置き)
実行時間上限のある環境で長時間バッチが永久に完走しない3つの原因(リスト後方の飢餓・入力1件の変更で全チャンク破棄・自分の生成物を再入力)と、台帳による優先順/チャンク単位フィンガープリント/生成物除外での直し方。部分確定と失敗カウンタ期限切れ、検証手順つき。
スプレッドシートの行削除をDBへ安全に同期する（行UUID方式）
シートから行が消えたらDBのレコードを無効化する同期を、実在レコードを誤削除せずに作る手順。内容マッチが失敗する理由、行UUIDと二段確認、8つの安全ガード、書き戻しがUUIDを複製・上書きして欠落判定をすり抜けた実測の失敗パターンと検出コードまで。
Claude Code のセッション一覧を「閉じたら自動で消える」ようにする
C:/Program Files/Git/clear は削除コマンドではない。hook + 閉じた台帳 + 常駐ウォッチャーで、セッションを閉じたら一覧から自動退避（削除せず move）する実装手順と、並行タブ・凍結コピー配布の落とし穴
GitHub Actions の課金分を実測して削る手順（cron 統合ダイエット）
GHA はジョブごとに分単位で切り上げ課金するため、数秒×高頻度の cron が最も割高になる。/timing API で全ワークフローの課金分を実測し、cron 式が完全一致するワークフローのステップへ統合して頻度も処理も変えずに削る手順。schedule は大量に間引かれるため分ゲートでの間引きが成立しないこと、統合すると前ステップの失敗で後続が silent skip されること、予算上限でジョブ未起動になった時の見分け方まで含む。
LLM経由のデータ取り込みを決定論化する — キャッシュが静かに嘘をつくのを止める
AIにAPI結果をJSONへ転記させる構成は、欠落と幻を同時に作り件数の自己申告では検出できない。サービスアカウント+ドメイン全体の委任で依存ゼロの決定論スクリプトに置き換える手順と、読み取り側で「データ無し」と「該当無し」を区別するガードまで。
フリマの中古相場は検索エンジンから見えない — ヘッドレスブラウザでサイト内検索する型
メルカリ等の個別出品は検索エンジンに載らずJS描画のため、WebSearch/WebFetchだけでは原理的に探せず「出品なし」と誤報告される。Playwrightでサイト内検索を実行する2本のツール（探す/読む）と、networkidle不可・スケルトン待ち・価格表記3パターン・ショップ出品の別DOM・横断検索のレート制限といった実測の罠、そして「取得不可を不在に格上げしない」運用ルールをまとめた。
Claude Code の会話ログを自動退避しても VSCode のタブを壊さない（state.vscdb で開いているセッションを検出）
セッション一覧の自動整理で jsonl を動かすと VSCode 拡張のタブが「Couldn't load this conversation's saved history」になる。拡張が state.vscdb に平文で持つセッション ID をバイト検索して、参照中のログは理由を問わず動かさないガードの実装・テスト・復旧手順。
AIエージェントの委譲率を実測して最大の漏れ口を塞ぐ
高価な監督モデルが自分で作業を抱え込む問題を、ルール追加でなく出力トークンの実測で直す手順。推論トークンの誤帰属・指標の逆インセンティブ・強制層の昇格の穴という3つの典型原因と、パイロット限定の段階導入まで。
デプロイ/UI変更を必ず2段検証してから完了報告
コード・デプロイ・cron・env・UI変更後に、ロジック層(Node再現)とブラウザ層(Playwright)の2段でassert検証し、検証済みだけを完了報告させる手順。「画面で確認して」の丸投げを禁止。
Claude Code の「毎リクエスト課金される文脈」を実測して削る
~/.claude/rules/ の .md は paths: が無いと全リクエストに無条件ロードされる。count_tokens API でファイル単位に実測し、常時ロードから安全に外し、配布済みの全端末を自動移行させるまでの手順。早期returnの後ろに後始末を書くと一部端末で永久に直らない、削除でなく移動にしないと全文が消える窓ができる、といった実装上の落とし穴と回帰テスト5ケース付き。実測で 29,295→6,020 tok/req。
無人実行が API を乱打しない設計 — 失敗打ち切りガード実装手順
cron/スケジュールトリガーで恒久的に失敗するレコードが無限リトライされる構造を塞ぐチェックリストと実装パターン。失敗カウンタは試行の前に保存、冪等なリソース生成、復帰コマンドの用意まで。API乱打によるアカウント凍結の予防。
AIに壊させない「変換」の作り方(不変条件とリトライ閾値)
AIに圧縮・移行・整理を任せると『指示どおり動いたのに情報が消える』。IDだけをassertしてタイトルと説明が消えた実例と、人間が読む全フィールドに不変条件を掛ける書き方。あわせて『N回失敗で打ち切り』が試行レート変更で1晩で発動した失敗と、異なる日数で数える実装。
「共有した雛形に書き込めない」問い合わせを消す — Googleフォーム→本人専用ドキュメント自動発行（GAS）
雛形リンク配布をやめ、フォーム入力から本人専用のGoogleドキュメントをGASで自動発行・共有する。原本は閲覧のみのまま、権限リクエストと問い合わせをゼロにする手順とWorkspace固有の罠
本番スプレッドシートの既存セルへ一括書き込みする前に、現況を全件実測して上書き規則を決める型(GAS)
「登録したらこのセルに自動で値を入れて」は、そのセルが空である前提で降ってくる。実際は見出しやマニュアルリンクが入っており、setValue を流すと全レコード分を一撃で潰す。判定を純関数に切り出して dryRun で全件の現況をダンプし、実測結果を依頼者に見せて上書き規則を確定してから書く手順。read-back verify、6分上限の offset/limit 分割、付帯機能の非致命化、Calendar Advanced Service での会議URL発行とスコープ追加時の実測挙動まで。
外部アプリがフォーム連携シートに行を足すと通知が飛ばず埋もれる問題を潰す（GAS）
フォームの onFormSubmit は直接 appendRow では発火せず、挿入行は回答追加のたびに押し下げられ、担当者名も空になる。3症状を「フォーム外の書き込み」という一因で捉え、列マップ確定・通知・名寄せまでアプリ側で完結させる実装指示書。
予約データから『価格が高すぎるのか』を判定する手順（リードタイム・ペース曲線）
先の予約が薄い時に憶測で値下げせず、リードタイム別の実勢単価・過去の同じN日前のペース・提示価格の実表示を突き合わせて外れている帯を1つに絞る手順。在庫の穴の見つけ方つき。
ChatGPTに本当にLPデザインを作らせて、コードへ忠実に落とす指示書
「ChatGPTでデザインして」がAIエージェントで失敗する4つの真因と回避策。Responses APIでスクショ入力＋反復してモックアップを作り、複数画像は1枚のコンタクトシートから切り出してトンマナを統一、生成画像は表示枠の縦横比に合わせてcrop率を数値assert、モックアップ内の架空の数値は捨てる。Playwrightの検証コード付き。
「Driveからファイルを名前で探して画面に貼る」機能が実データで1件も当たらないのを潰す
台帳依存・探索の深さ不足・MIME絞りすぎの3つの落ち方を特定し、親フォルダ走査がドライブのルートを掴む誤検出と、途中で落ちて画面が空になる事故まで塞ぐ。副作用ゼロの診断関数で実データ検証する。
GAS 開発の絶対ルール(clasp統一・キュー・read-back)
.gs/appsscript.json/.clasp.json を編集すると自動適用される GAS 開発ルール集。clasp push 統一、コマンドキュー方式、書き込み後の read-back verify、silent ignore 対策、push 後もトリガーが旧コードで動く罠までを規定。
非公開・preview API を相手にする前に「本当に使えるか」を確定する手順
limited preview の新機能に自動化を賭ける前に、公開ディスカバリ照合・403/404の対照実験によるホスト実在判定・管理画面の項目有無確認で「到達可能か」を一次ソースで確定する9手順。AIが推測でpreview APIを捏造するのを防ぐ逐語コード渡し、実在判定つき防御実装、宣言と実装の識別子照合まで含む。
Beds24→Airbnb で1室だけ「全日予約不可＋定価」になる原因と直し方（基本人数と料金ルールの人数不一致）
Beds24 では空室・価格正常なのに Airbnb で1室だけ予約不可になる症状を、ホスト画面カレンダーの『定価のまま』指紋で切り分け、Airbnb 特定コンテンツの基本人数が料金ルールの人数を超えている原因を確定し、戻して『アップデート』で再送するまでの手順。エラー文言は存在しないので探さない。
複数の AI セッションが同じ Apps Script に clasp push しても互いの反映を消さない
clasp push は全置換なので、古いスナップショットからの push は他人が足したファイルを黙って消す。pull→上書き→push の連続化、別ディレクトリでの read-back、消された側が並行相手の staging に同乗させる復旧手順。
数十GBの動画をGoogle Driveへ確実に入れる（Drive for Desktopが止まった時の直接アップロード）
Drive for Desktopのキャッシュ破損でサイズ0のまま止まる症状の見分け方と、Drive APIのresumable uploadで直接上げてサイズ照合するまでの手順
共有ブラウザで Playwright の connectOverCDP が止まる時は目的タブに直接 CDP で繋ぐ
重いタブがある常駐Chromeで attach がハングする原因と、page ソケット直結で読み書き・保存・読み戻しする手順
鍵の無いPCから共有メールボックスでDriveのPDF添付つき返信を下書き→確認後に送信（GitHub Actions＋ドメイン全体の委任）
SA鍵がGitHubシークレットにしかない環境で、DriveのPDFを添付した返信下書きを作り、人の確認後にdrafts.sendで送る手順。scope不足403と多重run事故の回避つき
Beds24 API v2 で予約を漏れなく取る — 黙って欠ける3つの罠（到着日フィルタ・100件ページング・応答切れ）
Beds24 API v2 の /bookings と /properties は HTTP 200 のまま予約・部屋が欠ける。arrivalFrom は到着日フィルタ、/bookings は100件ページング、/properties は応答切れ。回避コード付き
新しいAIモデルを自動で見つけて採用提案まで届ける（model-scout→eval→提案セッション）
OpenRouter公開カタログの差分で新モデル・値下げを検知し、当日evalで品質を測り、合格した候補を『次に開くセッションの先頭に出る実装提案』として届ける仕組みの設計と落とし穴（reset --hardで消える保存先・衝突PRでCIが出ない・Windowsのfile URL）
freee会計API: 税区分一覧が403でも税区分コードを実測で確定する（控80→控50切替・取引先削除の落とし穴つき）
税区分APIが403のアプリで、テスト事業所に取引を作り仕訳帳CSVで名前を読んで固定表にする手順。非適格の経過措置を発生日で切り替える注意と、取引先は使用停止してから削除する点も。
ハードコードのドロップダウンenumを設定で編集できるDBマスタに移行する
UIに配列でベタ書き＋DB CHECKで固定された選択肢を、利用者が設定画面から追加/編集できるマスタテーブルに一本化する手順。value-keyed分岐を壊さない落とし穴つき
AIエージェントのセッション引き継ぎを自動化する（閉じる→票→開く の3点セット）
長い会話で品質とコストが悪化する問題を、引き継ぎ票1ファイル+スキル2本+フック2本で解決する手順。票の鮮度維持と開始時案内だけを自動化し、commit/メモリ書き込みは人の明示操作に残す設計。実際に踏んだ落とし穴6件(本文言及での誤抽出/並行セッションの票奪い合い/リセット≠削除/検証方法の誤り/BOMと非同期フックの沈黙/常駐プロセスのコード非反映)と、その検証手順つき。
Instagram の自動投稿を AI エージェントに任せる（パスワードを渡さず Meta API トークンを OAuth 1 回で受け取る）
Instagram の ID/パスワードを AI に渡さず、Meta の長期アクセストークンだけを渡す手順。デスクトップの .cmd が通常ブラウザで Meta App Dashboard を開き、貼られたトークンを .env に保存して /me で即検証する。公開URL必須・JPEGのみ・24h 100件・削除不可・60日更新などの制約と、自動化ブラウザ認証でアカウント停止に至った実害も記載。
AIエージェントの記憶インデックスが本当に想起を助けているかをA/Bで実測する
セッション開始時に自動ロードされる索引を厚くするか薄くするかを、隔離プロジェクト2つ+ヘッドレス起動のA/Bで決める手順。サブエージェントでは測れない/共有環境を壊さない/カナリアで検査側を先に疑う、の3つの罠つき。
アプリ内フィードバック→責任者DM→Issue→自動修正PR→1タップ承認
社内アプリの不具合報告を、責任者の個別DMに届け、Issueにして夜間に修正PRまで自動で作り、承認は既存のPR画面のMergeボタン1タップで済ませる設計。通知先を中継1箇所に集約してトークン拡散を防ぎ、既読は通知のリアクションで持ち、絵文字で自分の通知を拾う無限ループを断つ。
本番スプレッドシートに「新しいレコードの列ブロック」を安全に増やす型(GAS)
横並び1レコード=N列のシートに、既存ブロックの複製で新しい列ブロックを自動追加する型。数式の相対参照追従・IMPORTRANGEの絶対URL差し替え・日付セルのread-back照合の罠・本番検証用の撤去コマンドまで。
複数LLMプロバイダの無料枠切れを検知して自動で次候補へ差し替える
安いLLMへ処理を逃がす構成は無料枠が切れると黙って落ち、記録も残らず一番高いモデルへ逆流する。402は即次候補/429のみリトライという分類、課金プールを跨ぐ候補列、失敗も残す台帳、1ホップ1行のログまでの実装手順。連鎖の順番を実測で決める方法（単価最安≠実効最安/ベンチ飽和/正規表現採点が上位モデルを落とす罠）も収録。
セッション途中で認証したコネクタを再起動せずに使う（claude -p 子プロセス＋stream-json 読み戻し）
claude.ai コネクタを作業中に認証したとき、ツール一覧が起動時に確定する制約を子プロセスで回避し、tool_result で送信を検証する手順
クラウド定期実行エージェント＋Drive台帳で小規模施設の集客PDCAを無人で回す（週次レポート／月次レビュー）
Claude Codeのクラウドルーティン（cron）とGoogle Driveの台帳だけで、集客施策の実行・結果回収・次施策の提案を週次/月次で無人化する手順。Doc/CSV変換の罠、Shift_JIS対策、クラウド環境のネットワーク制限の落とし穴つき。
人にログインさせるブラウザ自動化を1回で済ませる（勝手に閉じない・正規Chrome・Cookie判定）
Playwright永続プロファイルで人にログインさせる時、2段階認証途中で閉じる・同梱Chromiumが落ちる事故を防ぐ共通関数とCIガードの型
Claude アプリの Code 一覧に溜まる古いリモートセッションを自動アーカイブする
PC側ログを消しても減らないスマホ/Webの切断済みセッションを、内部APIで24h超のものだけ6時間ごとにアーカイブする hook
MCPサーバーの『最初にこれをやれ』指示が社内ルールより先に効く事故をhookで止める
MCPのserver instructionが memory 確認より先に発火して社内ルールを破る問題を、常時ロード層への昇格・PreToolUse deny・Stop監査の3層で塞ぐ
定期実行の基盤移管で設定だけ置き去りになる不具合を症状から見つけて直す
cronをActionsから別基盤へ移した後、envが移らず通知停止・出力劣化が無音で起きる。診断手順・コード既定値化・secretの一時ワークフロー移送・検証まで
Supabaseで未ログインの人を管理者にし、その画面を本番で機械確認する（PKCEログインでもOK）
初回ログインでusers行を作るアプリで、本人のログインを待たずに管理者を用意し、magiclink→verifyOtp→cookie注入のPlaywrightで管理者画面を検証する手順
GAS Web アプリが「アクセス権が必要です」で開けない時のデプロイ記録破損の診断と復旧
公開設定は正しいのに所有者でも403になるGAS Webアプリを、Bearer fetchの差分比較で切り分け、同versionのPUT再デプロイでURL不変のまま復旧する
別環境で作られた未マージPRを、現行コードへ安全に移植させる
放置された未マージPRは、競合よりも「設定の軸が二重になる」「文書の前提が古い」ほうが危険。AIに cherry-pick させず、設計だけ取り出して現行の語彙へ統合し直させる手順書。実装をAIへ委譲した時にテスト合格のために既存の設計判断が壊される実例と、その受け入れレビュー手順つき。
ログイン必須の社内Web発注システムをCLI化して一言で発注する（確定ゲート付き）
APIの無いログイン必須サイトを curl で副作用ゼロに実測し、check/apply/order(--yes ゲート)/history の4コマンドCLIにする。未確認画面は初回実行でフォーム要素をダンプして学ぶ設計、安いモデルへ委譲する際の再委譲防止も。
ペース連動の値付けで『達成不能な目標稼働』が遠い日付を恒久的に最大値下げにする罠と、リードタイム閾値で値下げだけ止める実装
目標稼働×在庫が1室未満になる帯では不足率が常に100%になり最大値下げが固定される。閾値以上は係数の下限を1.00にし値上げ側は触らない。旧オラクル＋ガード付きオラクルのテスト型と、デプロイ前に『前』の実値を残す手順
「APIが無いからAIでは消せなかった手作業」をブラウザ操作型エージェントへ流す運用の作り方
コーディングAIが触れないブラウザ手作業を、常駐ブラウザ型エージェントに移す。台帳・指示文テンプレ・Driveの作業ログ戻り経路・安いLLMによる指示文レビュー・接続テスト・実演学習の6手順。人の操作は指示文を貼る1回だけ
GAS ウェブアプリが突然開けない — ブラウザ用ライブラリ混入と clasp の盲点を API 版比較と読み込みテストで潰す
直前デプロイで混入した minified ライブラリが Apps Script 起動時に例外を投げ全画面が死ぬ事故の診断・修正・再発防止。版番号指定の API 比較、GAS 相当グローバルでの読み込みテスト、clasp がリモート専用ファイルを消さない対処まで。
PCの定期ジョブが丸ごと止まったことをPCの外で検知する（Apps Script心拍・dead-man switch）
PC上の見張り番はPCと一緒に死ぬ。各ジョブがApps Scriptへ心拍を打ち、来ない心拍を外側の時間トリガーが鳴らす構成と、日付書式で監視が永久に赤くなる等の実際の落とし穴
GASで商品ページのURLから品名・説明・画像・価格を抜いて登録フォームを自動入力する（文字コード自動判定つき）
JSON-LD→OGP→title の3段抽出、ヘッダー/metaを信じず化け文字最少で復号（楽天EUC-JP実測）、画像はDriveに保存。Node/Playwright/実環境の検証手順と落とし穴つき
LLMの出力を実際に動かして採点するevalハーネスの作り方
安いモデルへ落として良いかを測る社内evalで、正規表現採点が正しい答えを落とす問題を解決する。生成コードをnode:vmで実行し振る舞いで採点する方法、課題自体の欠陥(設問が二義的/採点が実装スタイルを過剰指定)の切り分け方、そして多くの実装が踏むvmサンドボックス脱出経路の塞ぎ方まで。
GASアプリ群への不具合報告フォーム横展開 — 各アプリを匿名公開せず共通フォーム1本へリンクする
機微データを持つ・スコープを触れない・画面が無い、で止まる横展開を、フォームをパラメータ化して共通1本に集約する方式で全部さばく。器の選び方で人間のクリックを0回にする方法と、文字化け・公開範囲の検証3点まで。
請求書・領収書を「別シートに1行入れるだけ」で作る GAS 帳票テンプレ
スプレッドシートに 帳票/データ/設定 の3シートを組み、入力1行で印刷用帳票が完成する構成をGASで作る。セル値の読み戻しでは検出できない印刷時の文字切れを、PDF書き出しの目視で潰すまでを含む。
夜間の無人AIエージェントバッチが「静かに全滅」するのを止める（観測タスクの立て方）
夜間バッチでAIエージェントを無人実行すると、失敗そのものが誰にも届かない。観測・切り分け・自己修復・報告を別タスクとして立てる手順と、実測で踏んだ4つの静かな全滅経路（spawnの同期throw／先頭ブロックしか読まないパーサ／コンソールのエンコーディング／スリープで未発火）の塞ぎ方。
共有作業ツリーから本番Apps Scriptを巻き戻さず部分pushする
本番をclasp pull→変更ファイルだけ重ね→差分表示→push→read-back検証→デプロイを1コマンドで行い、他人の新しい本番コードの巻き戻しとエージェントのBlind Apply拒否を防ぐ
「保存しましたと出るのに保存されない」は定期同期の上書きを疑う(GAS)
時間トリガーの取り込みが画面で直した値を元表の既定値へ静かに戻す不具合の切り分け・修正・本番検証の手順
複合機のスキャン共有フォルダをGoogleドライブへスキャン直後に自動アップする
Windows常駐1本(FileSystemWatcher+rclone)で即時アップ、10分スイープと起動時回収で夜間OFFも取りこぼさない。導入直後のrcloneフィルタ衝突などの罠つき
配布する PowerShell インストーラを CI で検査する（PS5.1・BOM の罠）
社内に1行コマンドで配る .ps1 が、JSのテスト緑のまま構文エラーで全PCへ届く穴を塞ぐ。パース+BOM検査スクリプトと、windows-latest の既定 pwsh では検出できない理由、故障注入での受け入れ確認まで。
AI が止められた操作を「ユーザーのダブルクリック1回」に落とす手渡しスクリプトの作り方（Windows）
権限ガードで AI が実行できない操作を手作業1回に圧縮して渡す型。.cmd に chcp と日本語を同居させると全行が壊れる罠、node のフルパス指定とログ退避、本番がリポジトリと乖離している前提の pull-patch-push 手順をまとめる。
「予約が無いのに売れない在庫」を3原因に切り分ける（チャネルマネージャ運用）
空いているのに売れない室日を「実予約 / 明示的な売り止め / プラットフォーム由来」に分ける手順。予約APIのページング落ちによる偽陽性、予約済み室日を対照に取る決め手、modifiedキーでの書き込み検証、公開ページ目視まで。
GitHub Actions のジョブ実行時間を実測ベースで削る手順書
cron ジョブの Actions 課金を実測から削る手順。timing/jobs API でのステップ別計測、短時間高頻度の統合と長時間ジョブのバルク化の使い分け、ON CONFLICT の重複キーでチャンクが全落ちする罠、トークンバケットの初期バースト、order 無しページングの取りこぼし、処理欠落をカウンタで機械照合する検証まで。
散らばった業務シートから「発注し忘れ」を機械的に検知する集約表を作る(GAS)
案件ごとに分かれたスプレッドシートと外部ストレージを突き合わせ、「表にあるがデータが無い」「データはあるが表に無い」の双方向で抜けを出す。品名列が複数ある/テンプレフォルダが空/6分制限/トリガー上限など、実測で踏んだ罠と回避策つき。
委譲先の「テスト全通過」を信じない — 実データ dry-run で完成報告を潰す手順
AI に実装を委譲すると「テスト N/N 通過・完了」と返るが、テストは実装者の前提しか検証しない。実データで1回 dry-run するだけで4種類の欠陥が出た実例と、それを機械的に暴く指示書の書き方・検証の投げ方。
作業ツリーが汚れた端末にだけ配布が届かない — フォールバックの自家中毒まで含めて塞ぐ
複数端末へgit pullでツールを配る運用で、開発端末にだけ配布が永久に届かない障害。フォールバックの発動条件・人の作業の保護・自分の出力を人の編集と誤認して凍結する二次不具合・自己修復の循環・定期タスクの参照先ずれまで、実際に踏んで直した手順とチェックリスト。
無人PCへ配った監視が「一台も入っていない」ことに14日気づけなかった — 失敗が見えない3つの穴と塞ぎ方
複数の無人端末へ常駐監視を中央配布する構成で、コードが正しくても14日間1台も導入されない状態が起きた。原因はキューの枠が1つで入れ忘れが無言で止まること、-Dry が本番実行すること、実行結果の要約がキーワード依存で空欄になることの3つ。冪等な監視をキュー外の自己修復へ移す線引き、-Dry の副作用棚卸しと回帰テスト、未導入を毎日名指しする日次チェックまでを手順化した。
止まった作業を毎晩検知し、進められるものだけ自動で前に進める
CI通過済みPRが18日放置された実例から、締切・通知・自動前進の3点を備えた夜間検知を作る。通知が埋もれない設計（行動できるものと在庫の分離）と、実測で踏んだ落とし穴まで含む。
作ったのに一度も動いていない安全 hook を炙り出す
実装もテストも揃っているのに設定に未登録で一度も実行されていない hook を、毎セッション自動で検出する。誤検出で無視されなくする条件と、過去の「配線しない」判断を守る台帳まで含む
社内フィードバックを毎日AIの作業キューへ自動取り込みする（安全ゲート付き）
フォームに溜まる不具合・要望を認証付きAPIで毎日取得し、AIエージェントの作業キューへ冪等に積む。無人実行が本番コードを勝手に書き換えないための安全ゲートと、その回帰テストの掛け方まで。
Claude Code の邪魔なUI面を公式スイッチで消し、効いたことを実測する
アンケートバナー等のUI面は配布バイナリに CLAUDE_CODE_DISABLE_* の公式スイッチがある。grep で switch と gate を取り出し、settings.json の env に入れ、一時 SessionStart hook で env 到達を実測する。A/B が取れない面はコード読みで確定させ、実測と分けて報告する
AIの応答を止めるゲートが「会話の後半だけ効かなくなる」罠を塞ぐ
Stop hook のゲートに入れる無限ループ防止の上限を『セッション累計』にすると、長い会話の後半で全ゲートが静かに無効化される。上限の単位を応答本文のハッシュ比較に変える直し方と、実プロセスでの検証手順。
ルール強制 hook が本番で壊れる3つの型と検証方法
AIに運用ルールを守らせる hook を作った後に必ず起きる壊れ方(部分一致の誤爆・読む範囲のバグ・同期で消える)と、契約テスト5ケース+配布確認の型
全世界公開になっていた共有ドライブ資料を、業務を止めずに締める
AIに読ませるため公開したまま放置されたDriveフォルダを、誰も締め出さずに安全に閉じる手順。未認証curlで公開を実証→正規共有を先に付与→anyoneだけ削除→塞がったことと業務が生きていることを両方実測する型。権限一覧APIが不完全という罠つき。
HMAC鍵配布サーバの締め出し事故を防ぐ設計（複数秘密＋使い捨てenrollトークン＋失敗の自己通報）
共有秘密で設定ファイルを配る構成は、秘密をローテーションした瞬間に未受領の端末を永久に締め出す。複数秘密の同時受付・使い捨てenrollトークン・失敗を端末自身が通報する設計と、実経路e2eテストの書き方まで。
AIエージェントから別のコーディングCLIへ安全に委譲するMD — 丸1日hangを止める
監督AIから実装役のコーディングCLIへBash経由で委譲するときの呼び出し方。argvで指示を渡すとシェルがバッククォートを実行して仕様が消え、TTY付き起動はstdin待ちで無限hangする。実測1日hangの死因3つと、フックで機械的に検出する型・回帰テストの書き方まで。
ログインできないGitHubアカウントに縛られた開発を、止めずに前へ進める
パスワード不明・2FAで入れないGitHubアカウントのPATにworkflowスコープが無く、ワークフローをpushできない詰みの解き方。復旧に走る前に潰すべき5つの経路（手元アカウントのスコープ確認／依存を確認して置き換え／コミットauthorから登録メール特定／招待のAPI受諾でWebログイン回避／secrets登録はrepo+adminで足りる分担）を手順化。
同じフォルダで複数のAIエージェントを走らせたときの衝突を検知して復旧する
2つ以上のコーディングエージェントを同一作業フォルダで走らせると、片方が片方の未コミット作業を静かに消す。資源ロックでは防げない理由、mtime による検知、git checkout--/stash/commit -a などの禁止動詞、壊したときの復旧手順、委譲した生成物が古くなる罠までをまとめた運用手順。
コーディングエージェント本体を「安い互換バックエンド」で走らせる
エージェントCLIの接続先を互換エンドポイントへ差し替えて実行コストを下げる手順。envを子プロセスにだけ注入する型、カタログ外モデルで窓が誤仮定される罠、エイリアス既定の罠、契約アカウントの実測判定、カード全滅時の決済切り分けまで。
Apps Script ゲートウェイ経由の無人ジョブが稀に Unauthorized で落ちる — 本文落ちの判定と有界リトライ
GAS Web App を API ゲートウェイにした Node の夜間ジョブが、トークンも正しいのに稀に Unauthorized / 非JSON で落ちる。受信ログの (no action) で「POST 本文が落ちた一時障害」と 30 秒で判定し、一時障害の署名だけを 2s→4s→8s で有界リトライする分類関数・テスト・本番入口での検証手順まで。
認証付き社内Webアプリの一部だけを社外へ匿名公開する（前段ゲートウェイがある構成の落とし穴）
トンネル公開している社内アプリに認証不要の画面を1つだけ足す手順。前段ゲートウェイが /api/* を一律認証していると本体だけ直しても外部は401になり、しかもlocalhost検証では200で通ってしまう。素通し条件の書き方、公開APIの返却フィールド設計、公開URLに対する自動検証5項目まで。
AIエージェントの委譲率が上がらない時の診断と是正 — 委譲の準備と使い捨てスクリプトを分離する
監督AI＋実装AIの体制で委譲率が停滞する原因は規律の不徹底ではなく計測と強制層の設計ミス。シェル実行の中身を分類し、委譲の準備(仕様書執筆)と使い捨てスクリプトを分離してゲートを掛け直す診断手順。ヒアドキュメント区切り語の固定・未分類バケツ放置・指標が正しい行動を罰する構造、の3つの落とし穴つき。
機密列を含む共有スプレッドシートにAIを安全に書き込ませる型
パスワードや手書きメモと同居する管理表に、AIに本文を読ませずに自動更新させる実装型。許可リスト書込・見出し行の自動検出・行を奪わない突合・列順シャッフルの敵対的テスト・定期実行の引数固定まで。
「送らなかった行はゼロ」で在庫が消える事故を防ぐ
在庫・棚卸・名簿など全件置換APIに部分入力を通すと、入力しなかった行が静かにゼロで上書きされる。事故の見つけ方、省略時の3方針、書き込み前に現在値を取る据え置き実装、行を消さずに復旧する手順、拠点を取り違えないUI、そして「送らなかったキー」の回帰テストまでの型。
社内フィードバックが「記録は残るが誰も気づかない」で死ぬのを塞ぐ
不具合・要望フォームの通知を多段フォールバック化し、未対応を毎日プッシュする型。DMがwebhookで送れない理由と、トークンをクラウドへ複製しない置き場所、未対応の定義ミス(メモ空だけに絞ると取りこぼす)まで含む。
AIエージェントの応答に必須フッターを機械で強制する（ヒントではなくゲートにする）
「で、私は何をすればいいの？」「この画面は閉じていいの？」を利用者に聞かせないため、応答末尾の3行フッターを hook で強制する型。ヒント方式が素通りする落とし穴と、委譲修正を検証する不変量ゲートまで。
AIエージェントが「そもそも不要な手作業」を人に頼むのを機械で止める
手渡しゲートの3項目は「どう自動化するか」しか問わず、丸ごと不要な依頼を素通りさせる。依頼元・目的・目的の代替達成の3項目を前置して止める設計と、実装・検証・配布・クリック数削減まで。
C:/Program Files/Git/clear でセッション一覧が汚れる問題を根絶する
AIコーディングCLIの /clear は履歴削除ではなく残骸セッションを増やす。空セッションの自動退避(猶予は対象別)・clear専用hookでの可視化・新規会話ショートカットの3点で機械的に潰す手順
APIが success を返すのに反映されないときの切り分け手順
外部APIへの書き込みが HTTP 201 / success:true を返すのに値が変わらない——エラーが出ないため最も危険な失敗。差分エコー(modified)で判定し、書ける項目を道連れに送って行単位か項目単位かを切り分け、計算値と入力を見分けて『値の所有者』に書く、までの手順とチェックリスト。
退職者の個人アカウントから後任へVercel・GitHubを移す（Hobby/Free同士）
ダッシュボードで移せないVercel Hobby同士をtransfer-request APIで移し、GitHub個人宛て移管の承認を1クリックに絞る手順
外部サービスの権限設定を人に頼む前の3確認 — AIの「手順を渡したのに画面にその選択肢が無い」を潰す
AIが権限変更を人に手渡すとき、選択肢の実在・依頼の必要性・剥がした先を確認せずに渡すと手を止め状態も悪化させる。所有者種別から権限上限を調べる、当ターンで再実測する、取り消し前に現状を記録する の3確認と手渡し文テンプレート。
デプロイ済みの本番が git より新しいプロジェクトを、壊さずに触る
git 連携が無く CLI から直接デプロイされている本番は、clone して deploy すると本番にだけある機能が消える。触る前に本番ソースを API で回収して git と突き合わせる判定と手順、秘密ファイルの混入対応、既存認証コードに触らない判断基準まで。
運用ルールをAIに守らせる「宣言強制ゲート」hook
依頼受領時(UserPromptSubmit)に割り込み、応答冒頭で1行の判定宣言を出させることで、委譲・夜間バッチ等の運用ルールを実効化する hook の型。実装コード・登録方法・発火/非発火の検証コマンド・実際に踏んだ落とし穴つき。
エージェントの出力コストを正しく測る（usage複製の二重計上とthinkingが7割という現実）
会話ログJSONLから出力トークンを集計する時に必ず踏む2つの罠（usageがレコードごとに複製され2.27倍に膨らむ／thinkingは本文が保存されず按分では測れない）を検証コード付きで潰し、そこから品質を落とさない削減レバー=レスポンス数の削減を導く手順。
「進めない先へ進んで空転する」を弾くガードが、代わりに全委譲を殺すのを防ぐ
サブのコーディングCLIは許可ワークスペースがcwd1つだけ。外を指す指示は18分空転する。それを着手前に弾くガードの作り方と、ガード自体が全委譲を殺す2つの罠（判定入力が連結後の文字列／外を参照しただけで弾く）を対照群で潰す手順。
サイトのGA4測定ID・Search Consoleプロパティを人に画面を開かせず特定する
公開GTMコンテナからの測定ID抽出と、DWD impersonateによる全量取得。HTTP 200でも権限範囲の一覧を全量と誤認する事故の検知方法まで。
Domain-Wide Delegation の許可済みスコープを管理画面を見ずにトークン取得で実測する
SAのDWDでスコープを1つずつ単独要求し unauthorized_client の有無で許可リストを確定。既存＋追加の完全な値を管理者に渡し、反映もループで自動検知する
デプロイ更新の「狭間」が本番データを壊す — 新旧の版が同時に動く前提で冪等性を設計する
サーバレス/GAS Web App でデプロイ切替は即時でも原子的でもない。切替の狭間で新旧の版が混在し、旧版の書き戻しを新版の移行ロジックが無条件変換してデータを壊す型と、冪等性の定義拡張・修復関数・切り分け手順・read-back検証までをまとめる。
Discord webhook の死活監視と自動修復
削除された webhook で通知が無言停止するのを防ぐ。生存中にチャンネル台帳を作り、死んだら同一チャンネルの生存 webhook へ自動で差し替える設計と実装要件
スプレッドシートのシート追加ボタンが copyTo null で落ちる原因をデータだけで特定する
GASボタンの Cannot read properties of null (reading 'copyTo') は、シート名一覧と実シート名のズレ。Sheets API で実名・一覧列・プルダウンのデータ検証を突き合わせて壊れた参照を全件出し、退避先から復元して read-back 検証するまでの手順。末尾スペース事故とバインド型スクリプトに到達できない制約も含む。
「安いAIへ委譲しろ」の強制と委譲先の枠切れが重なるとAIは何も書けなくなる
実装を別AIへ委譲させる規律をフックで強制していると、委譲先が使用上限に達した日に「委譲も直接編集も不可」のデッドロックが起きる。解除条件を主経路とフォールバックの両方死亡時のみに限定する設計と、復帰時刻パーサ・状態ファイル隔離の落とし穴。
制約で候補を選ぶ機能が全滅する事故を止める — 判定用属性マスタの分離と提示前の実在庫確認
駐車場・宿・機材など「条件に合う候補を選んで出す」機能が全件使えない全滅事故を止める型。容量計算用の内寸と判定用の外寸を別マスタに分ける、区分を推測せず一次資料から取る、判定関数に除外理由と僅差warnを返させる、検索条件(必須/除外/確認)を機械が出力する、そして候補を提示する前に対象日の実在庫を確認し予約不要の代替を併記する。担当者と連絡先を帳票に出して人力照合を消す手順も含む。
複数PCへ設定ファイルを自動配布する仕組みの設計と落とし穴
APIキーや通知先を全PCへ配り続ける仕組みの作り方。既存ファイルがあると更新が永久に届かない罠、秘密ローテーションで全台ロックアウトする事故、設定コピーによるPC識別の混同を、実装コードと検証手順つきで潰す。
セッションを閉じたら次のセッションが自分から再開するようにする（2つの届け方と、その限界）
エージェントCLIの外から新セッション化は発火できない。その制約下で取りうる window / inline の2方式、暴走を止める条件、実測で踏んだ罠と検証項目までの実装指示書。
ずっと skipped だった CI ジョブを掘り起こして緑にする
CI が長期間赤いと needs: の後段ジョブは skipped のまま欠陥が隠れる。過去実行の確認方法、パッケージマネージャの二重指定・静的プリレンダーの DB 接続・Playwright の webServer 未起動という典型4段を、CI ローカル再現で往復を減らしながら順に潰す手順書。
CIから自ホストへpushする連携が「届かない日」を、artifactからのpullで埋める
自宅/社内PCやトンネル公開先へCIからPOSTする連携が到達できず落ちる問題を、配達先からartifactを取りに行くpull経路で埋める手順。生成と配達の切り分け、判定表の設計、CIの定時遅延による二重生成の回避、read-back、監視指標の付け替え、計測ツール自身の偽陽性の潰し方まで。
「直したのに効いていない」を潰す — hook と夜間ジョブが読むチェックアウトを検査する
AIエージェントに組ませた hook や夜間バッチは、main を直しても古い実体が動き続ける。設定が実際に指すファイルと origin/main の内容を比較して毎朝1通だけ通知する検査の作り方と、誤検知を殺す設計（ゼロ件カウンタ・散文ログ・VCS出力・ベースライン抑制）。
並行して走る AI セッションが同じ仕事を二重に拾うのを hook で検知する
複数セッションを並行で走らせると、引き継ぎファイルの同じ「次の目的」を2つのセッションが拾って重複実装が走る。基盤が持つ目的台帳は定型文で汚れていて使えない(無関係同士の類似度が1.00)ため、transcript の assistant 宣言行から目的を取り、Jaccard 類似度で衝突を警告する hook の作り方。ノイズ床の測り方、user行を拾う罠の回帰テスト、刺すイベントの選び方、設定登録後の構造 read-back まで。
コードの既定を直したのに挙動が変わらない — 設定ファイルの env 注入を疑う
CLI エージェントの分岐を直しても効かない時の診断手順。設定ファイルの env 注入がコードの既定とユーザー環境変数より上位にある構造を優先順位表で示し、実効プロセス env の読み方・全コピーの dry-run・親プロセスでの実物確認までを機械的な順序で行う。
Googleユーザーデータを認証なしローカルアプリに出す — GAS→公開HTTPS橋渡し
自作ダッシュにGoogleタスク/カレンダー等を、アプリにOAuthを持たせずGAS→公開HTTPS ingestへPOST→ローカルキャッシュ→Widgetで表示。Web App公開/clasp run/SA不要。funnel実ポート確認・秘密の置き場・basePath・本番再ビルド等の実測ハマりどころ付き
複数LLMプロバイダのフォールバック連鎖に新しい実行者を安全に追加する
安いLLMから順に試すフォールバック連鎖へ、新プロバイダを実測(成功率/単価/到達性)にもとづく正しい位置に差し込み、並行編集で静かに消えないよう配列全体をpinする回帰テストと4段階の実走検証まで通す手順。
チャネルマネージャ価格自動化：送信成功を信じず全部屋の実売値を読み戻す
宿泊施設の価格自動更新で「送信成功ログが緑なのに一部の部屋の売値が何ヶ月も変わっていない」事故を防ぐ検証の作り方。連動価格・実効価格パラメータ・列対応の3つの罠つき。
共有秘密をローテーションしても端末を締め出さない鍵配布サーバ設計
全PCへAPIキーを自動配布する小さなサーバで、共有秘密の張り替え時に全端末が永久401になる事故を防ぐ設計と復旧手順。primary/legacy/enrollの3層認証、クライアント側の上書き更新分岐、ローテーションの正しい順序と実測方法
AIに「自分で調べさせる」ガードの作り方 — 調査の丸投げを機械で止める
エージェントが自分で1分で分かることを人間に確認させるのを hook で止める型。既にガードを書いたのに効かない5つの原因（未配布・汎用ツールが万能キー・カテゴリ不足・誤検知で形骸化・逃がし弁が緩い）と、質問ツールを PreToolUse で事前ブロックする方法、固定すべきテスト項目まで。
CLIをラップしたMCPサーバが上流の無料枠終了で死んだらREST直叩きへ寄せる
外部AIのCLIを子プロセスで起動するMCPサーバが認証終了・旧モデル固定・機能別の枠切れで死ぬ。原因を4層で切り分け、ツール名を変えずに実行部だけRESTへ置き換える手順と、接続緑・テスト緑では足りない検証方法。
AIの記憶インデックスが読み込み上限で黙って切られる問題の検出と恒久対策
MEMORY.md 型の索引はサイズ上限で無言に切り捨てられる。バイトで測る→一行要約を本文へ移送→種別プレフィックスの二重持ちを外す→別実装で不変条件を検証、までの手順。最大の罠『デフォルトブランチに入れた≠各マシンで動く』の潰し方付き。
常駐ジョブを作業ツリーの HEAD に依存させない（固定 worktree ＋ 出力先分離）
毎朝走るジョブが Cannot find module で落ちるのは、実行場所が人や別セッションの作業ツリーで、HEAD が動くから。ジョブ専用 worktree でコードを固定し、成果物だけ --out-root で共有リポへ返す設計と、終了コードで取る5段階の検証手順。
汚れた作業ツリーから「レビュー済みの版だけ」を本番に出す（git worktree + Vercel）
未コミット差分だらけ・originとズレたローカルから誤った版を本番に出す事故を、detached worktree + .vercelコピー + 本番URLへの実描画検証で塞ぐ手順
複数PCのAIエージェントにルール変更を確実に届ける — 届いたつもりを潰す4つの実測
共有リポジトリ経由でAIのルールを配る構成で、pullだけ自動/pushが手動・間引きが黙って効く・CDNが古い版を返す・dry-runが保護ブランチを教えない、の4つの罠と潰し方。検証は配布経路そのもので行う。
ダッシュボードが「artifact が見つからない」で真っ赤になるのを塞ぐ
GitHub Actions の成果物を画面に出す構成が no valid artifacts found で落ちる真因（preflight skip した run も success だが artifact 無し）と、artifact 実在確認＋直近成功へのフォールバックで画面を殺さない直し方。常駐プロセスの世代確認と実ブラウザ描画までの検証手順つき。
AI エージェントに本番 DB の migration を任せる（破壊的 SQL を構造的に実行できないランナー）
本番 DDL だけ毎回人が SQL エディタに貼っている状態を解消する手順。禁止語 grep ではなく allowlist 文法でパースして許可構文だけ実行するランナーを1本作り、そのパスだけを許可する。成功判定に「期待カラムの実在確認」を必須化して沈黙 failure を潰す。TLS のプライベート CA、マネージド DB 標準の event trigger、履歴基準の「未適用」誤読という3つの落とし穴の回避込み。
AIの出力を止めるゲートhookが誤爆した時の直し方
テキストマッチで応答を止めるhookは必ず誤爆する。真因の特定(Markdown表が1ブロックになる/引用を実物と数える/満たしようのない要求)から、最小の例外の切り方、過小検知に変えないテスト、配布先まで見る完了判定まで。
提案キューを溜まるだけのゴミ箱にしない — 夜間の自動トリアージ
AIが出した提案を溜める仕組みだけ作ると必ず腐る。Web検索で裏取りし安いLLMがverdict/adoptを返し、done/rejected/TODO起票まで無人で回す設計。unclearは捨てずN回で打ち切る規則、無料枠を焼かない既定値、PowerShellのBOM/文字化けの罠まで。
頼んだ作業を実データで完了検知して自動で止まる、日次リマインドBotの型
権限共有や初期設定の依頼を出したあと、完了したかを本人の返信ではなくAPIの実データで判定し、未完了なら1日1回だけチャットDMで催促、完了を検知したら自動停止して依頼者に報告する無人ジョブの実装型。試行上限・二重送信防止・誤報防止まで込み。
OTA連携で「1室だけ予約が来ない」を3層に分けて切り分ける手順
サイトコントローラー経由の予約ゼロを、①自分側のマッピング ②OTA側の掲載状態 ③実際に送っている在庫・価格 の3層に分けて実値で確定させる読み取り専用の手順。マッピング欠落と決めつける誤診、集計窓による錯覚、先頭数行での早合点、取れなかった実表示の扱い、金額を添えた優先度づけまで。
GUI拡張の「他の環境には出るのに、ここには出ない」を設定探しから始めない
GUI拡張の機能欠落は設定ではなく版の不一致。稼働中の版をプロセスパスで確定し、別ウィンドウで新版をA/B（信頼無効化が必須）してスクショ目視まで自分でやってから、再読み込みを同意付きで渡す手順
複数PCへ配る設定ファイルを端末固有値を壊さず中央更新する
中央でキーやwebhookを張り替えた瞬間に全端末が静かに死ぬ事故を、キー単位マージ配布・保護キー・ローテーション順序・沈黙検出で構造的に防ぐ手順
内容で行を特定する書き戻しが、ある日から永久に一致しなくなる
スプレッドシートを正本にした業務アプリで「登録できるのに反映されない」が起きる典型。正規化のtrimとsliceの順序で保存値の往復が非冪等になり、全行走査で0件ヒットになる。本番ログからの追い方、ハッシュを変えずに直す方法、重複行事故を防ぐ固定値テストまで。
「直したのに直らない」— 同じ画面に書き込む経路が2本あるのを見落とす
利用者の不具合を直したのに直らない時の定番原因。同じ表示に書き込むコードが複数あり片方しか直していない、レイアウト版数を片方の経路だけが見ている、記録の成否を確認せず「別の場所を見ろ」と案内する、の3類型と、固定文言からの逆引き・共有ヘルパーへの集約・実データ読み戻しでの検証手順。
本番共有スプレッドシートを壊さず一括更新する型(GAS)
複数人が使っている本番シートに対し、AIが担当者名の一括置換や誤登録行の削除を安全に行うための設計。dryRun→照合キー付き適用→独立read-backの3段と、GASのコード雛形・実際に踏んだ落とし穴つき。
無人ジョブの沈黙する失敗と効果検証の自動判定
定時ジョブが1行もログを残さずスキップされる事故の検知と、恒久対策の効果検証をジョブ自身に判定させる型。Windows Interactive タスクが無人再起動で捨てられる罠、検証を壊す警告文の是正、全分岐の時間偽装テストまで。
稼働中の既存GASを、副作用を起こさずに検証してから本番反映する
定期実行中のApps Scriptに仕様変更を入れる手順。メール送信などの副作用を起こさずに実データでロジックを検証し、clasp push後にpullで突合するまでを機械判定で閉じる。clasp loginの認可URLが死ぬ罠、pullの拡張子違いで差分ゼロを誤認する罠つき。
定時ジョブが黙って止まったのを検知して自動修復する見張り番の型
無人ジョブの死活を3層（起動・終了コード・今日の成果物）で判定し、固定した作業コピーでの再実行で自動修復する型。判定不能と非冪等を触らない切り分け、1日1回・3日で打ち切る暴走防止、相互監視、実装を安価モデルへ委譲したときに実行して初めて出る欠陥まで。
放置された open PR を安全に棚卸しする（マージすると退行する PR の見抜き方）
CI が緑でも、後から覆された結論を含む PR をマージすると仕様が巻き戻る。使い捨て worktree で残差分ゼロ判定・陳腐度の数値化・退行検知を行い、マージ/クローズを機械的に振り分ける手順。read-back とクローズ根拠コメントのテンプレ付き。
追加したテストが本当にその不具合を捕まえるかを対照群で確かめる
テストが緑でも、直す前のコードに当てても緑なことがある。直した箇所を1つずつ無効化して赤くなるか確かめる手順。置換が当たらず素通りする罠（CRLF）と、期待文字列が実装を通らない経路で出力に混入する罠（例外メッセージのコマンドライン全文）の2つを潰す雛形つき。
正しく動く検知器が一度も発火しない — 「検知力」ではなく「いつ聞かれるか」を先に測る
テストは全部green、検知力も正常。なのに事故が繰り返される。原因は『情報が無いから黙る』早期returnが、一番危険な『これから選ぶ瞬間』を必ず素通りさせていること。実物入力での検知力の単独測定、判断が決まる瞬間の名指し、同一入力の前後比較と対照群4種までの手順。
AIエージェントが作った Windows 自動化が「静かに死んでいる」のを見抜いて直す
Botやコーディング AI に作らせたタスクスケジューラの常駐処理が、初回だけ成功して以後毎回失敗する壊れ方の判定・原因特定・恒久対策。最頻出原因は BOM なし UTF-8 による構文エラーで、PowerShell 5.1 経由でだけ再現する。実行せず構文検証する方法と、受け入れ条件の付け方まで。
GASの時間主導トリガーがデプロイ版に固定される罠 — 「成功したのに何も起きない」の切り分け
clasp push しても時間主導トリガーは旧バージョンのコードを実行し続ける。エラーも出ず戻り値もOKなため原因が特定できない。新関数プローブで実行中のコードを確定させ、clasp deploy -i でURLを変えずに直す手順。
自動起動したCLIエージェントが初回プロンプトで固まる問題を潰す
無人で起動した Claude Code 等の TUI が「テーマ選択」「フォルダ信頼」の初回プロンプトで無言のまま止まる問題の恒久対策。theme を settings.json に置く理由（別ファイルに書くと消える）、信頼ゲートを人の同意付きで通す型、スクリーンショットで入力待ち到達まで目視する検証手順、効かない検証方法3つ。
別シートの列番号が腐って別レコードの値を返す事故の直し方（名前照合＋日付タイブレーク）
保存した列番号は列の挿入削除で全件ズレる。壊れた件数の測り方、NFKC正規化と最長優先の名前照合、同名列を期間で割るタイブレーク、確定できない時は空を返す設計、純関数化とテストケースまで。
「1台だけそのサイトが開けない」を30分で確定させる — IPv4専用サイト × IPv6回線
Cookie削除もシークレットも効かないERR_CONNECTION_TIMED_OUTを、サーバ側の無罪を実測で証明してから端末側を読み取り専用コマンドだけで確定させる手順。リモート接続や会議を切らずに原因を一意に決める。
共有コマンドキューの落とし穴と修正パターン（AIが実行を投げるキュー）
AIエージェントからクラウド関数をリモート実行させるコマンドキュー方式を、実際に運用して初めて露見する5つの欠陥（実行前削除でコマンドが消滅／結果なしを未実行と誤判定／排他ロックが制御を飢えさせる／並行エージェントの二重実行／実行時間上限で毎回全損）と、その修正コードとチェックリスト。
LLM監査ゲートの誤検知を直す — 弾いているruleを台帳で数える／AI自身は直せなくなる
LLMに規則本文を注入する監査ゲートで誤検知が出た時の直し方。当たりを付けたruleはほぼ外れるので台帳のviolations[].ruleを実測で数える。例外は番号を振らず横断で1つ足す(番号を振るとバリデータが壊れaudit-unavailableで通る)。そして規則ファイルはAI自身が編集できない(Instruction Poisoning判定)＝設計時に人の更新対象と決めておく。
Vercelのレジストラ API でドメインを取得し既存サイトを無停止で乗り換える
購入・DNS・リダイレクト・検証まで人手ゼロ。廃止された旧API、購入が成立しない安全弁を使ったスキーマ調査、踏まないとドメインが止まる確認メール、/:path* がルートに当たらない罠まで実運用の落とし穴を網羅。
外部連携の値を内部フィールドで検証して誤診しない手順
チャネル連携・在庫/価格同期で「送った値が外にどう出ているか」を内部APIのフィールドで確認すると誤診する。派生値/参考値の混同、チャネル単位の係数、レスポンスの無言切り捨てという3つの罠と、消費者向けエンドポイント→全件突合→ブラウザ実描画という潰し方。
定期実行が「手動なら動く」まま何週間も止まっているのを見抜いて直す
GitHub Actions の schedule だけが 403 で全滅しても手動実行は成功し続けるため気付けない。--event=schedule での生存判定、actions:read の付与、直した後に露出する次の層の潰し方、死活監視の仕組み化までを手順化する。
審査待ちキューに同じ主題が積み上がるのを「出す前」に止める
取り下げAPIが無い投稿先に、並行セッションが同じ主題を重複投稿するのを投稿直前のしきい値ゲートで止める。しきい値は勘で置かず既存ログの再生で決める手順まで含む。
AI に実装を委譲している間に main が動く — 着手前のPR確認を信用しない
コーディングエージェントへの委譲中に他者が同じファイルを main へ入れる。CIが1本も走らない/mergeable UNKNOWN は「ベースが古い」合図。push直前のfetch+rebaseと、rebase後の全体テスト再実行までを型にする
Beds24 API で「全室が既定レート固定」と誤診しない読み方（連動価格フラグの罠と読み取りツール）
Beds24 の料金カレンダー API は includeLinkedPrices=true を付けないと連動先の部屋が既定レート一定で返り、値付け欠陥と誤診する。見分け方・実表示での裏取り・常にフラグ付きで読む読み取り専用ツール（純関数テスト付き）の作り方。
AI の返答に出てくる URL に「どのアカウントで開くか」を必ず書かせる Stop hook の作り方
管理画面・課金ページの URL をアカウント名なしで人に渡すと別アカウントで開いて 404 になる。返答の送信直前に止める Stop hook（判定ロジック・免除条件・逃がし弁・テスト・配線）を依存なしの Node.js で作る手順。
成功しているのに『スキップ』と出るバグの潰し方(ディスパッチャの戻り値規約)
ボタン一覧→コマンド関数をディスパッチする型のツールで、状態フラグと明細配列に同じキー名を使うと空配列がtruthyで常に成立し、成功しても『スキップ』表示になる。原因特定の順序・修正・文言そのものをテストする退行防止まで
PMS のセット販売用「仮想部屋」の予約が『閉室・原因不明』に見える罠と直し方（Beds24 の room dependencies）
セット部屋（仮想部屋）の予約で構成室が numAvail=0 になり集計が『閉室・原因不明』と誤計上する仕組みと、3 回の GET での診断、予約を構成室へ展開する共通純関数モジュールで全ツールを直す手順
シート対応済みチェック＋期限超過Discord催促
スプレッドシートにチェックボックス列を足し、一定時間経ってもチェックが入らない行を検知して担当者別にDiscordで自動催促するパターン。既存の定時cronに相乗りし、状態管理なしで繰り返し催促が実現できる。導入時の既存行一括処理とタイムゾーン変換の落とし穴も含む。
botブロックされるSPA管理画面をAIに安全に編集させる（probe→dry-apply→applyの3段式）
常駐ログイン窓＋CDPで読める管理画面の「編集」を事故なくAIに任せる型。行特定が曖昧なら押さない・確定とキャンセルの分離・編集UIと概要の表記差・公開側での読み戻しまで、実測の罠込み。
ログイン必須の社内ページ（Google Sites/社内Wiki）をAIに自力で読ませる
APIが無く通常のHTTP取得では302でログイン画面に飛ぶ社内ページを、Playwrightの永続プロファイル1本でAIエージェントが自力取得できるようにする。実測で踏んだWindows固有の致命バグ4件と回避策つき。
サーバレスに認証付きの配信APIを作るときの2つの落とし穴（静的配信で認証が無意味／200なのに0件）
リポ直下に置いたペイロードが認証なしで配信され認証が無意味になる罠と、自作probeのPOSTと実クライアントのGETがズレて200なのに配置0件になる罠。api/_前置の実測表、素のURLを404で確認する検証ループ、実クライアントをimportして受け取り件数で判定する完了条件まで。
「AIが本番デプロイを禁止されている」と誤診しないための切り分け手順
自動承認モードの分類器に本番デプロイを止められた時、真因は権限ではなく叩き方(ランナー経由起動・サブエージェントへの委譲・承認スキップフラグ)であることが多い。6点のチェックリストで切り分け、人に手作業を振る前に自力で通す。
AIエージェントの skill/tool を複数PCへ配布する時の罠と回避策
skill・共通ツールを複数PCへ自動配布する運用で必ず踏む3つの罠（配布物はgit repoでない／同期スクリプト自体が古い／skillはセッション開始時ロード）と、依存を再帰取得するブートストラップ手順。
既存の Claude Code 環境に「学び台帳・Decision Record・母数照合・HANDOFF」を後付けする手順
CLAUDE.md とセッション終了手順を既に持つ環境へ、同じ学びを3回数えて仕組み化する台帳・前提が変わったら見直す意思決定記録・母数照合の完了条件・実行役への HANDOFF テンプレを、既存体系を置き換えずに差分導入する手順。
「数字が変わらない」— 定期出力が止まった時に最初に疑う場所を間違えない
定期レポートが更新されない・エラーログは空・手動実行は成功。この組み合わせは「起動していない」のサイン。診断順序（トリガー登録→手動実行→実装）と、二度と沈黙させない実装パターン（キャッシュ鮮度警告・stderr保存・finally解放）
Vercel独自ドメイン接続+証明書発行待ち自己解決MD
外部レジストラのDNSをVercelに繋ぐ手順と、HTTPSだけ繋がらない時にvercel certs issueで手動発行して数十分の待ちを数十秒に短縮する診断フロー
機能を封鎖したら相乗りの検証も死ぬ — 未検証のゼロを画面から追い出す
危険な機能を後から封鎖すると、同じフラグにぶら下がっていた検証処理が道連れで死に、ツールは未検証のゼロを『確認した結果ゼロ』の顔で出し続ける。実例では1週間、12件ぶんの嘘の警報を出していた。フラグ参照の仕分け方、未確認を空集合で表現しない持ち方、原因バケツの合計を不変条件にする数え方、0/1/2 の終了コード設計、修正前後を本番データで並べる検証手順、委譲実装の受け入れ基準まで。
設定ドリフト照合器が「毎朝ずっと赤」になるのを止める（照合対象外の値の扱いとguardの当て方）
決定台帳と本番設定を毎日照合する仕組みは、APIに現れない値をパス欄に説明文で書いた瞬間に永久MISSINGへ落ち、本物のドリフトが埋もれる。照合対象外を第3状態(null=DOC)に分ける設計、値を巻き込まず書式だけ直す手順、旧データでfailさせてから当てるguardの検定順を示す。
ページングAPIで「全件取れたつもり」が4%だった — 静かな取りこぼしの検出法
limit を無視して常に20件返すAPIに対し offset を要求limit分進めていたため6,902件中280件しか取れていなかった。テストもCIも緑だった理由と、本番の意地悪さを再現するモックの書き方。
CI が全部 green なのに auto-merge されない PR を原因から特定して自動マージに乗せる
GitHub の auto-merge が効かない原因は権限ではなく fork であることが多い。切り分けコマンド、ワークフローの5条件の読み方、正しい提出経路、ラベル忘れが成功に見える落とし穴、GraphQL と REST の2系統を実測付きで示す
squash マージ済みのブランチ / worktree を安全に消す判定手順
用済みの作業ブランチや git worktree を、未取り込みの作業を失わずに消すための判定手順。squash マージは祖先関係を切るため git branch --merged / --contains / origin/main..HEAD はすべて「未マージ」と誤報する。さらにローカルの origin/main ref が古いと内容 diff でも答えを間違える。この2つの誤りを潰し、2点diffと3点diffの切り分け・同一題名コミットによる決定打・削除後の read-back まで含めて確定させる。AI エージェントに投げる際の注意（調査と削除を混ぜない）付き。
Googleドキュメントを AI に作らせる時の落とし穴 — 本文は更新できない前提で設計する
MCP等からGoogleドキュメントを作る運用で踏む4点（本文更新手段が無い/Markdown記号のエスケープ/サイズ値で成功判定できない/大きな読み返しはローカル保存）と、最初から決めておく6つの設計。
連携が「権限不足」に見えて実は「身元違い」のとき — 両側のアカウントを先に実測する
デプロイサービスとGitホスティングの連携が繋がらない時、資源側の権限をいじり続けて往復を溶かす失敗を止める。要求側が外部で名乗る名前と資源の所有者を実測で突き合わせる手順、詰まった時に目的へ戻る代替、環境変数のスナップショット順序など併発する罠まで。
「そのイベントは発火していない」を証明する — 同じログの中に対照群を見つける
ログに無いことを根拠に否定すると外す。同じログ内でそのイベントが発火している別の箇所を対照群として拾い、計測器が検出できることを示してから否定する型。手順・実例・失敗パターン・チェックリスト付き。
ローテーションするOAuth2リフレッシュトークンをDB永続化して壊れないようにする型
freee/Google等でリフレッシュトークンがローテーションし env固定だと初回更新後に必ず壊れる問題を、トークンをDBに持ち更新のたび書き戻す型で解決。マスタID取得・冪等ガード・段階導入まで含む会計API連携の定石。
ヘッドレスCLI実行がライフサイクルhook経由で通知/ミラーを汚染する問題の恒久対策
定期バッチで非対話起動するCLIエージェントが終了hookで通知/一覧を毎時汚染する問題。--no-session-persistenceだけでは不足、発生源での環境フラグ+entrypoint allowlist+永続トランスクリプト有無での一掃、の多層防御手順。
API に無い OTA 設定の出どころを、チャネルマネージャの管理画面から特定する
APIを変えてもOTAが動かない時、priceRuleで止めず全数走査で『API無し』を確定し、管理画面のチャネル固有コンテンツ欄(部屋別・入力欄value・リダイレクト警戒)を読んで出どころを特定する手順
Windows で無人 LLM CLI に長いプロンプトを渡すと spawn ENAMETOOLONG で即死する — stdin 渡しへの根治と単発故障を1件で検知するヘルス判定
Windows の argv 上限で子CLIへの長いプロンプトがspawn即死。stdin渡しへの修正とテスト、単発故障を1件で検知する監視の閾値修正
到着日で絞る予約APIが滞在中ゲストを落とす — 空室・閉室の誤判定を防ぐ遡り取得
PMSの予約一覧APIを期間の開始日から引くと期間前に着いた滞在中ゲストが消え、在室中の部屋を開け忘れと誤判定してダブルブッキングに進む。最長滞在ぶん遡って取り泊単位で照合する実装と、人に聞く前の確認手順。
マージしたのに本番が変わらない — Vercel の Git author ブロックを特定して費用ゼロで通す
PR をマージしたのに本番が更新されないとき、Vercel が author 検査でデプロイを拒否している可能性を gh api と vercel CLI で確定し、作り直しゼロ・費用ゼロで通す手順。マージ方式ではなく「押した人」が原因という誤診も扱う。
既存の業務スプレッドシートに「成果物シート」を自動追加する（Driveコネクタでは不可・Sheets API直叩き）
調査結果や候補リストを新規ファイルではなく案件の正本スプレッドシートの新タブとして足す手順。DriveコネクタにaddSheetが無い点、タブ名rangeのクォート、gid付きURL、read-back verify、Windows の file:/// import まで。
委譲した実装を「本番で起動される環境」で受け入れ検証する
AIに実装を委譲するとテストは緑で返るが、それは委譲先の環境での緑でしかない。WSLとネイティブなど実行環境が2つあると片方でだけ通るコードが生まれ、本番へ配線した日から静かに失敗する。本番の起動経路で受け入れ検証する型と、環境差で死ぬ定番3つ、破壊的ツールの追加ゲート4つ。
fork PR しか出せない AI エージェントに「マージまで」を完了条件にさせない
push権限のないアカウントで動くAIエージェントが、CI全greenでもマージできずタスクを永久に引き継ぎ続ける滞留の診断3コマンドと、完了条件の立て方・リポジトリ側の恒久策2案。
「0件だった」を無罪の証拠にしない — ログ調査の計測器を対照群で検定する
監査ログや操作ログで「該当0件」が出たとき、それを「起きていなかった」と報告してしまう事故の防ぎ方。対照群を調査窓ではなくログの全期間で数える、日時は列を決めて読む、判定不能を終了コード2に分ける、の3点を手順と指示文つきで示す。
GASの通知Botメンバーリストをスプレッドシート化する
Discord/Slack等への定期通知GASでハードコードされた宛先リストをスプレッドシート読込に置き換え、以後はコード編集不要にする。Drive全文検索がGAS編集直後は反映されない落とし穴も併記。
安いLLMにコードをファイル単位で生成させて安全に書き出す（区切りマーカー＋許可リスト＋検収）
コーディングエージェントが動かない環境で、DeepSeek等のチャットAPIに複数ファイルの完全内容を出させ、許可リスト付きsplitterで書き出し、テスト・diff・致命パターンで検収する型。ルーティング上書きやコピー癖などの失敗表つき
GAS Webアプリ バーコードラベル印刷(iOS AirPrint対応)
Google Apps ScriptのWebアプリからBrother等のラベルプリンタへ印刷する際、iOS AirPrintが連続ロールのカット長を無視する問題をjsPDF生成で回避する実装パターン
GAS Webアプリ 原因不明の失敗 切り分けチェックリスト
手動実行は成功するのにWebアプリ経由だけ失敗するGASの謎エラーを、サーバー最適化より先に別端末テスト→キャッシュ確認の順で切り分ける手順
サーバーレスに新secretを足さずローカルCLI+定期タスクで外部API連携を補完する
Vercel等に新規tokenを増やしたくない時、開発機の認証済みCLI(gh等)+OS定期タスクで冪等な差分同期にする設計パターン。throwawayレコードでの安全なE2E検証法とWindows PowerShellラッパーの文字化け/パースエラー回避も含む。
Google Sheets API 2大落とし穴（append列ズレ/QUERY ORDER BY silent fail）
フィルタ有効シートへのvalues.append()が列ズレする罠と、QUERY()のORDER BYが型混在列で全行silent失敗する罠、それぞれの回避策
GAS Webアプリの同時アクセスクォータエラー対策
複数人利用のGoogle Apps ScriptアプリでSpreadsheetApp.openByIdが同時呼び出しエラーになる問題を、リトライ+バックオフ+ジッターのラッパー関数で解消する手順
払った額（カード明細）と使った額（実行ログ）を突合してAI費用の計上漏れを洗い出す
会計カード明細とCLI実行ログの2データ源を月次で機械突合し、計上漏れを経理が『登録待ちリスト』だけ確認すれば済む形にする手順。4状態判定・dry-run→read-back→本実行・人の記入列を書かない安全則つき