モデルを切り替える前に、自分の呼び出しの形を候補モデルへ1トークンで再生する
モデルIDを書き換えて本番を回すと、400 は最初のリクエストで返ります。thinking の指定や tool_choice など自分の呼び出しの形を、max_tokens 16 の再生で先に確かめる小さな仕組みを書きました。
無人エージェントの挙動変更を、フィーチャーフラグで少しずつ試す設計
無人で走るエージェントのプロンプトや挙動を一度に全変更すると、劣化が朝まで見えません。フィーチャーフラグで一部の実行にだけ新挙動を割り当て、品質を見てから広げる設計と、決定論的バケット・自動ロールバック・監査証跡の実装を紹介します。
前の実行が終わらないうちに次が走り出すとき — リースとフェンシングトークンで定期エージェントの多重起動を抑える
毎朝の定期実行が前回の処理を追い越して二重に走り出す問題を、リースとフェンシングトークンで抑える設計を解説します。素朴なロックが破れる瞬間の分析から、任意ストア上の最小リース実装、副作用直前のトークン検証、上限付きキャッチアップまで、運用で固めた既定値とともに実装コード付きで整理しました。
自律エージェントの破壊的操作に事前条件・事後条件の契約ゲートを付ける
スキーマも型も通るのに中身が壊れている——自律エージェントのもっともらしい失敗を、事前条件・事後条件の契約ゲートで止める設計です。tryGuard・commitGuard・rollbackの構造、TypeScriptでの実装、スナップショットによる安全な巻き戻し、既存エージェントへの後付け手順まで紹介します。
Claude Code を午前と午後で別人格にする — 探索と実装を分けたワークフロー設計
同じClaude Codeを同じ設定で一日中使うと、どこかで思考の質が落ちます。午前は探索と批判に特化させ、午後は実装と完成に特化させる別人格運用を、それぞれのCLAUDE.mdの書き分けと、切り替えをコマンド一発にする工夫まで含めて個人開発の実例で紹介します。
Claude Code を「設計のスパーリング相手」に変える質問の作法
Claude Codeを単なるコード生成器ではなく、設計を一緒に考えるスパーリング相手として使うための質問の作法です。最初の3行で対話の質が決まる理由、比較できる選択肢を引き出す問いの形、同意されないことを前提にする姿勢、設計対話をCLAUDE.mdへ蓄積する習慣を共有します。