巻物を探す
17件の巻物
無人実行ジョブが「働いたのに何も残らない」を潰す設計
cron/タスクスケジューラからAIエージェントや長時間処理を無人で走らせる際の2大事故（タイムアウトkillで出力が丸ごと消える／実行されるコードがその瞬間のHEADで決まる）を構造的に潰す実装指示書。逐次進捗ファイル・待機時間の上限・作成時刻からの実行ID復元・固定worktreeへのpin・完走分だけの後片付けまで、テスト観点と完了条件付き。
Windows の .cmd に日本語コメントを書くと REM 断片が命令として実行される（ASCII only で防ぐ・判定はコンソール行数）
タスクスケジューラ用の .cmd/.bat に日本語 REM があると cmd.exe が行の断片を命令として実行する。chcp を先頭に移しても直らない。ASCII only にし、非 ASCII 数とコンソール出力行数の2判定で機械確認する手順とテンプレート。
スマホ(Remote Control)から即相談できる Claude Code タブを VS Code に毎朝自動で用意する
自作VS Code拡張で公式Claude Codeのコマンド(editor.openLast/newConversation/renameSessionTab)を叩き、名前付きタブをN本自動補充。夜間はWM_CLOSE→再起動で毎朝揃える。--bg/ターミナル経路・タブ0でのnewConversation・SendKeys再読み込みが失敗する実測付き
別アカウントの Claude Code 同士を人の転記なしで直接やりとりさせる（共有メールボックス方式）
組み込みSendMessage/Remote Controlは同一アカウント限定。既存のトークン付きWeb App＋シートをメールボックスにして任意PC間を双方向・2分配達、promptは承諾制で読み取り専用headless実行
配布した自動化が「自分を更新できない」問題の根治と人手ゼロ復旧の3層設計
複数端末へ配ったhook/常駐スクリプトが無言で古いまま止まる原因(凍結コピー・実行シェル差)と、中央キュー/自己修復手順/生存digestの3層で人の操作ゼロで復旧させる設計。実測で踏んだ「緑なのに何も起きない」罠つき。
無人エージェントの夜間作業をKPI化する（「完走しました」を成果の証明にしない）
夜間の無人セッションが「N/N完走・失敗0」でも実は過半が空回り、という状態を数字で暴く指標設計。消化率・空回り率・コスト削減効果の3本と、空回り分を削減効果から差し引く理由、実測で機能しなかった指標を棄却した記録つき。
無人バッチの「黙った空振り」を発見して止める（冪等取込の設計）
定期バッチがエラーを出さないまま毎回同じ仕事をやり直している状態の検出法・典型的な真因（取込済み集合を実体の単一カラムで持つ）・台帳による修正・打ち切り付き再試行・CI課金での効果実測まで。
同期が「更新しました」と嘘をつく — 配布が届かない2つの欠陥を潰す
設定・ルールの配布処理が成功報告を出すのに実際は届いていない。pullの上流取り違えと、自分が配った旧版を人の編集として保護し続ける2欠陥を、実コミットの差分・テスト・読み戻し検証手順まで含めて潰す。
翌朝のバッチ結果で判定するゲートを朝を待たずに閉じる
夜間バッチの変更を明朝のレポートで確認する宿題を、--dry と出力先差し替えで当日中に判定する型。出力先を入力として読む前日比の処理が黙って壊れる罠と、grep exit 2 を0件と誤読しない判定手順つき。
並行AIセッションが共有リポジトリで事故らない型
複数のAIエージェントが同じ作業ツリーを共有する時の事故防止と、配布物を「配布可」と言う前の3層検証（コード・登録・配布）を手順化したMD
WSL が「ディストリが無い」ように見える時、疑うのは導入状態ではなく滞留プロセス
wsl --status は即答するのに wsl -e が無限ハングする非対称が誤診を生む。真因は滞留した wsl.exe クライアント。切り分け・復旧・時間制限付き呼び出し・PATH interop の罠まで。
Discord webhook の死活監視と自動修復
削除された webhook で通知が無言停止するのを防ぐ。生存中にチャンネル台帳を作り、死んだら同一チャンネルの生存 webhook へ自動で差し替える設計と実装要件
常駐ジョブを作業ツリーの HEAD に依存させない（固定 worktree ＋ 出力先分離）
毎朝走るジョブが Cannot find module で落ちるのは、実行場所が人や別セッションの作業ツリーで、HEAD が動くから。ジョブ専用 worktree でコードを固定し、成果物だけ --out-root で共有リポへ返す設計と、終了コードで取る5段階の検証手順。
自分が管理していない上流ファイルを差し込みで維持する型 — 死んだパッチを検知して retired に移す
上流が更新し続けるスクリプトに自分の修正を当て続ける仕組み。find/marker/replace の4状態エンジン、anchor-missing に専用 exit code を与える警報設計、差し込みの連鎖、死んだ差し込みの retired 化。テストが足りない値を注入していて壊れたコードが緑だった実害と、その塞ぎ方まで。
同期で巻き戻る設定を「固定時刻の貼り直し」で守ろうとして失敗する — 状態の検出で駆動する収束に変える
配布物の同期で上書きされる設定にパッチを当て続けたい時、同期の直後の時刻に貼り直しジョブを置くと失敗する。上書き側がN時間ガードで発火するため壁時計時刻が毎日漂うから。時刻でなく「当たっているか」で駆動する収束への作り替え方、no-opを無音・exit0にする理由、本番を触らず対照群で検定する手順、cmdのexit=行が消える罠まで。
「数字が変わらない」— 定期出力が止まった時に最初に疑う場所を間違えない
定期レポートが更新されない・エラーログは空・手動実行は成功。この組み合わせは「起動していない」のサイン。診断順序（トリガー登録→手動実行→実装）と、二度と沈黙させない実装パターン（キャッシュ鮮度警告・stderr保存・finally解放）
委譲した実装を「本番で起動される環境」で受け入れ検証する
AIに実装を委譲するとテストは緑で返るが、それは委譲先の環境での緑でしかない。WSLとネイティブなど実行環境が2つあると片方でだけ通るコードが生まれ、本番へ配線した日から静かに失敗する。本番の起動経路で受け入れ検証する型と、環境差で死ぬ定番3つ、破壊的ツールの追加ゲート4つ。