CodexやClaude Codeでファイルを扱い始めると、「入力は上書きしない」「単位が不明なら確認する」など、同じ条件を何度も伝える場面があります。繰り返し使う条件を作業フォルダに残す仕組みが、AGENTS.mdやCLAUDE.mdなどの指示ファイルです。
まず書くのは、その作業場所で繰り返し守ってほしい条件です。「今日届いたA.csvを確認する」のように毎回変わる対象は、今回の依頼に書きます。指示ファイルを作っても、モデルを再学習させたことや、操作を技術的に禁止できたことにはなりません。
この記事では、架空CSVを使う練習フォルダのルールを作ります。実際の社内データや設備への接続は扱いません。一回の依頼文から整理したい場合は、生成AIへの依頼文の書き方から確認できます。
一回の依頼と、残すルールを分ける
最初から社内の全規定を書き写すと、どの作業に適用する条件なのか分かりにくくなります。繰り返している一つの作業に絞り、条件の置き先を決めます。
| 条件の例 | 置き先 | 理由 |
|---|---|---|
| input内の原本を編集しない | 指示ファイル | この練習フォルダの共通条件 |
| 今回はsample-a.csvを確認する | 今回の依頼 | 対象が毎回変わる |
| 単位は各ファイルの仕様書で確認する | 指示ファイル | 確認方法を共通化する |
| 今回の値はmmで記録した | 対象データの仕様 | 別のデータへ無条件に引き継がない |
| 合否の判定基準は未決定 | 今回の依頼・仕様 | AIに基準値を作らせない |
「常にmmとして計算する」と書くのではなく、「対象の仕様で単位を確認し、書かれていなければ質問する」と書けば、別形式のデータを扱う際にも確認が残ります。ただし、mm専用と決まった処理なら、その適用範囲を明記して固定して構いません。
使う製品に合う場所へ置く
CodexはAGENTS.mdなどを読み、作業場所に応じた指示を組み合わせます。プロジェクトではルートから現在の作業ディレクトリへたどり、各階層でAGENTS.override.md、AGENTS.md、設定された代替名の順に探します。下位の指示が後から加わるため、最初はルートの一ファイルで試すと確認箇所を絞れます。CodexのAGENTS.md公式資料
Claude CodeではCLAUDE.mdを使えます。現在の公式資料は、v2.1.277以降のAGENTS.md読込みも説明しています。ただし、CLAUDE.mdなどの併存条件によって既定の動作が変わり、CodexのAGENTS.override.mdと同じ扱いにはなりません。両製品で共通ファイルを参照したい場合には、CLAUDE.mdからAGENTS.mdを取り込む方法もあります。Claude Codeのメモリー公式資料
練習では、次のどちらか一方から始めます。
practice/
AGENTS.md Codexで試す場合
input/ 架空の入力
output/ 練習結果
specs/ 入力ごとの列・単位の説明
Claude Codeで試す場合は、この例のAGENTS.mdをCLAUDE.mdに置き換えます。共有したくなった段階で公式資料の読込み条件を確かめ、内容の違う二つのルールを放置しないようにします。
なお、普段のChatGPTやClaudeの会話欄に同名ファイルを添付するだけで、ここで説明するフォルダの読込み規則が働くとは限りません。
最初の指示ファイルは「対象・変更範囲・確認方法」で書く
次は練習用の例です。会社の実運用規則を代わりに決めるものではありません。
# CSV確認の練習
## 対象
このフォルダでは、架空のCSVの入力条件を確認する。
製品の良否や工程能力は判定しない。
## 変更範囲
input内の原本は変更しない。
結果はoutputへ新規作成し、同名ファイルがあれば確認する。
## 確認方法
処理前に対象CSVと対応するspecsの仕様を示す。
列名、単位、空欄の意味を確認し、不明な点を推測しない。
元の行IDを報告に残し、入力と指摘を照合できるようにする。
実行した検査と、未実行の検査を分けて報告する。
「丁寧に処理する」だけでは、どこを見れば守られたと判断できるのか曖昧です。原本の差分、出力先、仕様への参照、行IDなど、後で確かめられる条件にします。
ファイルへ「原本を変更しない」と書くことと、OSや製品で書込み権限を制限することは別です。権限や外部通信の設定は利用環境に合わせて確認します。操作を任せる範囲は、チャットAIとコーディングエージェントの違いで整理しています。
読まれたかと、守られたかを別々に確かめる
ファイルを保存したら、利用する製品・版・作業フォルダを控えます。読込みのタイミングは製品によって異なるため、練習では新しいセッションで始めると、変更前の指示が残る条件を減らせます。
最初は次のように依頼します。
まだファイルを編集せず、この作業に適用する指示ファイルのパスと、原本・出力先・不明点の扱いを示してください。確認できない指示は、読んだことにしないでください。
AIの回答だけでは、指示が正しく読み込まれたかは確定できません。利用できる読込み表示や実行記録を確認し、その後の出力でも条件を照合します。例えば、仕様書に単位が書かれていない架空CSVを渡し、「数値を集計して」と依頼してみます。
| 試す条件 | この練習で確認する振る舞い |
|---|---|
| 仕様に単位がない | 集計結果を確定せず、単位について質問する |
| outputに同名ファイルがある | 無断で上書きしない |
| 入力の一行に疑義がある | 元の行IDを付けて報告する |
| 別のCSVを渡す | 前回の単位や合否基準を勝手に持ち込まない |
これは期待する振る舞いの表であり、両製品で全項目が実行できたという報告ではありません。練習後に原本も比較し、変更があれば作業を止めて原因を調べます。
ルールを増やす前に、失敗した条件を直す
AIが指示に従わなかった場合、まず正しい作業フォルダで始めたか、ファイル名と配置が合うか、上位や下位に競合する指示がないかを確認します。そのうえで、「単位は適切に扱う」のような曖昧な表現を、具体的な確認方法に直します。
改訂したら、変更理由と日付を残し、以前通った例と今回失敗した例の両方を試します。例えば空欄の扱いを変更したことで、数値0まで欠測扱いに変わっていないかも確認します。長い作業手順は別の手順書へ分け、指示ファイルには適用する条件と参照先を残す方法もあります。
AIを使わず、共通条件をチェックリストとして担当者が確認する運用も選べます。ルールをファイルにまとめる目的は、同じ注意を増やすことではなく、別の入力でも確認方法を再利用できる状態にすることです。
自分の業務で残す条件を整理したい場合は、XのS1N_seigitechへ困りごとの概要をDMでお知らせください。機密資料や個人情報は送らず、DMが使えない場合はお問い合わせページをご利用ください。
公式資料の確認日:2026年10月28日。例は架空の練習用で、各製品への設定・動作試験は未実施です。