AGENTS.mdの書き方｜指示書に何を書くか

ChatGPTを使っている方には、カスタム指示やプロジェクトの説明が近い、と言うと早いです。真っさらな状態から毎回始めるのではなく、「このやり取りはこういう用途です」を先に決めておく仕組みですね。

AGENTS.md はその役割を、フォルダの中に置いた1枚のテキストファイルが担うものです。Codexはそのフォルダで作業を始めるとき、まずこのファイルを読みます。だから中身には「起動時に必ず読んでください」と書いておきます。これは人間向けではなく、AI本人に向けた一文です。

4行目が本質です。ここが、設定画面に文章を貯めていくやり方との決定的な差になります。詳しくは後半で書きます。

勉強会で実際に起きたことを、順番に書きます。初めて触る人がつまずくのは、たいていこの型です。

3つとも、指示書の中身とは無関係です。ファイルが、指定した場所に、実体として存在しているか。これだけで大半が解決します。「読んでくれない」と思ったときは、文章を直す前にこちらを疑ってください。

似た形で、ファイル名の取り違えもあります。AGENTS.md と CLAUDE.md は中身がほぼ同じでも、名前が違うと読みに行きません。Codexに CLAUDE.md だけを渡しても無視されます。両方を使うなら、同じフォルダに2つとも置いてください。

特別な記法は不要です。見出しと箇条書きのある、普通の日本語の文章で構いません。順番も自由ですが、次の5つが入っていれば動きます。

初めて作るときは、完璧を目指さないでください。5行でも動きます。使いながら「ここが毎回ずれるな」と気づいたぶんを足していくほうが、結果的に早く仕上がります。

それと、最初に必ず聞かれる質問が1つあります。「変更してはいけないフォルダはありますか」です。答えを用意しないまま進めると、想定していない場所を触られます。デスクトップが散らかっているなら、始める前に1か所へまとめておくだけでも効きます。

抽象論だけだと書きにくいので、筆者が実際に動かしているものの構成を出します。LinkedInの投稿を作るエージェント用の CLAUDE.md です。冒頭はこんな順番で並んでいます。

この先には、過去の投稿から抽出した文体・よく使う単語・改行の位置・論の運び方が書かれています。情報を受け取ってから結論を出すまでの思考の順番まで、言語化して置いてあります。だから、ネタを渡すと自分が書いたのに近い形で出てきます。

正直に書くと、この中身の大半は筆者が書いたものではありません。本人が自分で書いたものです。全部を把握してもいません。そして、それで困っていない、というのがこのやり方の要点です。

ここが、設定画面に文章を貯めるやり方との決定的な差です。指示書はAI本人が置いてあるフォルダの中にあり、本人がそれを開いて書き換えられます。

だから、次のような投げ方がそのまま通ります。

2行目が実務では一番効きます。出てきたものが自分の感覚とずれたとき、ずれたという事実をそのまま渡す。すると原因を探して、指示書の側を直します。人間が正解を言語化できていなくても進みます。

ただし、放っておくと散らかります。使い込むほどファイルとフォルダが増え、AIがあちこちを見に行くようになり、同じ情報が別の場所にできます。月に1回か2回、「いまの構成を整理してください」と頼むのを習慣にしてください。これも本人にやらせて構いません。

指示書を書き始めると、すぐに「どの単位で作るのか」という問題に当たります。答えはシンプルで、フォルダ1つがエージェント1体です。そして、どの階層で開くかによって、扱える話題が変わります。

SNSを例にします。

孫のフォルダで開けば、その範囲に集中します。親で開けば、またいだ判断ができます。視野の広さを、フォルダを開く位置で選んでいるという感覚です。

この構造も、自分で設計しなくて構いません。「こういう仕事をしていて、こう分けたい」と伝えれば、フォルダを作るところからやってくれます。最近はセカンドブレインという言い方をされますが、実態は、頭の中の分け方をそのまま画面の上に写しているだけです。

最初のうちは、どこに作っても構いません。自分の目に入る場所であれば十分です。問題になるのは増えてからなので、そのときに整理させてください。