AGENTS.mdの書き方 — Codexに会社のルールを教える「社内憲法」の作り方と育て方

AGENTS.mdとは — Codexが毎回読む「ルールブック」

AGENTS.mdは、作業フォルダ（プロジェクト）に置くテキストファイルです。ここに書いた内容を、Codexはそのフォルダで仕事をするたびに必ず読み込み、ルールとして守ろうとします。「毎回の依頼文で説明していたこと」がファイル側に移るため、依頼はどんどん短く、成果物のブレはどんどん小さくなります。

当社はこれを「新人が古参社員に変わり始める分岐点」と呼んでいます。何も知らない新人（初期状態のCodex）に毎回口頭で指示するのをやめ、就業規則とマニュアルを渡す——AGENTS.mdを置くことは、それと同じ意味を持ちます。

置き場所 — 作業フォルダの直下に1枚から

基本は、Codexにプロジェクトとして選択している作業フォルダの直下に `AGENTS.md` という名前で1枚置くだけです。大きなプロジェクトでは、サブフォルダごとにAGENTS.mdを入れ子（ネスト）にして、「そのフォルダで作業するときだけ読む詳細ルール」を分けることもできます。全体共通のルールは直下の1枚に、特定業務の詳細は該当フォルダに——という構成にすると、後述する「肥大化」も防げます。

何を書くか — 最初は3項目で十分

最初から立派なルールブックを作る必要はありません。当社が研修でおすすめしている初期構成は、次の3項目だけです。

1. 1会社・仕事の前提 — 何をしている会社／チームか、誰に向けた成果物か
2. 2成果物のトーンと形式 — 文体（です・ます調など）、分量の目安、ファイル名や保存場所のルール
3. 3やってはいけないこと — 使ってはいけない表現、触ってはいけないファイル、確認なしで送信・公開しない、など

書き方のイメージとして、非エンジニアの業務フォルダに置く最小構成の例を挙げます。

# AGENTS.md

## この作業フォルダについて
- 株式会社◯◯の営業企画チームの作業フォルダ
- 成果物の読み手は社内の経営会議メンバー

## 成果物のルール
- 文体は「です・ます調」、A4で1〜2枚に収める
- 数字は必ず元資料の値を使い、推測で補完しない
- ファイル名は「YYMMDD_内容.md」の形式で保存する

## やってはいけないこと
- 顧客名を成果物に書かない（社名はイニシャル表記）
- 完成前のファイルをフォルダ外にコピーしない

重要なのは、これが依頼文から「毎回同じ説明」を消すためのファイルだという目的意識です。1回しか使わない指示は依頼文に、毎回守らせたいことだけをAGENTS.mdに——この線引きさえ守れば、書く内容は自然に決まっていきます。

育て方 — 「同じ指摘を2回したら1行追記」

AGENTS.mdは最初に完成させるものではなく、運用しながら育てるものです。当社のルールはシンプルで、「Codexの成果物に同じ指摘を2回したら、その場でAGENTS.mdに1行追記する」。これだけです。

たとえば「また文末が体言止めになっている」と2回直させたら、「文末は体言止めにしない」と1行足す。この積み重ねが数週間で効いてきて、レビューでの指摘がみるみる減っていきます。ルールファイルの価値は初期の完成度ではなく、運用の中で実際の失敗から学ばせた蓄積で決まります。

肥大化させない — 精度と料金の両方に効く

育てる一方で、増やしすぎには注意が必要です。AGENTS.mdはCodexが毎回読み込むため、長くなるほど毎回の利用枠の消費が増え（公式ドキュメントも節約術として「AGENTS.mdを小さく保つ・ネストで分割する」ことを挙げています）、また指示が多すぎると重要なルールが埋もれて守られにくくなります。

• 定期的に棚卸しする — もう起きていない失敗のルールは削る・統合する
• 詳細はネストに逃がす — 特定業務だけのルールはサブフォルダのAGENTS.mdへ
• 「ルール」と「手順」を分ける — 毎回守る原則はAGENTS.md、特定業務の手順はSkillsに登録する（役割分担はCodexの応用機能まとめを参照）

組織で書く場合 — AGENTS.mdは「合意形成の成果物」

個人の作業フォルダなら自分の好みで書けばよい一方、チームの共有フォルダに置くAGENTS.mdは「会社として成果物に何を求めるか」の合意そのものです。トーン・禁止事項・確認フローを言語化する過程は、実はAI導入以前に曖昧だった業務基準を明文化する機会でもあります。当社のCodex研修・導入伴走支援では、貴社の実業務を題材にAGENTS.mdの初版を一緒に作り、育てる運用ルールまで含めて伴走しています。