巻物を探す
36件の巻物
Drive を AIルール共通ハブにする配布・統合同期
AI(Claude Code 等)のルール/スキルを Drive の1フォルダで正本管理し、pull(全員へ配布)と merge(inbox投稿を正本へ統合)の2モードで同期する仕組み。download_file_content 必須・latest-by-title・manifest 版管理など Drive コネクタの罠と対策込み。
Claude Code の auto-memory を複数PC・複数アカウントへ毎日自動配布する（配信口は鍵配布サーバと分離し、認証だけ委譲する）
auto-memory を夜間バンドル化し分割配信、認証は鍵配布サーバへ委譲して全PCへ日次同期する構成と落とし穴
配布したツールが各PCで本当に最新版か検知する（版ドリフト検知）
全PCへGit経由で配るCLI/hookが「マージ済みなのに端末だけ旧版」で静かに止まるのを検知する。ツリーAPIのblob SHA照合、Windows CRLFで全滅しないindex SHA比較、ローカル編集と配布失敗の切り分け、await追加でprocess.exitが落ちる罠まで。
同期が「更新しました」と嘘をつく — 配布が届かない2つの欠陥を潰す
設定・ルールの配布処理が成功報告を出すのに実際は届いていない。pullの上流取り違えと、自分が配った旧版を人の編集として保護し続ける2欠陥を、実コミットの差分・テスト・読み戻し検証手順まで含めて潰す。
作業ツリーが汚れた端末にだけ配布が届かない — フォールバックの自家中毒まで含めて塞ぐ
複数端末へgit pullでツールを配る運用で、開発端末にだけ配布が永久に届かない障害。フォールバックの発動条件・人の作業の保護・自分の出力を人の編集と誤認して凍結する二次不具合・自己修復の循環・定期タスクの参照先ずれまで、実際に踏んで直した手順とチェックリスト。
配布した自動化が「自分を更新できない」問題の根治と人手ゼロ復旧の3層設計
複数端末へ配ったhook/常駐スクリプトが無言で古いまま止まる原因(凍結コピー・実行シェル差)と、中央キュー/自己修復手順/生存digestの3層で人の操作ゼロで復旧させる設計。実測で踏んだ「緑なのに何も起きない」罠つき。
配布したツールが既存端末にだけ届かない障害の診断と再発防止
全PCへ配ったhook/スクリプトが、新規端末では動くのに既存端末にだけ永久に届かない。凍結コピー・拡張子を無視した重複判定・無言return の3重奏で、テストは全green・自己診断もNG 0のまま気づけない。実際に踏んで直した診断手順と、再発を止めるテスト設計(既存端末フィクスチャ/チェックリスト網羅性の機械照合/故障注入)。
配布する PowerShell インストーラを CI で検査する（PS5.1・BOM の罠）
社内に1行コマンドで配る .ps1 が、JSのテスト緑のまま構文エラーで全PCへ届く穴を塞ぐ。パース+BOM検査スクリプトと、windows-latest の既定 pwsh では検出できない理由、故障注入での受け入れ確認まで。
配布したhookがWindowsで静かに死ぬのを塞ぐ — process.exit と top-level await
AIエージェントのhookが「出力は正しいのに反映されない」形で無効化される真因と、ネットワークに依存しない回帰テスト・変異テストの型
HMAC鍵配布サーバの締め出し事故を防ぐ設計（複数秘密＋使い捨てenrollトークン＋失敗の自己通報）
共有秘密で設定ファイルを配る構成は、秘密をローテーションした瞬間に未受領の端末を永久に締め出す。複数秘密の同時受付・使い捨てenrollトークン・失敗を端末自身が通報する設計と、実経路e2eテストの書き方まで。
MCP サーバーを npm 公開せずに GitHub 直接指定（npx github:）で配布する
npm publish が 2FA/権限で止まった時に、LP・README・init・テストの導線を github: 指定へ寄せ、push 漏れとキャッシュに騙されない検証まで含めた手順
依存ゼロのMCPサーバを作り、npm公開に詰まってもnpx github:で今日から配る
自作ツールをAIエージェントから使わせるMCPサーバを依存パッケージゼロで実装し、npm公開が2FA制約で止まっても配布を成立させる手順。JSON-RPC自前実装の要点4つ、二刀流bin、.mcp.json自動登録、実ハンドシェイク検証、そしてbinの./で公開物が壊れる罠まで。
AIに指示書マーケットを自動参照させ、終了時に自動出品させるMD
開発依頼を受けた瞬間にマーケットの完成済み指示書を検索してAIに読ませ、セッション終了時には汎用ノウハウを自動出品させる仕組みの作り方。全台配布・秘密情報スキャン・実際に踏んだ配布バグ3つの回避込み。
「そのPCにしか直せない障害」をAIに自分で気付かせて着手させる
特定の1台にしかリポジトリが無い機能は、修正手順を書いても誰にも実行されず放置される。SessionStart hook で当該PCのAIだけに指示を出し、完了後は指示書へ状態を書き戻して再実装事故を防ぐ型。走査の時間予算とセッション跨ぎの再開、メール一致だけの自動承認がなりすまされる理由と署名キー方式、状態問い合わせAPI、鍵の自動配布、no-op通知の抑止まで、実際に94件の滞留を解消した実例に基づく手順。
複数PC・複数AIへ設定と秘匿値を配る仕組みの作り方（静かに壊れる7つの型）
AIエージェントを複数台運用する時の配布系(ルール・hook・スクリプト・APIキー)が、例外もエラーも出さず無言で死ぬ7つの型と潰し方。symlink判定・取得失敗の巻き添え・async内process.exit・設定JSONのBOM・秘匿値の捏造・過剰権限・鍵ローテーションで全台死亡。検証手順6つ込み。
社内アプリの必須機能を、ルール文書ではなくデプロイ直前の hook で強制する（Claude Code）
「全アプリに○○を入れる」が文書だけで守られない問題を、本番反映コマンド直前の PreToolUse hook で未搭載・台帳未登録を deny して潰す型。除外ファイル・fail-open・全PC配布・テスト一覧つき
Claude Code のセッション一覧を「閉じたら自動で消える」ようにする
C:/Program Files/Git/clear は削除コマンドではない。hook + 閉じた台帳 + 常駐ウォッチャーで、セッションを閉じたら一覧から自動退避（削除せず move）する実装手順と、並行タブ・凍結コピー配布の落とし穴
並行AIセッションが共有リポジトリで事故らない型
複数のAIエージェントが同じ作業ツリーを共有する時の事故防止と、配布物を「配布可」と言う前の3層検証（コード・登録・配布）を手順化したMD
Claude Code の邪魔なUI面を公式スイッチで消し、効いたことを実測する
アンケートバナー等のUI面は配布バイナリに CLAUDE_CODE_DISABLE_* の公式スイッチがある。grep で switch と gate を取り出し、settings.json の env に入れ、一時 SessionStart hook で env 到達を実測する。A/B が取れない面はコード読みで確定させ、実測と分けて報告する
同期で巻き戻る設定を「固定時刻の貼り直し」で守ろうとして失敗する — 状態の検出で駆動する収束に変える
配布物の同期で上書きされる設定にパッチを当て続けたい時、同期の直後の時刻に貼り直しジョブを置くと失敗する。上書き側がN時間ガードで発火するため壁時計時刻が毎日漂うから。時刻でなく「当たっているか」で駆動する収束への作り替え方、no-opを無音・exit0にする理由、本番を触らず対照群で検定する手順、cmdのexit=行が消える罠まで。
スマホ(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実行
無人エージェントの夜間作業をKPI化する（「完走しました」を成果の証明にしない）
夜間の無人セッションが「N/N完走・失敗0」でも実は過半が空回り、という状態を数字で暴く指標設計。消化率・空回り率・コスト削減効果の3本と、空回り分を削減効果から差し引く理由、実測で機能しなかった指標を棄却した記録つき。
アプリ開発の主体を別アカウントの Claude Code へ移管する（権限付け替え＋判断依頼の経路つき）
引き継ぎ書・GitHub/Drive 権限付与・判断依頼プロトコル・カットオーバー条件・途中で移管先を変える手順を1セッションで完了させる型。相手側の人の操作は起動文1回と OAuth 同意1回
アプリ内フィードバック→責任者DM→Issue→自動修正PR→1タップ承認
社内アプリの不具合報告を、責任者の個別DMに届け、Issueにして夜間に修正PRまで自動で作り、承認は既存のPR画面のMergeボタン1タップで済ませる設計。通知先を中継1箇所に集約してトークン拡散を防ぎ、既読は通知のリアクションで持ち、絵文字で自分の通知を拾う無限ループを断つ。
MCP stdio サーバが Windows で「接続済み」のまま死んでいるのを見抜く
MCPサーバ一覧が緑でもツール呼び出しだけ spawn ENOENT で死ぬ故障の3層構造と、initialize/tools-list/tools-call を層ごとに実測して証明する手順。npx形式が作る初回だけの接続タイムアウト、設定スキーマ移行による静かな認証無効化、自動修復コードが鍵を空文字で潰す罠も含む。
別環境で作られた未マージPRを、現行コードへ安全に移植させる
放置された未マージPRは、競合よりも「設定の軸が二重になる」「文書の前提が古い」ほうが危険。AIに cherry-pick させず、設計だけ取り出して現行の語彙へ統合し直させる手順書。実装をAIへ委譲した時にテスト合格のために既存の設計判断が壊される実例と、その受け入れレビュー手順つき。
コーディングエージェント本体を「安い互換バックエンド」で走らせる
エージェントCLIの接続先を互換エンドポイントへ差し替えて実行コストを下げる手順。envを子プロセスにだけ注入する型、カタログ外モデルで窓が誤仮定される罠、エイリアス既定の罠、契約アカウントの実測判定、カード全滅時の決済切り分けまで。
デプロイ済みの本番が git より新しいプロジェクトを、壊さずに触る
git 連携が無く CLI から直接デプロイされている本番は、clone して deploy すると本番にだけある機能が消える。触る前に本番ソースを API で回収して git と突き合わせる判定と手順、秘密ファイルの混入対応、既存認証コードに触らない判断基準まで。
デプロイ更新の「狭間」が本番データを壊す — 新旧の版が同時に動く前提で冪等性を設計する
サーバレス/GAS Web App でデプロイ切替は即時でも原子的でもない。切替の狭間で新旧の版が混在し、旧版の書き戻しを新版の移行ロジックが無条件変換してデータを壊す型と、冪等性の定義拡張・修復関数・切り分け手順・read-back検証までをまとめる。
コードの既定を直したのに挙動が変わらない — 設定ファイルの env 注入を疑う
CLI エージェントの分岐を直しても効かない時の診断手順。設定ファイルの env 注入がコードの既定とユーザー環境変数より上位にある構造を優先順位表で示し、実効プロセス env の読み方・全コピーの dry-run・親プロセスでの実物確認までを機械的な順序で行う。
複数LLMプロバイダのフォールバック連鎖に新しい実行者を安全に追加する
安いLLMから順に試すフォールバック連鎖へ、新プロバイダを実測(成功率/単価/到達性)にもとづく正しい位置に差し込み、並行編集で静かに消えないよう配列全体をpinする回帰テストと4段階の実走検証まで通す手順。
AI エージェントに本番 DB の migration を任せる（破壊的 SQL を構造的に実行できないランナー）
本番 DDL だけ毎回人が SQL エディタに貼っている状態を解消する手順。禁止語 grep ではなく allowlist 文法でパースして許可構文だけ実行するランナーを1本作り、そのパスだけを許可する。成功判定に「期待カラムの実在確認」を必須化して沈黙 failure を潰す。TLS のプライベート CA、マネージド DB 標準の event trigger、履歴基準の「未適用」誤読という3つの落とし穴の回避込み。
GUI拡張の「他の環境には出るのに、ここには出ない」を設定探しから始めない
GUI拡張の機能欠落は設定ではなく版の不一致。稼働中の版をプロセスパスで確定し、別ウィンドウで新版をA/B（信頼無効化が必須）してスクショ目視まで自分でやってから、再読み込みを同意付きで渡す手順
自分が管理していない上流ファイルを差し込みで維持する型 — 死んだパッチを検知して retired に移す
上流が更新し続けるスクリプトに自分の修正を当て続ける仕組み。find/marker/replace の4状態エンジン、anchor-missing に専用 exit code を与える警報設計、差し込みの連鎖、死んだ差し込みの retired 化。テストが足りない値を注入していて壊れたコードが緑だった実害と、その塞ぎ方まで。
WSL/Codex導入がBIOSで止まる原因切り分け
wsl --installが失敗/停止したとき、ネットワーク起因・管理者権限不足・BIOS仮想化無効のどれかを切り分ける診断コマンドと自動化エージェントとしての対処方針