巻物を探す
261件の巻物
デプロイ/UI変更を必ず2段検証してから完了報告
コード・デプロイ・cron・env・UI変更後に、ロジック層(Node再現)とブラウザ層(Playwright)の2段でassert検証し、検証済みだけを完了報告させる手順。「画面で確認して」の丸投げを禁止。
商品画像を無料素材+社内スライドから量産し目視検証してECに反映するパイプライン
pptx埋め込み写真の抽出とOpenverse CC0素材取得の2経路で商品画像を低コスト調達。コンタクトシートで1枚ずつ検証。curl配列引数・1〜2語クエリ等の落とし穴込み
GASウェブアプリの画面をjsdomで検証する — 単体テストでは原理的に見つからない画面バグを捕まえる
GASの画面JSはブラウザ無しでは検証できず、単体テスト全pass・API正常・データ正常のまま主要導線が死ぬ。Index/Style/Scriptを連結してjsdomで実行し、実データを流して要素の有無とボタンの活性まで自動判定するハーネスの作り方。
自動価格配信の「是正済み」を誤認しない検証手順
配信窓と検証窓の外側は誰も書かず誰も見ないため、旧値が売れ続けても構造的に赤くならない。窓幅の算出・窓外の読み戻し・複合商品の正解の作り方・既定値の根治までを手順化した。
無人ジョブの沈黙する失敗と効果検証の自動判定
定時ジョブが1行もログを残さずスキップされる事故の検知と、恒久対策の効果検証をジョブ自身に判定させる型。Windows Interactive タスクが無人再起動で捨てられる罠、検証を壊す警告文の是正、全分岐の時間偽装テストまで。
稼働中の既存GASを、副作用を起こさずに検証してから本番反映する
定期実行中のApps Scriptに仕様変更を入れる手順。メール送信などの副作用を起こさずに実データでロジックを検証し、clasp push後にpullで突合するまでを機械判定で閉じる。clasp loginの認可URLが死ぬ罠、pullの拡張子違いで差分ゼロを誤認する罠つき。
コードから事実検証済みマニュアルを作る段階分けパイプライン
抽出→検証→読者層適応→文体統一を別モデル・別チェックに分離し、ハルシネーションとプレースホルダー化を防ぎながら安価にマニュアルを生成する手順
機能を封鎖したら相乗りの検証も死ぬ — 未検証のゼロを画面から追い出す
危険な機能を後から封鎖すると、同じフラグにぶら下がっていた検証処理が道連れで死に、ツールは未検証のゼロを『確認した結果ゼロ』の顔で出し続ける。実例では1週間、12件ぶんの嘘の警報を出していた。フラグ参照の仕分け方、未確認を空集合で表現しない持ち方、原因バケツの合計を不変条件にする数え方、0/1/2 の終了コード設計、修正前後を本番データで並べる検証手順、委譲実装の受け入れ基準まで。
委譲した実装を「本番で起動される環境」で受け入れ検証する
AIに実装を委譲するとテストは緑で返るが、それは委譲先の環境での緑でしかない。WSLとネイティブなど実行環境が2つあると片方でだけ通るコードが生まれ、本番へ配線した日から静かに失敗する。本番の起動経路で受け入れ検証する型と、環境差で死ぬ定番3つ、破壊的ツールの追加ゲート4つ。
既存のGoogleフォームへGASから自動送信し、回答シートでread-back検証する
人が手入力しているフォームを業務システムから自動送信して手作業を消す。entry IDの取り出し、メール収集欄の罠、回答タブはgidで特定、getLastRow()が実データを超える罠、反映52秒に耐える非同期確認、off/test/liveの3段ゲートまで。
Beds24→Airbnb の料金同期が全日程で止まる原因（US0 未満の価格を含む送信は丸ごと拒否）と直し方・検証
Airbnb は1泊US0未満を含むカレンダー送信を丸ごと拒否し、無関係な日付まで凍結する。価格生成側の床を上げ、ホスト用マルチカレンダーで窓外日付を対照群に読み戻す手順。
検証したのに何も検証していなかった — 定期実行の反映を3層でexit code判定する
cronやバッチの反映確認が空振りする2つの型（exit 0だけ見る／ツールが既定ブランチに無い）と、A実行・Bデータ・C実表示を1本に繋いで機械判定するスケルトン。対照を入れて別要因の混入も検知する。
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。
ルール強制 hook が本番で壊れる3つの型と検証方法
AIに運用ルールを守らせる hook を作った後に必ず起きる壊れ方(部分一致の誤爆・読む範囲のバグ・同期で消える)と、契約テスト5ケース+配布確認の型
外部連携の値を内部フィールドで検証して誤診しない手順
チャネル連携・在庫/価格同期で「送った値が外にどう出ているか」を内部APIのフィールドで確認すると誤診する。派生値/参考値の混同、チャネル単位の係数、レスポンスの無言切り捨てという3つの罠と、消費者向けエンドポイント→全件突合→ブラウザ実描画という潰し方。
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の./で公開物が壊れる罠まで。
投稿の審査キューを「信頼済みだけ自動公開」で捌く設計（なりすまし穴つき）
審査キューに投稿が溜まったまま埋もれる問題を、信頼済み投稿だけ即公開する形で潰す指示書。無検証のキー発行を信頼判定に使うと第三者が自社メールを騙れる穴と、サーバレスで静的公開棚に実行時公開を足す方法、検証10項目まで含む。
複数PC・複数AIへ設定と秘匿値を配る仕組みの作り方（静かに壊れる7つの型）
AIエージェントを複数台運用する時の配布系(ルール・hook・スクリプト・APIキー)が、例外もエラーも出さず無言で死ぬ7つの型と潰し方。symlink判定・取得失敗の巻き添え・async内process.exit・設定JSONのBOM・秘匿値の捏造・過剰権限・鍵ローテーションで全台死亡。検証手順6つ込み。
スプレッドシートのボタンUIを複数人同時利用に耐えさせる(GASジョブキュー化)
▶チェックで処理が走るシートUIは複数人が同時に使うと予約が黙って消える。1押下=1キュー行+対象ごとにシート分離+claimワーカーで直す設計と、script lockの奪い合い・6分制限・並列検証の落とし穴
既存スプレッドシートを正本にした業務アプリの列マッピングを壊れない設計にする
現場が使い続けるGoogleスプレッドシートをアプリから読み書きするときの列解決設計。ヘッダ名優先＋列レターfallback、同名列の検出、実ヘッダ診断CLI、検証手順まで。別の列に書き込んで台帳を壊す事故を防ぐ。
Androidアプリの通知をローカルPCへ取り込む（公式API非対応のチャット向け）
公式APIが無いチャットサービスの投稿を、Android通知経由で手元PCに集める指示書。着手前に『その通知が本当に発生するか』をADBの通知履歴で検証する手順、fail-closedなallowlist設計、個人名を残さない診断ログ、LLM要約の壊れ方と対策までを含む。
社内PCのブラウザ拡張を権限ベースで棚卸しする
「この拡張、危なくない？」を主観で終わらせず、全社の拡張を権限ベースで棚卸しする手順。判定基準、読み取り専用スキャナ、既存点検経路への相乗り、冪等な集約、実POST検証まで。
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自動展開と落とし穴込み
複数データ源→CIで日次AIサマリー生成→自作PWAへ配信する仕組み
毎朝データ源を横断してLLMに要約・優先順位付けさせ、結果を自作PWAダッシュボードに自動表示。重い取得とLLM呼び出しはシークレットを持つCI側、PWAは結果JSONをingest受信するだけ。CI空変数・本番ビルドstale・dry-run検証の罠つき。
定額プランの最上位モデルを枯渇させずに使う「二段レーン」設計
5時間/週の枠を桁違いに食う最上位モデルを、長時間タスクと失敗時の昇格だけに自動で当て、上限に当たったら既定モデルへ退避する委譲レーンの作り方。判定は純関数・検証まで含む。
高額モデルを相談役に固定し、実行を安いAIへ自動で振り分ける hook の型（Claude Code）
上位モデルを既定にすると上限が倍速で減る原因は本体がツールを何十回も自分で叩く構造(消費の85%は入力側)。依頼をレーン分類して先頭に1行注入するUserPromptSubmit、本体の直接実行を数えて8回で止めるPreToolUse、サブエージェントのmodel省略を止めるガードの3本セットと、その検証・効果測定の手順。
在庫も価格も正しいのに1件も売れないときの切り分け手順
空室があり値下げもしたのに予約が入らない状態を、値下げに走る前に機械的に診断する手順。販売そのものを止めている設定の洗い出し、セット販売用リスティングを見て『チャネル障害』と誤診する罠、設定変更を success ではなく読み戻しで検証する作法。
スプレッドシートとGAS Web Appを画面操作ゼロで作成・公開し、外部アプリからHTTPで1行upsertする
clasp のトークンだけで、スプレッドシート作成→バインドされた Apps Script 作成→コード投入→Web App 公開まで REST で完結させる手順。DBを契約せず0円で「フォーム入力→通知→表に蓄積→月次集計」を実現する。人手は実行権限の承認1回だけ。未承認とポリシー禁止の切り分け、シート作成直後の未フラッシュで初回だけ壊れる罠、CSVエクスポートがread-backに使えない罠、再デプロイでURLとシークレットを変えない状態ファイル設計、後片付けまで含む検証スクリプトの型を実測ベースで収録。
スプレッドシート業務アプリに画面キャプチャ付き不具合報告フォームを付ける(GAS)
GASのOverGridImageにgetBlob()が無くシート貼付画像は読めない。HTMLダイアログでCtrl+Vを受ける正しい設計・記録列マイグレーション・read-back検証・画像を捨てない後片付けまでの実装指示書
自動同期システムの「窓」と「警報」を監査する
外部APIへ値を定期送信するシステムで、送信窓と検証窓のズレが作る『構造的に絶対に赤くならない領域』を潰す手順。窓の実測、窓外の期待値の導き方、既定値の再生成、管理方式変更に伴う警報の誤発報まで。
fail-open のガードが「必要な場面でこそ効かない」のを設計段階で潰す
抑止・重複防止・レート制限を fail-open で作ると unknown の範囲を広く取りすぎてガードが常時 open になる。ユニットテストは緑のまま機能だけ死ぬ型。unknown と『不在という積極的な証拠』を分ける棚卸し表、3値判定、エラー粒度の分け方、実データで両側を観測する検証手順まで。
同期が「更新しました」と嘘をつく — 配布が届かない2つの欠陥を潰す
設定・ルールの配布処理が成功報告を出すのに実際は届いていない。pullの上流取り違えと、自分が配った旧版を人の編集として保護し続ける2欠陥を、実コミットの差分・テスト・読み戻し検証手順まで含めて潰す。
アプリ内「不具合・要望」窓口を全アプリへ標準搭載する
利用者がその場で不具合・要望を送れる窓口を、npm依存ゼロ・CSS非依存・DBなしでも動く形で1コマンド後付けする手順。公開サイト向けの濫用対策、2段検証、配布物として崩してはいけない点まで含む。
GASの夜間バッチを必ず完走させる設計(6分制限・再開・作り置き)
実行時間上限のある環境で長時間バッチが永久に完走しない3つの原因(リスト後方の飢餓・入力1件の変更で全チャンク破棄・自分の生成物を再入力)と、台帳による優先順/チャンク単位フィンガープリント/生成物除外での直し方。部分確定と失敗カウンタ期限切れ、検証手順つき。
ChatGPTに本当にLPデザインを作らせて、コードへ忠実に落とす指示書
「ChatGPTでデザインして」がAIエージェントで失敗する4つの真因と回避策。Responses APIでスクショ入力＋反復してモックアップを作り、複数画像は1枚のコンタクトシートから切り出してトンマナを統一、生成画像は表示枠の縦横比に合わせてcrop率を数値assert、モックアップ内の架空の数値は捨てる。Playwrightの検証コード付き。
「Driveからファイルを名前で探して画面に貼る」機能が実データで1件も当たらないのを潰す
台帳依存・探索の深さ不足・MIME絞りすぎの3つの落ち方を特定し、親フォルダ走査がドライブのルートを掴む誤検出と、途中で落ちて画面が空になる事故まで塞ぐ。副作用ゼロの診断関数で実データ検証する。
内容は同じなのに PR が CONFLICTING — CRLF 混入の見かけ上の衝突を修正を壊さず解消する
別コミットの改行コード変更で PR 全体が衝突に見える問題を --ignore-all-space で判定し、rebase -X renormalize で元の修正だけを乗せ直す手順。検証コマンド、.gitattributes での再発防止、複数 PR を worktree で同時に扱う時の罠と報告文の型まで。
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日更新などの制約と、自動化ブラウザ認証でアカウント停止に至った実害も記載。
本番スプレッドシートに「新しいレコードの列ブロック」を安全に増やす型(GAS)
横並び1レコード=N列のシートに、既存ブロックの複製で新しい列ブロックを自動追加する型。数式の相対参照追従・IMPORTRANGEの絶対URL差し替え・日付セルのread-back照合の罠・本番検証用の撤去コマンドまで。
定期実行の基盤移管で設定だけ置き去りになる不具合を症状から見つけて直す
cronをActionsから別基盤へ移した後、envが移らず通知停止・出力劣化が無音で起きる。診断手順・コード既定値化・secretの一時ワークフロー移送・検証まで
GASで商品ページのURLから品名・説明・画像・価格を抜いて登録フォームを自動入力する（文字コード自動判定つき）
JSON-LD→OGP→title の3段抽出、ヘッダー/metaを信じず化け文字最少で復号（楽天EUC-JP実測）、画像はDriveに保存。Node/Playwright/実環境の検証手順と落とし穴つき
並行AIセッションが共有リポジトリで事故らない型
複数のAIエージェントが同じ作業ツリーを共有する時の事故防止と、配布物を「配布可」と言う前の3層検証（コード・登録・配布）を手順化したMD
毎晩「消化している」つもりのバッチが同じ先頭N件をやり直しているのを見抜いて直す
残タスク一覧を無人バッチが上から消化する構成で、完了の書き戻しが未配線だと毎晩おなじ先頭N件だけが回り、以降に永久に到達しない。エラーもログも出ない。スケジューラの3項目で「新設定の初回はいつか」を確定し、書き戻しの2つの壊れ方（探索スコープのズレ／dead export）を検査し、runner側で機械的に書き戻す配線と、実データで no-match 0 を確認する検証手順まで。
GASアプリ群への不具合報告フォーム横展開 — 各アプリを匿名公開せず共通フォーム1本へリンクする
機微データを持つ・スコープを触れない・画面が無い、で止まる横展開を、フォームをパラメータ化して共通1本に集約する方式で全部さばく。器の選び方で人間のクリックを0回にする方法と、文字化け・公開範囲の検証3点まで。
SSGサイトへ商品を一括投入し、CC0画像を安全に付けて一覧まで反映させる指示書
Next.js App Router + DB の商品カタログにスクリプトで商品をまとめて追加する手順。Openverse CC0画像の実用的な取得・目視選別、透かし/他社ブランドの排除、そして「詳細は200なのに一覧が古い」静的生成の罠と revalidate の正しい発火方法、Layer1/Layer2 の検証まで。
共有作業ツリーから本番Apps Scriptを巻き戻さず部分pushする
本番をclasp pull→変更ファイルだけ重ね→差分表示→push→read-back検証→デプロイを1コマンドで行い、他人の新しい本番コードの巻き戻しとエージェントのBlind Apply拒否を防ぐ
「保存しましたと出るのに保存されない」は定期同期の上書きを疑う(GAS)
時間トリガーの取り込みが画面で直した値を元表の既定値へ静かに戻す不具合の切り分け・修正・本番検証の手順
AIが「報告された不具合」を否定する事故を Stop hook で機械的に止める
ユーザーが見たエラーをAIが『問題ありません』と否定して調査が止まる事故を、応答検査の3ルール(報告の否定禁止・証拠とベンダーの一致・到達不能な証拠は同じメッセージで依頼)で潰す。実際の事故文面をfixtureにする検証手順つき。
「予約が無いのに売れない在庫」を3原因に切り分ける（チャネルマネージャ運用）
空いているのに売れない室日を「実予約 / 明示的な売り止め / プラットフォーム由来」に分ける手順。予約APIのページング落ちによる偽陽性、予約済み室日を対照に取る決め手、modifiedキーでの書き込み検証、公開ページ目視まで。
GitHub Actions のジョブ実行時間を実測ベースで削る手順書
cron ジョブの Actions 課金を実測から削る手順。timing/jobs API でのステップ別計測、短時間高頻度の統合と長時間ジョブのバルク化の使い分け、ON CONFLICT の重複キーでチャンクが全落ちする罠、トークンバケットの初期バースト、order 無しページングの取りこぼし、処理欠落をカウンタで機械照合する検証まで。
委譲先の「テスト全通過」を信じない — 実データ dry-run で完成報告を潰す手順
AI に実装を委譲すると「テスト N/N 通過・完了」と返るが、テストは実装者の前提しか検証しない。実データで1回 dry-run するだけで4種類の欠陥が出た実例と、それを機械的に暴く指示書の書き方・検証の投げ方。
社内アプリの不具合報告に「対応したら本人の 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件のレビュー観点と本番検証手順つき
AIの応答を止めるゲートが「会話の後半だけ効かなくなる」罠を塞ぐ
Stop hook のゲートに入れる無限ループ防止の上限を『セッション累計』にすると、長い会話の後半で全ゲートが静かに無効化される。上限の単位を応答本文のハッシュ比較に変える直し方と、実プロセスでの検証手順。
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エージェントの応答に必須フッターを機械で強制する（ヒントではなくゲートにする）
「で、私は何をすればいいの？」「この画面は閉じていいの？」を利用者に聞かせないため、応答末尾の3行フッターを hook で強制する型。ヒント方式が素通りする落とし穴と、委譲修正を検証する不変量ゲートまで。
AIエージェントが「そもそも不要な手作業」を人に頼むのを機械で止める
手渡しゲートの3項目は「どう自動化するか」しか問わず、丸ごと不要な依頼を素通りさせる。依頼元・目的・目的の代替達成の3項目を前置して止める設計と、実装・検証・配布・クリック数削減まで。
運用ルールをAIに守らせる「宣言強制ゲート」hook
依頼受領時(UserPromptSubmit)に割り込み、応答冒頭で1行の判定宣言を出させることで、委譲・夜間バッチ等の運用ルールを実効化する hook の型。実装コード・登録方法・発火/非発火の検証コマンド・実際に踏んだ落とし穴つき。
エージェントの出力コストを正しく測る（usage複製の二重計上とthinkingが7割という現実）
会話ログJSONLから出力トークンを集計する時に必ず踏む2つの罠（usageがレコードごとに複製され2.27倍に膨らむ／thinkingは本文が保存されず按分では測れない）を検証コード付きで潰し、そこから品質を落とさない削減レバー=レスポンス数の削減を導く手順。
reCAPTCHA のあるサイトを AI に何度も読ませる：ログイン窓をセッションから切り離して常駐させる
Playwright の launchPersistentContext は親プロセスが死ぬとブラウザも死ぬため、AI エージェントのセッションが変わるたびに人が reCAPTCHA を押し直すことになる。detached 起動＋CDP 接続、プロファイル固定とログイン保持、管理者権限を使わないログオン常駐の3層で解消する手順。exit code 契約と、実際に壊して確かめる検証手順つき。
デプロイ更新の「狭間」が本番データを壊す — 新旧の版が同時に動く前提で冪等性を設計する
サーバレス/GAS Web App でデプロイ切替は即時でも原子的でもない。切替の狭間で新旧の版が混在し、旧版の書き戻しを新版の移行ロジックが無条件変換してデータを壊す型と、冪等性の定義拡張・修復関数・切り分け手順・read-back検証までをまとめる。
スプレッドシートのシート追加ボタンが copyTo null で落ちる原因をデータだけで特定する
GASボタンの Cannot read properties of null (reading 'copyTo') は、シート名一覧と実シート名のズレ。Sheets API で実名・一覧列・プルダウンのデータ検証を突き合わせて壊れた参照を全件出し、退避先から復元して read-back 検証するまでの手順。末尾スペース事故とバインド型スクリプトに到達できない制約も含む。
起動時フックが増えすぎてエージェントが立ち上がらなくなるのを直す
Claude Code が全タブで 'Subprocess initialization did not complete within 60000ms' を出すのは認証でもネットワークでもなく、起動時フックの合計時間超過。合計の測り方、timeout を削らずに裏回し／cache-first で減らす型、npx 起動の MCP が 30秒タイムアウトする件、そして『速くなった理由』を取り違えないための検証まで。実例 93秒→18.7秒
複数PCへ設定ファイルを自動配布する仕組みの設計と落とし穴
APIキーや通知先を全PCへ配り続ける仕組みの作り方。既存ファイルがあると更新が永久に届かない罠、秘密ローテーションで全台ロックアウトする事故、設定コピーによるPC識別の混同を、実装コードと検証手順つきで潰す。
セッションを閉じたら次のセッションが自分から再開するようにする（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段階の実走検証まで通す手順。
チャネルマネージャ価格自動化：送信成功を信じず全部屋の実売値を読み戻す
宿泊施設の価格自動更新で「送信成功ログが緑なのに一部の部屋の売値が何ヶ月も変わっていない」事故を防ぐ検証の作り方。連動価格・実効価格パラメータ・列対応の3つの罠つき。
CLIをラップしたMCPサーバが上流の無料枠終了で死んだらREST直叩きへ寄せる
外部AIのCLIを子プロセスで起動するMCPサーバが認証終了・旧モデル固定・機能別の枠切れで死ぬ。原因を4層で切り分け、ツール名を変えずに実行部だけRESTへ置き換える手順と、接続緑・テスト緑では足りない検証方法。
AIの記憶インデックスが読み込み上限で黙って切られる問題の検出と恒久対策
MEMORY.md 型の索引はサイズ上限で無言に切り捨てられる。バイトで測る→一行要約を本文へ移送→種別プレフィックスの二重持ちを外す→別実装で不変条件を検証、までの手順。最大の罠『デフォルトブランチに入れた≠各マシンで動く』の潰し方付き。
定期タスクが開発ツリーを直接叩いて古いコードで動き続けるのを検出して直す
毎晩動いているはずのバッチが数十コミット前のコードで走り、結果は毎回exit 0。専用クローン+同期ラッパへ張り替え、失敗注入と時間帯ゲートの罠まで含めて検証する手順。
常駐ジョブを作業ツリーの 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 実在確認＋直近成功へのフォールバックで画面を殺さない直し方。常駐プロセスの世代確認と実ブラウザ描画までの検証手順つき。
Airbnb ホスト画面の閲覧数・成約率を、ログイン済みの常駐ブラウザから自動で読む（クリックなし・JSON 化）
ホスト実績ページ（閲覧数・成約率）を CDP の常駐ログイン窓から読み、掲載別の JSON にする手順。本文の4行構造・下位10件しか出ない表の詳細ページ補完・browser.close 禁止などの安全規則・実ページ本文を fixture にする検証まで
AIエージェントが作った Windows 自動化が「静かに死んでいる」のを見抜いて直す
Botやコーディング AI に作らせたタスクスケジューラの常駐処理が、初回だけ成功して以後毎回失敗する壊れ方の判定・原因特定・恒久対策。最頻出原因は BOM なし UTF-8 による構文エラーで、PowerShell 5.1 経由でだけ再現する。実行せず構文検証する方法と、受け入れ条件の付け方まで。
監視の想定値を復元せず日次スナップショットの実値で照合する（偽警報の根絶）
動的に動く値（価格・在庫・配信設定）の監視で、想定値に今日の値や計算復元を使うと出る偽警報を根絶する。追記型JSONLの日次スナップショット＋発生時刻以前の最新を選ぶ純関数＋実値が無ければ判定不能(exit 2)で止まる設計と検証チェックリスト。
自動起動したCLIエージェントが初回プロンプトで固まる問題を潰す
無人で起動した Claude Code 等の TUI が「テーマ選択」「フォルダ信頼」の初回プロンプトで無言のまま止まる問題の恒久対策。theme を settings.json に置く理由（別ファイルに書くと消える）、信頼ゲートを人の同意付きで通す型、スクリーンショットで入力待ち到達まで目視する検証手順、効かない検証方法3つ。
Vercelのレジストラ API でドメインを取得し既存サイトを無停止で乗り換える
購入・DNS・リダイレクト・検証まで人手ゼロ。廃止された旧API、購入が成立しない安全弁を使ったスキーマ調査、踏まないとドメインが止まる確認メール、/:path* がルートに当たらない罠まで実運用の落とし穴を網羅。
Windowsの定期タスクから黒いコマンドウィンドウを消す
スケジュールタスクが発火のたびに出すコンソール窓を、管理者権限なし・ログと終了コードを保ったまま消す手順。wscript.exe経由の中継VBS、検証手順、適用してよいジョブの見極め、落とし穴の一覧まで。
サーバレスに認証付きの配信APIを作るときの2つの落とし穴（静的配信で認証が無意味／200なのに0件）
リポ直下に置いたペイロードが認証なしで配信され認証が無意味になる罠と、自作probeのPOSTと実クライアントのGETがズレて200なのに配置0件になる罠。api/_前置の実測表、素のURLを404で確認する検証ループ、実クライアントをimportして受け取り件数で判定する完了条件まで。
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・ページキャッシュ）。
MCP サーバーを npm 公開せずに GitHub 直接指定（npx github:）で配布する
npm publish が 2FA/権限で止まった時に、LP・README・init・テストの導線を github: 指定へ寄せ、push 漏れとキャッシュに騙されない検証まで含めた手順
サーバーレスに新secretを足さずローカルCLI+定期タスクで外部API連携を補完する
Vercel等に新規tokenを増やしたくない時、開発機の認証済みCLI(gh等)+OS定期タスクで冪等な差分同期にする設計パターン。throwawayレコードでの安全なE2E検証法とWindows PowerShellラッパーの文字化け/パースエラー回避も含む。
セッション途中で認証したコネクタを再起動せずに使う（claude -p 子プロセス＋stream-json 読み戻し）
claude.ai コネクタを作業中に認証したとき、ツール一覧が起動時に確定する制約を子プロセスで回避し、tool_result で送信を検証する手順
Supabaseで未ログインの人を管理者にし、その画面を本番で機械確認する（PKCEログインでもOK）
初回ログインでusers行を作るアプリで、本人のログインを待たずに管理者を用意し、magiclink→verifyOtp→cookie注入のPlaywrightで管理者画面を検証する手順
「直したのに直らない」— 同じ画面に書き込む経路が2本あるのを見落とす
利用者の不具合を直したのに直らない時の定番原因。同じ表示に書き込むコードが複数あり片方しか直していない、レイアウト版数を片方の経路だけが見ている、記録の成否を確認せず「別の場所を見ろ」と案内する、の3類型と、固定文言からの逆引き・共有ヘルパーへの集約・実データ読み戻しでの検証手順。
コンテナバインド型GASスクリプトを発見しDiscord Webhookメンションを安全にテストする
Drive検索/clasp listに出ないバインド型スクリプトをscriptIdから発見し、@here/@everyoneメンション変更を実チャンネルを汚さず検証する手順
Google Meet 自動参加&動画配信Bot 開発指示書
指定した時刻に Google Meet へ自動参加し、動画を再生しながら画面共有する Bot を、Claude Code に一発で作らせる開発指示 MD。朝会の定例動画配信・ウェビナーの自動放送に。
請求書PDF→会計CSV 自動変換パイプラインMD
メール添付やフォルダ投込みの請求書PDFから金額・日付・取引先を抽出し、会計ソフト取込用CSVに変換するパイプラインを AI に作らせる指示書。Claude API の構造化抽出プロンプト込み。
Next.js + Supabase + Vercel 立ち上げ完全自動化MD
新規Webサービスの立ち上げ (GCP/GitHub/Vercel/Supabase のプロジェクト作成〜環境変数〜本番デプロイ) を AI に一気通貫でやらせる指示書。人間の作業はログイン1回だけ。
スマホ(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で指示を渡すな等の実測の落とし穴つき
Google スプレッドシートの数式・外部参照を xlsx エクスポート＋openpyxl で AI に監査させる（開放範囲の切り詰め表示の罠つき）
数万数式・多数の IMPORTRANGE を持つスプレッドシートを読み取り専用で丸ごと解析する手順。DUMMYFUNCTION の復元、開放範囲が xlsx で切り詰め表示される罠をキャッシュ値の再計算で見抜く方法、QUERY の列対応、バインド GAS を直す前に clasp pull する理由まで。
Discord bot の Administrator を剥がす — 「自分では外せない」壁の越え方
bot は自分の最上位ロールを編集できない。position の測り方、明示 overwrite への置き換え(VIEW_CHANNEL 抜けの検算)、token が読めない上位 bot のデプロイ環境を使う唯一の経路、後片付けまで。
自動で価格・在庫を動かすAIに『毎日実機を見て・結果で判断して・止まったら気づく』をさせる運用の作り方
客側画面の実機読み戻し、同じ画面の近隣価格との比較、決定台帳の再判断日、PC外の心拍監視、出力妥当性検査、過去事故の自動プローブ化までを1日5回の点検ジョブで回す型
Vercel の Sensitive 環境変数が誰にも読み戻せない状態を作り直さずに解消し、Development 正本＋毎日の差分監視で恒久化する
本番 env が全て Sensitive で共有不能なとき、skip-domain の一時本番デプロイ＋RSA 暗号化で1回だけ取り出し、Development を正本化、env:set 入口と GitHub Actions の parity 監視で再発を止める手順
GAS完全自動化テンプレ — Driveコマンドキュー方式
Google Apps Script の「毎回エディタで▶実行」を根絶。Drive 経由のコマンドキューで、初回1クリック以降は AI がすべての GAS 関数をリモート実行できるようになるテンプレート指示書。
AIに指示書マーケットを自動参照させ、終了時に自動出品させるMD
開発依頼を受けた瞬間にマーケットの完成済み指示書を検索してAIに読ませ、セッション終了時には汎用ノウハウを自動出品させる仕組みの作り方。全台配布・秘密情報スキャン・実際に踏んだ配布バグ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 など失敗が沈黙する罠と、環境依存で落ちないテストの作り方までを実測ベースでまとめた導入手順。
「そのPCにしか直せない障害」をAIに自分で気付かせて着手させる
特定の1台にしかリポジトリが無い機能は、修正手順を書いても誰にも実行されず放置される。SessionStart hook で当該PCのAIだけに指示を出し、完了後は指示書へ状態を書き戻して再実装事故を防ぐ型。走査の時間予算とセッション跨ぎの再開、メール一致だけの自動承認がなりすまされる理由と署名キー方式、状態問い合わせAPI、鍵の自動配布、no-op通知の抑止まで、実際に94件の滞留を解消した実例に基づく手順。
LINEオープンチャットの投稿を自分のPCに取り込む（トーク履歴エクスポート方式）
LINEのオープンチャットは API も通知転送も塞がっている。唯一通る「トーク履歴エクスポート」を PWA の Web Share Target で受けて全文を蓄積する手順。塞がっている経路の実測結果、実ファイルの正確なフォーマット、全件再取込に耐える冪等設計、失敗検体の保存まで含む。
ユーザー投稿の審査を無人化する — 機密は決定的判定・重複はグループで1本に寄せる
投稿キューが人手承認で滞留するサービスを、毎日1回の無人バッチで回す実装手順。機密は正規表現で決定的に落とし、重複は候補出しだけ機械＋LLMには同主題判定と網羅項目の抽出だけをさせて残す1本はコードで決める。ペア単位で決めると残した側が別の組で却下される罠、却下の保存先が無い設計、ストア障害が空データに化けて二重公開を招く fail-open、誤検出で全部却下になる4パターンまで。
スプレッドシートの「○印」で回している業務の滞留を検知してDiscordで督促する
請求書発行・入金確認・書類回収など、現場がシートに○を打って管理している業務の遅れを自動検知し、担当者へDM・責任者チャンネルへ一覧を流す仕組み。集約シートが実は同期していない罠、既存夜間同期に相乗りしてAPIコールを増やさない方法、印パーサの4値設計、段階を直列にすると主目的が隠れる落とし穴、初日フラッド対策、退職者への誤送信防止まで、本番投入で踏んだ罠を全部収録。
公式APIの無い録音サービスから別SaaSへ音声を自動取り込みする指示書
録音クラウドの音声を文字起こしSaaSへ無人で流す構成。署名付きURLがHEADで403になる/URL長制限/jobIdが返っても取り込まれない、という無言の失敗の潰し方と、変換もストレージも要らない中継プロキシの型。
DB型サイトを「一覧だけ会員限定・個別ページは残す」に切り替える指示書（Next.js App Router）
自社DBで集客していたサイトが競合のリスト抜き取りに気づいた時の改修手順。名前が並ぶバルクな一覧だけを会員限定にし、個別ページはtitle/H1とCTAを残す。ItemList JSON-LDやsitemapの漏れ、force-dynamic化のコスト副作用、Layer1(HTML)+Layer2(Playwright実描画)の受け入れテストまで含む。
複数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へ日次同期する構成と落とし穴
Windows定期タスクが同じ秒に起動すると片方が無音死する（隠しランナーの共有ログとcmd >> 排他）
result=1・ログ0行で死ぬ定期タスクの真因が、隠しランナーが全タスクのログを1ファイルに流し cmd の >> が排他で開くことだった件。再現手順・切り分け・ログ名分離と設置先の自己更新・同一秒起動テストまで
AIの応答を止める番人hookを1ランナーに統合し、書き直しを最大1回にする（誤爆率をfixtureで先に測る）
Stop hook を9本積んだら Stop の65%が書き直し・最多ゲートの91%が誤爆だった。誤爆測定→否定文除外→1プロセス合流→再試行上限統一→全PC移行→KPIで効果確認までの手順。
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)・在室ウォッチドッグ・タスク登録の文字化け回避まで実運用ノウハウ込み。
定期バッチの「全面書き戻し」が新規行を消す事故を、検知・修正・復旧する
スプレッドシートの定期更新バッチが開始時スナップショットを全面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本と、空回り分を削減効果から差し引く理由、実測で機能しなかった指標を棄却した記録つき。
LLMで既存スプレッドシート明細の更新案を作る — 本番で壊れない7か条（GAS）
議事録・メールからLLMに明細の更新案を作らせ、元シートの複製に元の行位置で書いて値貼付で反映できる形にする。rowIndex突合・行位置保持・空ブロック除去・非致命read-back・顧客文ガードなど本番6回で確定した設計
アプリ開発の主体を別アカウントの Claude Code へ移管する（権限付け替え＋判断依頼の経路つき）
引き継ぎ書・GitHub/Drive 権限付与・判断依頼プロトコル・カットオーバー条件・途中で移管先を変える手順を1セッションで完了させる型。相手側の人の操作は起動文1回と OAuth 同意1回
安いAIレーンが壊れたまま何週間も放置される問題を、ヘルス判定と応答ゲートで潰す
委譲先AI(Codex等)が環境要因で落ちても監督AIがフォールバックで作業を続け、故障が放置される。ヘルス判定のseverity設計・失敗の誤分類・応答ゲートの軽い免除を直し、修理報告を機械検査で必須化する手順。WindowsでCodexのWSL経路を管理者権限なしで復旧する実測手順付き
チャットとメールを横断して「やること」を優先順位付きでスプレッドシートに集約する
Discord等のチャットと共有メールボックスから改善点・タスク・締切・決定待ちを毎日抽出し、1枚のスプレッドシートに優先順位順で積む。チャットだけ見ると「完了済みを未着手と誤報告」と「本当の締切を見落とす」が同時に起きるため両方を1つの台帳に入れる。Bot権限がそのままカバー率になる罠(実測2.5%)、件名の古い期日に騙される罠、収集だけ作って消化を作らず台帳が滞留する失敗まで含む
無人バッチの「黙った空振り」を発見して止める（冪等取込の設計）
定期バッチがエラーを出さないまま毎回同じ仕事をやり直している状態の検出法・典型的な真因（取込済み集合を実体の単一カラムで持つ）・台帳による修正・打ち切り付き再試行・CI課金での効果実測まで。
Google Drive のフォルダ整理を自動化を壊さず権限事故も出さずにやる
散らかった Drive を片付ける前に確認すべきこと。フォルダ移動は ID 不変なので安全だが、共有フォルダへ移すと権限が黙って広がる。簡易APIは権限を過少報告し、継承権限は子フォルダから削除できない。二重化を起こす名前検索の見分け方と、権限削除スクリプトの安全機構、再発源の潰し方まで。
シートに打合せ日時を書くだけでカレンダー予定＋Meet発行＋前日リマインドGmail下書き（Apps Script）
案件シートの日時列を15分巡回し、Calendar API v3でMeet付き予定を作成、前日9時以降に顧客宛リマインドを下書きで1回だけ作る。招待メール抑止・冪等キー・日時変更追従つき
宿泊ゲストのメッセージ1年分から誤解・キャンセル要因と改善点を週次で自動抽出する
PMS(Beds24等)のメッセージをキャンセル込みで差分取得し、Gemini の map-reduce で誤解を招く掲載文・訴求点・改善点を週次レポート化する手順と落とし穴
freee会計API 取引先自動連携ガイド(OAuth/トークンローテーション/DRY-RUN)
Next.js+SupabaseアプリからfreeeのOAuth接続・refresh_tokenローテーション対応・取引先の自動紐付け/新規作成をDRY-RUN安全に実装する手順
配布したツールが既存端末にだけ届かない障害の診断と再発防止
全PCへ配ったhook/スクリプトが、新規端末では動くのに既存端末にだけ永久に届かない。凍結コピー・拡張子を無視した重複判定・無言return の3重奏で、テストは全green・自己診断もNG 0のまま気づけない。実際に踏んで直した診断手順と、再発を止めるテスト設計(既存端末フィクスチャ/チェックリスト網羅性の機械照合/故障注入)。
Claude Code のログインアカウントを別アカウントへ切り替える（ブラウザ承認1回・auth login が終了しない罠つき）
同じPCで Claude Code の claude.ai ログインを別アカウントへ移す手順。認証ファイル1本の構造、事前棚卸し（env上書き・無人タスク・コネクタ・routine）、非同期ログイン＋status ポーリングのスクリプト骨子、logout が復元不能な点と切り戻しまで。
無人AIセッションのバックグラウンド委譲が静かに殺される事故を潰す
ヘッドレスで起動したAIエージェントがバックグラウンド委譲した子プロセスは、ターン終了で kill されるのに親は exit 0 を返す。機械的に deny するフック、通知の作り方、対応中フラグの戻し忘れ、Windows製worktreeがLinux側から解決できない罠までを含む恒久対策。
無人自動化が「成功ログを出して何も起きない」3つの理由（Windows・外部CLI経由でURIを撃つ型）
exit 0 を返して実際には何も起きない無人ジョブの3つの構造的原因と回避策。cmd.exe が未引用の & でコマンドを分断して一部パラメータだけ消える／spawn イベントは配送完了ではなく親が先に終了して届かない／更新したプラグインは再読み込みまで旧版が動きディスク版で分岐すると恒久的に詰む。2信号ゲートと判定表、end-to-end を実行できない時の誠実な報告の型まで含む。
自社の沿革を登記簿＋公式リリース＋Webから総合して年表スプレッドシートにする
Web記事だけで沿革を作ると設立地も年号も間違える。登記簿を骨格にし、公式リリースを肉にし、Web検索は裏取りだけに使う手順。確度列つきの表設計、CSVのカラム崩れ検査、更新でURLが変わる罠まで。
Claude Code 自律ループ(autopilot)の型 — 目的1つで施策生成→実行→記録、人は Discord で判断だけ
目的ファイル+決定的 tick スクリプト+skill+ヘッドレス版の4部品。上限と番犬で自動停止し DM、人は『続けて/止めて』を返すだけ。配布の鶏卵問題と handoff 副作用の回避込み
GAS 新規立ち上げ標準手順(clasp+コマンドキュー)
clasp と自作コマンドキューで、run-function 封鎖の Workspace 環境でも AI から GAS を継続実行できる新規プロジェクト立ち上げ手順。人間の作業は setupOnce の1クリックのみ。ホワイトリスト実行・並走防止・機密値の置き場も規定。
GitHub Actions の課金分を実測ベースで削る
Actions の請求を推測でなく実測から削る手順。ジョブ単位の分切り上げという課金構造、ステップ別に時間を割る API の叩き方、短時間高頻度は統合・長時間は per-row 往復の一括化という打ち分け、並列度を上げても効かないケースの見分け方、そして『遅いステップが実は同じデータを毎回処理し直している欠陥』の見つけ方まで。本番の夜間ジョブを実測目的で再実行して重複レコードを大量生成した失敗例と、その巻き戻しの作法も含む。
AIモデルの課金区分を実測で確定し、ルールを機械に強制させる
「このモデルは定額内か従量課金か」を推測で決めると外れる。支出レポートで確定させる手順と、確定結果を単一の設定源+3層のフックで強制する型。安いモデルが実は高い（キャッシュ書き込み）の見つけ方も含む。
AIエージェントの「委譲率」を正しく測る指標設計
監督AIが実装を安いエージェントへ渡せているかを毎日自動計測する指標の作り方。トークン比が飽和する/分母を landed 行にすると100%に貼り付く/編集ツールだけ数えると逆向きに嘘をつく、の3失敗と対策・増分キャッシュでの高速化まで
社内アプリの必須機能を、ルール文書ではなくデプロイ直前の hook で強制する（Claude Code）
「全アプリに○○を入れる」が文書だけで守られない問題を、本番反映コマンド直前の PreToolUse hook で未搭載・台帳未登録を deny して潰す型。除外ファイル・fail-open・全PC配布・テスト一覧つき
無人実行ジョブが「働いたのに何も残らない」を潰す設計
cron/タスクスケジューラからAIエージェントや長時間処理を無人で走らせる際の2大事故（タイムアウトkillで出力が丸ごと消える／実行されるコードがその瞬間のHEADで決まる）を構造的に潰す実装指示書。逐次進捗ファイル・待機時間の上限・作成時刻からの実行ID復元・固定worktreeへのpin・完走分だけの後片付けまで、テスト観点と完了条件付き。
「値が空」と断定する前に実表示をブラウザで読み戻す
API/DBの値ではなく実際に画面に出ている状態を読み戻してから断定する手順。変更の有無を問わず、価格・在庫・掲載文など外部露出状態の調査・報告に使う汎用スクリプト付き。
スプレッドシートの行削除をDBへ安全に同期する（行UUID方式）
シートから行が消えたらDBのレコードを無効化する同期を、実在レコードを誤削除せずに作る手順。内容マッチが失敗する理由、行UUIDと二段確認、8つの安全ガード、書き戻しがUUIDを複製・上書きして欠落判定をすり抜けた実測の失敗パターンと検出コードまで。
高額モデルで走り続けているセッションを hook に自己検出させる（Claude Code）
セッション内で /model 選択した高額モデルは既定モデル設定でも PreToolUse でも止まらない。hook stdin の transcript_path で自セッションのモデルを読み、毎ターン警告を注入する型。全読み禁止・async exit・realpath 起動判定・BOM の落とし穴と、集計側に発生元セッションIDを載せる改修まで。
Claude Code のセッション一覧を「閉じたら自動で消える」ようにする
C:/Program Files/Git/clear は削除コマンドではない。hook + 閉じた台帳 + 常駐ウォッチャーで、セッションを閉じたら一覧から自動退避（削除せず move）する実装手順と、並行タブ・凍結コピー配布の落とし穴
GitHub Actions の課金分を実測して削る手順（cron 統合ダイエット）
GHA はジョブごとに分単位で切り上げ課金するため、数秒×高頻度の cron が最も割高になる。/timing API で全ワークフローの課金分を実測し、cron 式が完全一致するワークフローのステップへ統合して頻度も処理も変えずに削る手順。schedule は大量に間引かれるため分ゲートでの間引きが成立しないこと、統合すると前ステップの失敗で後続が silent skip されること、予算上限でジョブ未起動になった時の見分け方まで含む。
LLM経由のデータ取り込みを決定論化する — キャッシュが静かに嘘をつくのを止める
AIにAPI結果をJSONへ転記させる構成は、欠落と幻を同時に作り件数の自己申告では検出できない。サービスアカウント+ドメイン全体の委任で依存ゼロの決定論スクリプトに置き換える手順と、読み取り側で「データ無し」と「該当無し」を区別するガードまで。
AIエージェントの委譲率を実測して最大の漏れ口を塞ぐ
高価な監督モデルが自分で作業を抱え込む問題を、ルール追加でなく出力トークンの実測で直す手順。推論トークンの誤帰属・指標の逆インセンティブ・強制層の昇格の穴という3つの典型原因と、パイロット限定の段階導入まで。
スプレッドシート実行パネルの結果セルを必ずクリック可能にする(GAS)
GASでシートを操作パネルにした時、生成物リンクがセルに出ず別シートを探させてしまう問題の潰し方。URLキーの総なめ収集・RichTextで複数リンク・過去分の埋め戻し・再構築で消える罠・全走査で6分制限に当たってトリガが死ぬ罠まで。
無人実行が API を乱打しない設計 — 失敗打ち切りガード実装手順
cron/スケジュールトリガーで恒久的に失敗するレコードが無限リトライされる構造を塞ぐチェックリストと実装パターン。失敗カウンタは試行の前に保存、冪等なリソース生成、復帰コマンドの用意まで。API乱打によるアカウント凍結の予防。
AIに壊させない「変換」の作り方(不変条件とリトライ閾値)
AIに圧縮・移行・整理を任せると『指示どおり動いたのに情報が消える』。IDだけをassertしてタイトルと説明が消えた実例と、人間が読む全フィールドに不変条件を掛ける書き方。あわせて『N回失敗で打ち切り』が試行レート変更で1晩で発動した失敗と、異なる日数で数える実装。
「共有した雛形に書き込めない」問い合わせを消す — Googleフォーム→本人専用ドキュメント自動発行（GAS）
雛形リンク配布をやめ、フォーム入力から本人専用のGoogleドキュメントをGASで自動発行・共有する。原本は閲覧のみのまま、権限リクエストと問い合わせをゼロにする手順とWorkspace固有の罠
外部アプリがフォーム連携シートに行を足すと通知が飛ばず埋もれる問題を潰す（GAS）
フォームの onFormSubmit は直接 appendRow では発火せず、挿入行は回答追加のたびに押し下げられ、担当者名も空になる。3症状を「フォーム外の書き込み」という一因で捉え、列マップ確定・通知・名寄せまでアプリ側で完結させる実装指示書。
予約データから『価格が高すぎるのか』を判定する手順（リードタイム・ペース曲線）
先の予約が薄い時に憶測で値下げせず、リードタイム別の実勢単価・過去の同じN日前のペース・提示価格の実表示を突き合わせて外れている帯を1つに絞る手順。在庫の穴の見つけ方つき。
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委譲が「毎日成功」の裏で全滅する3つの穴と塞ぎ方
受け取りファイルの置き場所・上限エラーの保留化・作業種別の振り分けで、Codex 等への無人委譲が静かに全滅するのを防ぐ。完了の定義は実環境1件の成功ログだけ
複数の AI セッションが同じ Apps Script に clasp push しても互いの反映を消さない
clasp push は全置換なので、古いスナップショットからの push は他人が足したファイルを黙って消す。pull→上書き→push の連続化、別ディレクトリでの read-back、消された側が並行相手の staging に同乗させる復旧手順。
Codex 委譲の指示書で「シェル禁止」を書くと変更ゼロで止まる — テンプレと差分ベースの成否判定
Claude→Codex の指示書に受け渡し規約の『シェル禁止』を転記すると Codex が確認待ちで止まり exit 0・変更ゼロになる。原因・指示書テンプレ・exit code でなく git diff とテスト件数で成否判定する手順。
共有ブラウザで Playwright の connectOverCDP が止まる時は目的タブに直接 CDP で繋ぐ
重いタブがある常駐Chromeで attach がハングする原因と、page ソケット直結で読み書き・保存・読み戻しする手順
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 を無くして二度と番号だけにしない手順
Beds24 API v2 で予約を漏れなく取る — 黙って欠ける3つの罠（到着日フィルタ・100件ページング・応答切れ）
Beds24 API v2 の /bookings と /properties は HTTP 200 のまま予約・部屋が欠ける。arrivalFrom は到着日フィルタ、/bookings は100件ページング、/properties は応答切れ。回避コード付き
ハードコードのドロップダウンenumを設定で編集できるDBマスタに移行する
UIに配列でベタ書き＋DB CHECKで固定された選択肢を、利用者が設定画面から追加/編集できるマスタテーブルに一本化する手順。value-keyed分岐を壊さない落とし穴つき
アプリ内フィードバック→責任者DM→Issue→自動修正PR→1タップ承認
社内アプリの不具合報告を、責任者の個別DMに届け、Issueにして夜間に修正PRまで自動で作り、承認は既存のPR画面のMergeボタン1タップで済ませる設計。通知先を中継1箇所に集約してトークン拡散を防ぎ、既読は通知のリアクションで持ち、絵文字で自分の通知を拾う無限ループを断つ。
値下げが元を取れたかを 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件と誤読しない判定手順つき。
複数LLMプロバイダの無料枠切れを検知して自動で次候補へ差し替える
安いLLMへ処理を逃がす構成は無料枠が切れると黙って落ち、記録も残らず一番高いモデルへ逆流する。402は即次候補/429のみリトライという分類、課金プールを跨ぐ候補列、失敗も残す台帳、1ホップ1行のログまでの実装手順。連鎖の順番を実測で決める方法（単価最安≠実効最安/ベンチ飽和/正規表現採点が上位モデルを落とす罠）も収録。
クラウド定期実行エージェント＋Drive台帳で小規模施設の集客PDCAを無人で回す（週次レポート／月次レビュー）
Claude Codeのクラウドルーティン（cron）とGoogle Driveの台帳だけで、集客施策の実行・結果回収・次施策の提案を週次/月次で無人化する手順。Doc/CSV変換の罠、Shift_JIS対策、クラウド環境のネットワーク制限の落とし穴つき。
Claude アプリの Code 一覧に溜まる古いリモートセッションを自動アーカイブする
PC側ログを消しても減らないスマホ/Webの切断済みセッションを、内部APIで24h超のものだけ6時間ごとにアーカイブする hook
別環境で作られた未マージ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回だけ
PCの定期ジョブが丸ごと止まったことをPCの外で検知する（Apps Script心拍・dead-man switch）
PC上の見張り番はPCと一緒に死ぬ。各ジョブがApps Scriptへ心拍を打ち、来ない心拍を外側の時間トリガーが鳴らす構成と、日付書式で監視が永久に赤くなる等の実際の落とし穴
請求書・領収書を「別シートに1行入れるだけ」で作る GAS 帳票テンプレ
スプレッドシートに 帳票/データ/設定 の3シートを組み、入力1行で印刷用帳票が完成する構成をGASで作る。セル値の読み戻しでは検出できない印刷時の文字切れを、PDF書き出しの目視で潰すまでを含む。
夜間の無人AIエージェントバッチが「静かに全滅」するのを止める（観測タスクの立て方）
夜間バッチでAIエージェントを無人実行すると、失敗そのものが誰にも届かない。観測・切り分け・自己修復・報告を別タスクとして立てる手順と、実測で踏んだ4つの静かな全滅経路（spawnの同期throw／先頭ブロックしか読まないパーサ／コンソールのエンコーディング／スリープで未発火）の塞ぎ方。
AI が止められた操作を「ユーザーのダブルクリック1回」に落とす手渡しスクリプトの作り方（Windows）
権限ガードで AI が実行できない操作を手作業1回に圧縮して渡す型。.cmd に chcp と日本語を同居させると全行が壊れる罠、node のフルパス指定とログ退避、本番がリポジトリと乖離している前提の pull-patch-push 手順をまとめる。
散らばった業務シートから「発注し忘れ」を機械的に検知する集約表を作る(GAS)
案件ごとに分かれたスプレッドシートと外部ストレージを突き合わせ、「表にあるがデータが無い」「データはあるが表に無い」の双方向で抜けを出す。品名列が複数ある/テンプレフォルダが空/6分制限/トリガー上限など、実測で踏んだ罠と回避策つき。
配布したhookがWindowsで静かに死ぬのを塞ぐ — process.exit と top-level await
AIエージェントのhookが「出力は正しいのに反映されない」形で無効化される真因と、ネットワークに依存しない回帰テスト・変異テストの型
X(旧Twitter)自動投稿を従量課金時代に立ち上げる手順書
無料枠廃止後のX APIでGitHub Actions定期投稿を構築する。403を生む権限変更とトークン再生成の順番、リンク有無で13倍変わる単価の正しい見積り方、鍵を人に中継させない投入スクリプト、送信前ガードまで。
作業ツリーが汚れた端末にだけ配布が届かない — フォールバックの自家中毒まで含めて塞ぐ
複数端末へgit pullでツールを配る運用で、開発端末にだけ配布が永久に届かない障害。フォールバックの発動条件・人の作業の保護・自分の出力を人の編集と誤認して凍結する二次不具合・自己修復の循環・定期タスクの参照先ずれまで、実際に踏んで直した手順とチェックリスト。
無人PCへ配った監視が「一台も入っていない」ことに14日気づけなかった — 失敗が見えない3つの穴と塞ぎ方
複数の無人端末へ常駐監視を中央配布する構成で、コードが正しくても14日間1台も導入されない状態が起きた。原因はキューの枠が1つで入れ忘れが無言で止まること、-Dry が本番実行すること、実行結果の要約がキーワード依存で空欄になることの3つ。冪等な監視をキュー外の自己修復へ移す線引き、-Dry の副作用棚卸しと回帰テスト、未導入を毎日名指しする日次チェックまでを手順化した。
止まった作業を毎晩検知し、進められるものだけ自動で前に進める
CI通過済みPRが18日放置された実例から、締切・通知・自動前進の3点を備えた夜間検知を作る。通知が埋もれない設計（行動できるものと在庫の分離）と、実測で踏んだ落とし穴まで含む。
無人ジョブの「安いAIへの委譲」がWindowsで毎晩空振りする事故を潰す（spawnが.batを起動できない）
夜間の無人ジョブで「実装は安いモデル、失敗時だけ高いモデル」の二段構えを入れても、Windowsでは PATH上のCLIが.batラッパのため spawn が ENOENT で即死し、安い側が一度も起動しない。0.0x秒/出力0という失敗の署名で犯人を確定させ、実行ファイルの絶対パスを解決する純関数（shell:trueを使わない・.batを候補にしない・版はディレクトリ名で比較）を入れる型。あわせて「起動できない機体」と「起動したのに空」を台帳で分けて直せない宿題の自動起票を止め、force上書きで配られる共有ツールへの修正を冪等な再適用＋依存ジョブ前の予約実行で守る。
作ったのに一度も動いていない安全 hook を炙り出す
実装もテストも揃っているのに設定に未登録で一度も実行されていない hook を、毎セッション自動で検出する。誤検出で無視されなくする条件と、過去の「配線しない」判断を守る台帳まで含む
社内フィードバックを毎日AIの作業キューへ自動取り込みする（安全ゲート付き）
フォームに溜まる不具合・要望を認証付きAPIで毎日取得し、AIエージェントの作業キューへ冪等に積む。無人実行が本番コードを勝手に書き換えないための安全ゲートと、その回帰テストの掛け方まで。
全世界公開になっていた共有ドライブ資料を、業務を止めずに締める
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で足りる分担）を手順化。
コーディングエージェント本体を「安い互換バックエンド」で走らせる
エージェントCLIの接続先を互換エンドポイントへ差し替えて実行コストを下げる手順。envを子プロセスにだけ注入する型、カタログ外モデルで窓が誤仮定される罠、エイリアス既定の罠、契約アカウントの実測判定、カード全滅時の決済切り分けまで。
テストが全部緑でも検出器は死んでいる — 変異テストでテストの検出力を機械的に検定する
hook/gate などの検出器を無害化した変異体に同じテストを流し、通ってしまうテスト(=検出力なし)を摘発する。実測で34本中2本が該当。node --test の子プロセスが NODE_TEST_CONTEXT 継承で失敗を exit 0 にする罠と、sha256 台帳で未検定を止める hook まで。
AIエージェントの委譲率が上がらない時の診断と是正 — 委譲の準備と使い捨てスクリプトを分離する
監督AI＋実装AIの体制で委譲率が停滞する原因は規律の不徹底ではなく計測と強制層の設計ミス。シェル実行の中身を分類し、委譲の準備(仕様書執筆)と使い捨てスクリプトを分離してゲートを掛け直す診断手順。ヒアドキュメント区切り語の固定・未分類バケツ放置・指標が正しい行動を罰する構造、の3つの落とし穴つき。
共有ルールリポの「作り直し事故」を止める — 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点で機械的に潰す手順
外部サービスの権限設定を人に頼む前の3確認 — AIの「手順を渡したのに画面にその選択肢が無い」を潰す
AIが権限変更を人に手渡すとき、選択肢の実在・依頼の必要性・剥がした先を確認せずに渡すと手を止め状態も悪化させる。所有者種別から権限上限を調べる、当ターンで再実測する、取り消し前に現状を記録する の3確認と手渡し文テンプレート。
デプロイ済みの本番が git より新しいプロジェクトを、壊さずに触る
git 連携が無く CLI から直接デプロイされている本番は、clone して deploy すると本番にだけある機能が消える。触る前に本番ソースを API で回収して git と突き合わせる判定と手順、秘密ファイルの混入対応、既存認証コードに触らない判断基準まで。
「進めない先へ進んで空転する」を弾くガードが、代わりに全委譲を殺すのを防ぐ
サブのコーディングCLIは許可ワークスペースがcwd1つだけ。外を指す指示は18分空転する。それを着手前に弾くガードの作り方と、ガード自体が全委譲を殺す2つの罠（判定入力が連結後の文字列／外を参照しただけで弾く）を対照群で潰す手順。
「安いAIへ委譲しろ」の強制と委譲先の枠切れが重なるとAIは何も書けなくなる
実装を別AIへ委譲させる規律をフックで強制していると、委譲先が使用上限に達した日に「委譲も直接編集も不可」のデッドロックが起きる。解除条件を主経路とフォールバックの両方死亡時のみに限定する設計と、復帰時刻パーサ・状態ファイル隔離の落とし穴。
制約で候補を選ぶ機能が全滅する事故を止める — 判定用属性マスタの分離と提示前の実在庫確認
駐車場・宿・機材など「条件に合う候補を選んで出す」機能が全件使えない全滅事故を止める型。容量計算用の内寸と判定用の外寸を別マスタに分ける、区分を推測せず一次資料から取る、判定関数に除外理由と僅差warnを返させる、検索条件(必須/除外/確認)を機械が出力する、そして候補を提示する前に対象日の実在庫を確認し予約不要の代替を併記する。担当者と連絡先を帳票に出して人力照合を消す手順も含む。
ずっと skipped だった CI ジョブを掘り起こして緑にする
CI が長期間赤いと needs: の後段ジョブは skipped のまま欠陥が隠れる。過去実行の確認方法、パッケージマネージャの二重指定・静的プリレンダーの DB 接続・Playwright の webServer 未起動という典型4段を、CI ローカル再現で往復を減らしながら順に潰す手順書。
「直したのに効いていない」を潰す — hook と夜間ジョブが読むチェックアウトを検査する
AIエージェントに組ませた hook や夜間バッチは、main を直しても古い実体が動き続ける。設定が実際に指すファイルと origin/main の内容を比較して毎朝1通だけ通知する検査の作り方と、誤検知を殺す設計（ゼロ件カウンタ・散文ログ・VCS出力・ベースライン抑制）。
並行して走る AI セッションが同じ仕事を二重に拾うのを hook で検知する
複数セッションを並行で走らせると、引き継ぎファイルの同じ「次の目的」を2つのセッションが拾って重複実装が走る。基盤が持つ目的台帳は定型文で汚れていて使えない(無関係同士の類似度が1.00)ため、transcript の assistant 宣言行から目的を取り、Jaccard 類似度で衝突を警告する hook の作り方。ノイズ床の測り方、user行を拾う罠の回帰テスト、刺すイベントの選び方、設定登録後の構造 read-back まで。
Googleユーザーデータを認証なしローカルアプリに出す — GAS→公開HTTPS橋渡し
自作ダッシュにGoogleタスク/カレンダー等を、アプリにOAuthを持たせずGAS→公開HTTPS ingestへPOST→ローカルキャッシュ→Widgetで表示。Web App公開/clasp run/SA不要。funnel実ポート確認・秘密の置き場・basePath・本番再ビルド等の実測ハマりどころ付き
文字化けで宛先が決まらない1件がキューを永久に詰まらせるのを直す
自動処理キューで宛先解決に失敗したアイテムは「失敗」ではなく「スキップ」になり、exit 0 のまま毎晩リトライされ続ける。詰まりの検出、化けた文字列から元テキストを同定する指紋照合、壊れにくい第2キーへの許可リスト型フォールバック、そして「対象外にする」出口までを実例で通す。
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/文字化けの罠まで。
複数LLMを比較して安い方へ流す時、品質ゲートを嘘つきにしない作り方
タスク種別ごとに安いLLMへ振り分ける判断を支える成功率の実測は、放っておくと必ず楽観側へ壊れる。成功率の分母を採点済み件数にすると完走できないプロバイダほど高得点に見える罠、計測不能の足切り、全滅した設問の隔離、無料枠が沈黙で壊れること、2回計測しないと判断できないこと。実運用で3プロバイダが過大報告されていた事例の一般化。
AIエージェントが突然死する時の切り分け — アプリのバグかOSの資源枯渇か
exit 3221226505 の原因をイベントログとコミット率で5分で確定させる手順と、直し方を非エンジニアに1クリックで渡す型
google.script.run の null が undefined になる罠 — 本番だけ出る NaN 表示の自動検出
GASウェブアプリでサーバ側の null がブラウザで undefined になり、=== null の分岐が素通りして NaN が表示される。単体テストでもJSON fixtureでも再現しない理由と、null を落とした fixture で描き直して自動検出する方法。
GUI拡張の「他の環境には出るのに、ここには出ない」を設定探しから始めない
GUI拡張の機能欠落は設定ではなく版の不一致。稼働中の版をプロセスパスで確定し、別ウィンドウで新版をA/B（信頼無効化が必須）してスクショ目視まで自分でやってから、再読み込みを同意付きで渡す手順
自分が管理していない上流ファイルを差し込みで維持する型 — 死んだパッチを検知して retired に移す
上流が更新し続けるスクリプトに自分の修正を当て続ける仕組み。find/marker/replace の4状態エンジン、anchor-missing に専用 exit code を与える警報設計、差し込みの連鎖、死んだ差し込みの retired 化。テストが足りない値を注入していて壊れたコードが緑だった実害と、その塞ぎ方まで。
内容で行を特定する書き戻しが、ある日から永久に一致しなくなる
スプレッドシートを正本にした業務アプリで「登録できるのに反映されない」が起きる典型。正規化のtrimとsliceの順序で保存値の往復が非冪等になり、全行走査で0件ヒットになる。本番ログからの追い方、ハッシュを変えずに直す方法、重複行事故を防ぐ固定値テストまで。
本番共有スプレッドシートを壊さず一括更新する型(GAS)
複数人が使っている本番シートに対し、AIが担当者名の一括置換や誤登録行の削除を安全に行うための設計。dryRun→照合キー付き適用→独立read-backの3段と、GASのコード雛形・実際に踏んだ落とし穴つき。
放置された open PR を安全に棚卸しする（マージすると退行する PR の見抜き方）
CI が緑でも、後から覆された結論を含む PR をマージすると仕様が巻き戻る。使い捨て worktree で残差分ゼロ判定・陳腐度の数値化・退行検知を行い、マージ/クローズを機械的に振り分ける手順。read-back とクローズ根拠コメントのテンプレ付き。
二重定義を片方へ寄せる挙動不変リファクタを、AI委譲で安全に終わらせる
同じ表が直書きと導出で2箇所にある状態を片方へ寄せる時、テストが緑でも終わっていない。着手前に実データのJSONを保存して機械比較する型と、手写しfixtureが順序違いで偽failを出す罠、導出に変えた後の縮退の決め方まで。
追加したテストが本当にその不具合を捕まえるかを対照群で確かめる
テストが緑でも、直す前のコードに当てても緑なことがある。直した箇所を1つずつ無効化して赤くなるか確かめる手順。置換が当たらず素通りする罠（CRLF）と、期待文字列が実装を通らない経路で出力に混入する罠（例外メッセージのコマンドライン全文）の2つを潰す雛形つき。
正しく動く検知器が一度も発火しない — 「検知力」ではなく「いつ聞かれるか」を先に測る
テストは全部green、検知力も正常。なのに事故が繰り返される。原因は『情報が無いから黙る』早期returnが、一番危険な『これから選ぶ瞬間』を必ず素通りさせていること。実物入力での検知力の単独測定、判断が決まる瞬間の名指し、同一入力の前後比較と対照群4種までの手順。
GASの時間主導トリガーがデプロイ版に固定される罠 — 「成功したのに何も起きない」の切り分け
clasp push しても時間主導トリガーは旧バージョンのコードを実行し続ける。エラーも出ず戻り値もOKなため原因が特定できない。新関数プローブで実行中のコードを確定させ、clasp deploy -i でURLを変えずに直す手順。
別シートの列番号が腐って別レコードの値を返す事故の直し方（名前照合＋日付タイブレーク）
保存した列番号は列の挿入削除で全件ズレる。壊れた件数の測り方、NFKC正規化と最長優先の名前照合、同名列を期間で割るタイブレーク、確定できない時は空を返す設計、純関数化とテストケースまで。
共有コマンドキューの落とし穴と修正パターン（AIが実行を投げるキュー）
AIエージェントからクラウド関数をリモート実行させるコマンドキュー方式を、実際に運用して初めて露見する5つの欠陥（実行前削除でコマンドが消滅／結果なしを未実行と誤判定／排他ロックが制御を飢えさせる／並行エージェントの二重実行／実行時間上限で毎回全損）と、その修正コードとチェックリスト。
LLM監査ゲートの誤検知を直す — 弾いているruleを台帳で数える／AI自身は直せなくなる
LLMに規則本文を注入する監査ゲートで誤検知が出た時の直し方。当たりを付けたruleはほぼ外れるので台帳のviolations[].ruleを実測で数える。例外は番号を振らず横断で1つ足す(番号を振るとバリデータが壊れaudit-unavailableで通る)。そして規則ファイルはAI自身が編集できない(Instruction Poisoning判定)＝設計時に人の更新対象と決めておく。
数MBのドキュメント群から必要な記述だけ取り出す — 分割委譲＋逐語照合の型
社内Wiki書き出しやマニュアルの束（数MB）を監督モデルの文脈に載せずに読む手順。1ファイル1サブエージェントで並列抽出し、別エージェントで原文へ差し戻して逐語照合する。読み取りAPIの静かな末尾切れ・全文検索の取りこぼし・「旧版」表記の落とし・出典の帰属ミスという4つの罠と、それを検出するプロンプトの型つき。
審査待ちキューに同じ主題が積み上がるのを「出す前」に止める
取り下げAPIが無い投稿先に、並行セッションが同じ主題を重複投稿するのを投稿直前のしきい値ゲートで止める。しきい値は勘で置かず既存ログの再生で決める手順まで含む。
AIエージェント同士の非同期メッセージで「未返信」を誤判定しない
受信箱の無出力・exit 0・バウンス通知の3つが重なり、実際は送信済みなのに「N回連続で未返信」と引き継がれ続ける壊れ方。行為ログで1分で潰す手順と、作る側の設計チェックリスト。
従量課金 SNS API の送信前ガードを実装する手順（X/Twitter 例・誤検知の教訓付き）
1投稿ごとに課金される X API で、壊れた本文(空文・280字超・プレースホルダ・文字化け)を送信直前に止めるガードの実装・テスト・CI・本番確認の全手順。裸の TODO が本文の普通語を誤検知した実測と回避策、委譲時に防護解除を禁止する1行を含む
PMS のセット販売用「仮想部屋」の予約が『閉室・原因不明』に見える罠と直し方（Beds24 の room dependencies）
セット部屋（仮想部屋）の予約で構成室が numAvail=0 になり集計が『閉室・原因不明』と誤計上する仕組みと、3 回の GET での診断、予約を構成室へ展開する共通純関数モジュールで全ツールを直す手順
AIセッションの引き継ぎを信用せず、着手前に実システムを読み戻す
永続メモリ＋引き継ぎファイルでAIエージェントを跨セッション運用すると「完了済みの作業を作り直す」事故が起きる。着手前のexit code判定・古い結論の打ち消し・ロック保持者の設計・非対話時の承認境界の4つの型。
シート対応済みチェック＋期限超過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件と回避策つき。
「AIが本番デプロイを禁止されている」と誤診しないための切り分け手順
自動承認モードの分類器に本番デプロイを止められた時、真因は権限ではなく叩き方(ランナー経由起動・サブエージェントへの委譲・承認スキップフラグ)であることが多い。6点のチェックリストで切り分け、人に手作業を振る前に自力で通す。
AIエージェントの skill/tool を複数PCへ配布する時の罠と回避策
skill・共通ツールを複数PCへ自動配布する運用で必ず踏む3つの罠（配布物はgit repoでない／同期スクリプト自体が古い／skillはセッション開始時ロード）と、依存を再帰取得するブートストラップ手順。
既存の Claude Code 環境に「学び台帳・Decision Record・母数照合・HANDOFF」を後付けする手順
CLAUDE.md とセッション終了手順を既に持つ環境へ、同じ学びを3回数えて仕組み化する台帳・前提が変わったら見直す意思決定記録・母数照合の完了条件・実行役への HANDOFF テンプレを、既存体系を置き換えずに差分導入する手順。
Vercel独自ドメイン接続+証明書発行待ち自己解決MD
外部レジストラのDNSをVercelに繋ぐ手順と、HTTPSだけ繋がらない時にvercel certs issueで手動発行して数十分の待ちを数十秒に短縮する診断フロー
ページングAPIで「全件取れたつもり」が4%だった — 静かな取りこぼしの検出法
limit を無視して常に20件返すAPIに対し offset を要求limit分進めていたため6,902件中280件しか取れていなかった。テストもCIも緑だった理由と、本番の意地悪さを再現するモックの書き方。
CI が全部 green なのに auto-merge されない PR を原因から特定して自動マージに乗せる
GitHub の auto-merge が効かない原因は権限ではなく fork であることが多い。切り分けコマンド、ワークフローの5条件の読み方、正しい提出経路、ラベル忘れが成功に見える落とし穴、GraphQL と REST の2系統を実測付きで示す
X API 従量課金で「リンク付き投稿13倍」を避ける — 本文URL除去とプレ送信ガード
X APIはリンク付き投稿が/usr/bin/bash.20と13倍高い。未投稿キューのURLを一括除去してプロフィール欄リンクに集約し、送信前にURLを検知して止めるfail-closedガードと生成プロンプト修正まで一式
PWA デプロイ即反映 — Service Worker 自動 reload レシピ
PWA のスマホ側で新版が反映されない問題を、SW の VERSION+postMessage+updateViaCache=none+版タグ表示 の3点セットで「デプロイ即・全tab自動 reload」に変える完全レシピ。Next.js/Vite/Vanilla 共通
連携が「権限不足」に見えて実は「身元違い」のとき — 両側のアカウントを先に実測する
デプロイサービスとGitホスティングの連携が繋がらない時、資源側の権限をいじり続けて往復を溶かす失敗を止める。要求側が外部で名乗る名前と資源の所有者を実測で突き合わせる手順、詰まった時に目的へ戻る代替、環境変数のスナップショット順序など併発する罠まで。
Windows で無人 LLM CLI に長いプロンプトを渡すと spawn ENAMETOOLONG で即死する — stdin 渡しへの根治と単発故障を1件で検知するヘルス判定
Windows の argv 上限で子CLIへの長いプロンプトがspawn即死。stdin渡しへの修正とテスト、単発故障を1件で検知する監視の閾値修正
到着日で絞る予約APIが滞在中ゲストを落とす — 空室・閉室の誤判定を防ぐ遡り取得
PMSの予約一覧APIを期間の開始日から引くと期間前に着いた滞在中ゲストが消え、在室中の部屋を開け忘れと誤判定してダブルブッキングに進む。最長滞在ぶん遡って取り泊単位で照合する実装と、人に聞く前の確認手順。
AEO/GEO 施策の型 — AI検索で自社を推薦・引用されやすくする
ChatGPT/Perplexity/AI Overviewで自社が引用される状態を作る実行手順。JSON-LD/llms.txt/robotsのオンページ、比較メディア掲載、投稿メディア→Yahoo!ニュース→取材誘発、Wikidata/Wikipedia、月次無料の効果測定、落とし穴まで。
スプレッドシート集計業務をNext.js+Supabaseアプリへ段階移行する設計指示書
運用中のSheets業務を止めずにWebアプリ(DB正)へ段階移行。双方向同期のエコーループ根絶・移行6原則・コード先行/スキーマ後追いリリース・プレースホルダ列の水増し防止・worktree隔離まで実戦知見を型化。
営業スライド資料をHTML→16:9 PDFで量産＋写真整備パイプライン
HTMLでスライド設計→Playwrightで16:9 PDF化→実写真とAI画像を混在。ImageMagick無しでDrive/Google Photos取得・HEIC変換・EXIF回転焼き込み縮小・ロゴcanvasモザイク・gpt-image-1生成・Drive URL不変更新まで。固定px設計時の@page一致(フッター重なり)の罠も収録。
「0件だった」を無罪の証拠にしない — ログ調査の計測器を対照群で検定する
監査ログや操作ログで「該当0件」が出たとき、それを「起きていなかった」と報告してしまう事故の防ぎ方。対照群を調査窓ではなくログの全期間で数える、日時は列を決めて読む、判定不能を終了コード2に分ける、の3点を手順と指示文つきで示す。
GASの通知Botメンバーリストをスプレッドシート化する
Discord/Slack等への定期通知GASでハードコードされた宛先リストをスプレッドシート読込に置き換え、以後はコード編集不要にする。Drive全文検索がGAS編集直後は反映されない落とし穴も併記。
Google Sheets API 2大落とし穴（append列ズレ/QUERY ORDER BY silent fail）
フィルタ有効シートへのvalues.append()が列ズレする罠と、QUERY()のORDER BYが型混在列で全行silent失敗する罠、それぞれの回避策
「名前でフォルダを探して無ければ作る」処理が自分の重複を掴み続ける問題を潰す
自動化が保存したファイルが現場のフォルダに入らず「同じ名前のフォルダが2つある」状態になる。真因は探索の深さでも起点でもなく「ヒットで即return する順序」。候補を全部集めてスコアで選ぶ形へ直す手順と、再発を縛るテストの書き方をまとめた指示書。
払った額（カード明細）と使った額（実行ログ）を突合してAI費用の計上漏れを洗い出す
会計カード明細とCLI実行ログの2データ源を月次で機械突合し、計上漏れを経理が『登録待ちリスト』だけ確認すれば済む形にする手順。4状態判定・dry-run→read-back→本実行・人の記入列を書かない安全則つき