
CLAUDE.mdの書き方|AGENTS.mdに1本化して「強制はコードに逃がす」
CLAUDE.mdに何を書き、何を書かないべきかを実運用の構成で解説します。CLAUDE.mdを1行にしてAGENTS.mdへ1本化する理由、複数エージェントで指示書のドリフトを止める設計、守らせたいルールをhooksへ逃がす使い分けまでを記録します。
16 Articles

CLAUDE.mdに何を書き、何を書かないべきかを実運用の構成で解説します。CLAUDE.mdを1行にしてAGENTS.mdへ1本化する理由、複数エージェントで指示書のドリフトを止める設計、守らせたいルールをhooksへ逃がす使い分けまでを記録します。

AIエージェントにSNS投稿を任せると、怖いのは投稿しないことではなく二重に投稿することです。行ロックが使えないNotionの投稿キューで、status遷移と「claim→直後再読」の楽観的排他、15分staleルール、あえて自動リトライしない設計をどう組んだか、実運用中の構成をそのまま解説します。

Claude Codeのhooksで、エージェントに破らせたくない操作をコードとして強制する実装記録。PreToolUseフックの設定、Bashコマンドを検査するガードスクリプト、exit code 2でブロックする仕組み、正規表現ルールの設計と限界まで、実運用中の構成をそのまま解説します。

Geminiの画像生成機能を初心者向けに解説。無料版でできること・制限、3ステップの使い方、プロンプトのコツ、有料版との違いまで、2025年最新情報をもとにわかりやすく紹介します。



Claude Codeのサブエージェントで、公開前レビューを執筆エージェントから分離した実装記録。読み取り専用のcritic定義、判定基準のファイル固定、PASS/FAILの機械判定、修正2回上限と隔離まで、実際に運用している構成を解説します。


Codexなど CLIエージェント主体の開発でZedとVS Codeを本気で比較した記録。ZedのACP統合とサブスク対応の非対称を調べた末に、エディタの役割が「たまにコードを読むビューア」へ縮む過程と、差分レビューをPRに寄せるとエディタ選定が「好みの問題」になる判断フレームをまとめます。

AIエージェントに投稿ツールを渡すと放っておくと公開し過ぎます。その制限をプロンプトではなく自作MCPサーバー側(Cloudflare WorkersのKV)に置いた実装記録。単純なカウントではなくreserve→commit/releaseの二段階にした理由と、失敗時に枠を戻す設計まで解説します。


ChatGPT無料版と有料版(Plus)の違いを7項目で徹底比較。料金・制限・画像生成・ファイル分析・カスタムGPTまで、課金すべき人の判断基準とROIを解説します。