指示の二重修正を減らす：AGENTS.mdを残し、CLAUDE.mdを整理する
AI開発者の手帖
この記事は「AI開発者の手帖」がnoteで販売している同名記事と同じ内容です。すでに購入・閲覧できる方は重複購入にご注意ください。
AGENTS.mdとCLAUDE.mdは、AIのコーディング支援ツールへプロジェクトの進め方を伝える指示ファイルです。今回のきっかけは、Claude Codeの公式文書にAGENTS.mdを直接読み込む機能が案内されたこと。従来から使えるCLAUDE.md経由の参照も残せます。直接読み込みには環境や配置の条件があり、すべての利用者が設定を変える話ではありません。公式の読み込み条件
以前から、共通のAGENTS.mdをClaudeへ渡す方法として、CLAUDE.mdから参照する構成が使えます。今回の直接読み込みは、対応条件を満たす構成なら、その参照用ファイルを置かずに指示を渡せる選択肢です。「共通の指示はあるのに、別途読み込ませる構成を用意する」という手間に関係します。公式の既存構成の扱い
ただし、新機能が二つのファイルの食い違いを自動で直すわけではありません。テスト手順を二か所に書いて一方だけ更新する問題には、共通本文を一つにする整理が必要です。これは従来の参照方式でも行えます。本稿で目指すのは、その整理によって同じ指示を二度直す必要を減らすことです。所要時間やミスの削減量を実測した主張ではありません。
目標は、ファイル名の統一ではなく、共通の指示を一か所で直せる状態です。
結論から言うと、共通の本文を一つにするために、CLAUDE.mdまで消す必要はありません。 Claude Codeの公式文書には、CLAUDE.mdからAGENTS.mdを参照する構成が案内されています。すでにその構成なら、対応発表だけを理由に変更する必要はありません。公式の共有方法
この記事は、手元の指示の二重修正を減らしたい人向けです。AGENTS.mdの全文をClaudeとも共有でき、残す指示と矛盾しない構成を対象にします。以下は公式文書に基づく手順案と架空の編集例で、CLIの実測報告ではありません。組織管理の設定や、チーム全体の一括移行は対象外です。
たとえば二つのファイルに同じ「変更した範囲のテストを実施する」があるなら、その文章を共通側へ寄せる候補にできます。一方、二つのテストコマンドが違うなら、まだ同じ指示とは言えません。この違いを見分けることが最初の判断です。
有料部分では、現状別の選び方、共通化する一文を決めた後の変更例、確認できなかったときの戻し方を示します。ファイルを消す判断を急がず、まず一つの指示だけを整理するための手順です。
この記事のライター
