第3章|仕事を進める環境を確かめる。
DAY 12 ・ 約15〜20分ルールファイルと作業環境
毎回の説明を減らし、同じ基準で安全に作業できる土台を整える。
AGENTS.mdとCLAUDE.mdの役割、適用範囲、設定や強制機構との違いを説明し、プロジェクト用ルールを設計できる。
言葉を知る
AGENTS.md
Codexへリポジトリの構成、作業方法、検証条件などを継続して伝えるMarkdownファイル。
CLAUDE.md
Claude Codeへプロジェクト、個人、組織の継続的な指示や背景を伝えるMarkdownファイル。
適用範囲
ルールがどのディレクトリ、ファイル、作業へ効くかという境界。
作業ディレクトリ
エージェントが現在の基準地点として扱い、相対パスやルール探索の起点になる場所。
強制機構
権限、フック、テスト、承認ゲートなど、文章のお願いとは独立して操作を制限・検査する仕組み。
ルールの競合
同じ状況に異なる指示が適用され、対応を決めにくくなること。
優先順位
複数の指示があるとき、どの指示を先に適用するかの順序。
仕組みを理解する
会話だけでは同じ作業品質を再現しにくい
チャットAIへ作業手順や編集禁止領域を一度伝えても、新しい作業へ自動的に残るとは限りません。長い会話では重要な条件が過去の出力へ埋もれ、別の担当者や別の端末では前提そのものが共有されないこともあります。AIエージェントがファイルを読み、コマンドを実行し、複数工程を進めるほど、毎回の口頭説明だけに頼る危険は大きくなります。 そこで、繰り返し使う作業規約をプロジェクトのファイルとして残します。たとえば、正式な作業場所、主要ディレクトリ、使用するパッケージ管理ツール、テストとビルドのコマンド、編集禁止領域、完了報告に必要な証拠を書きます。人向けREADMEが製品の使い方を説明するのに対し、ルールファイルはエージェントが仕事を始める時に必要な約束を短く示すものです。人とAIが同じリポジトリを扱うなら、共有可能な規約を版管理できることにも意味があります。 ただし、ルールファイルは過去の会話を全部保存する場所ではありません。一時的な依頼、今回だけの優先順位、未確定の推測は現在の指示や作業記録へ置きます。長期間変わりにくく、繰り返し参照され、作業の正しさを左右する内容だけを残します。依頼、継続ルール、設定、実行結果を分け、次回の失敗を防ぐ修正箇所を明確にします。
作業環境はモデル以外の条件でできている
AIエージェントの作業環境には、対象プロジェクトのルート、現在の作業ディレクトリ、Gitのブランチやworktree、利用できるコマンド、読み書きできる範囲、ネットワーク接続、外部サービスの権限が含まれます。同じ依頼でも、別のディレクトリで開始すれば異なる設定やルールを読み、相対パスは別の場所を指します。WindowsのパスをWSLやクラウド環境へそのまま渡せば、存在しない場所を編集しようとすることもあります。 リポジトリはソースコードと履歴の単位、ブランチは変更の系列、worktreeは同じ履歴から作る別の作業場所です。複数のエージェントや人が同時に作業する場合、同じファイルを同じ作業場所で編集すると衝突します。専用ブランチやworktreeを用意しても、最終的にどの差分を統合するかは人や親の工程が判断します。作業場所を分けることと、権限を分けることは別です。 開始時には、現在地、正式案件、変更対象、既存の未保存差分を確認します。復旧用コピーがあるなら「参考として読むだけ」「絶対に更新しない」と明記し、書き込み権限も外します。環境が違えば使えるコマンドも変わるため、OS、必要バージョン、準備手順、検証コマンドを具体的に書きます。「いつもの方法で」ではなく、実際に成功する命令と期待結果を示すことが再現性につながります。
CodexはAGENTS.mdを階層として読み込む
OpenAIの公式資料によると、Codexは作業開始時にAGENTS.md系のファイルを探索し、継続的な指示として読み込みます。全体へ使う個人ルールはCodexのホーム、共同プロジェクトの規約はリポジトリのルート、特定のサービスだけに必要な規約はその下のディレクトリへ置けます。プロジェクトルートから現在の作業ディレクトリまでを順に読み、より近い場所の指示が後から加わるため、同じ事項が競合した場合は近い範囲の指示が優先されます。 この仕組みは、大きなリポジトリで役立ちます。ルートには「秘密をコミットしない」「変更後は共通テストを実行する」、frontend配下には「表示変更後はスマホ幅も確認する」、payments配下には「専用テストを使い、鍵の変更は禁止する」と分けられます。すべてを一つの巨大なファイルへ詰めず、実際に適用する場所の近くへ置けば、無関係な作業へ規則が混ざりません。 一方、AGENTS.mdを追加しても、すでに開始している実行が必ず再読込するとは限りません。公式資料では、指示の探索は実行開始時に行われると説明されています。変更後は新しい実行を開始し、「読み込んだ指示元と有効な規則を要約して」と確認します。ファイル名、空ファイル、読み込み上限、開始ディレクトリも確認し、対象の実行に届いたことを確かめます。
Claude CodeではCLAUDE.mdが継続文脈になる
Anthropicの公式資料では、CLAUDE.mdはClaude Codeへ持続的な指示を渡すMarkdownファイルです。プロジェクトの構成、コーディング規約、よく使うコマンド、設計上の判断、レビュー用チェックリストなどを記述できます。プロジェクト、利用者、組織という範囲があり、ディレクトリ階層の中に置いたCLAUDE.mdは、その場所以下の作業へ具体的な指示を与えます。 重要なのは、CLAUDE.mdも「強制設定」ではなく会話へ読み込まれる文脈だという点です。Anthropicは、Claude CodeがCLAUDE.mdと自動記憶を会話開始時に読み込む一方、どちらも強制される設定ではないと説明しています。禁止操作を必ず止めたい場合は、権限やPreToolUseフックなど、モデルの判断から独立した仕組みを使います。文章へ「削除禁止」と書くことは必要でも、削除権限を与えたまま注意だけで守らせる設計は安全境界になりません。 AGENTS.mdとCLAUDE.mdは名前や探索方法が異なるため、両方の環境を使うプロジェクトでは内容の正本を決めます。同じ規則を二つへ手作業で複製すると、一方だけ更新されて矛盾しがちです。共通方針を短い共有文書に整理し、各製品用ファイルから参照する、または更新時に両方を検査する方法を決めます。製品固有のコマンドや読込範囲だけを各ファイルへ残すと保守しやすくなります。
ルール・設定・Skills・フックを使い分ける
ルールファイルへ向くのは、「このリポジトリでは何を正本とするか」「どのコマンドで検証するか」「どの場所を変更しないか」「完了時に何を報告するか」のような作業上の合意です。設定ファイルへ向くのは、使用モデル、サンドボックス、MCPサーバー、環境ごとの許可など、実行基盤が読み取る値です。秘密情報はどちらにも直接書かず、環境変数や秘密管理サービスへ置きます。 Skillsは、調査、制作、監査、公開のような再利用できる手順をまとめる場所です。毎回使わない長い手順をAGENTS.mdへ全部入れると、どの仕事にも不要な文脈が増えます。必要な時だけ読み込むSkillとして、入力、工程、検証、成果物をまとめた方が扱いやすくなります。MCPやコネクタは外部データや操作手段を接続しますが、接続しただけで使用許可や正しい手順が決まるわけではありません。 フック、テスト、リンター、型検査、承認ゲートは機械的な検査や停止に使います。たとえば、秘密らしい文字列を含むコミットを拒否し、公開前にビルドを必須にし、本番削除では人の承認を要求します。「推奨」はルール、「値」は設定、「繰り返す方法」はSkill、「必ず止める」は権限や検査というように役割を分けると、長い注意書き一つへ安全性を背負わせずに済みます。
良いルールは短く具体的で検証できる
良いルールは、対象、行動、条件、確認方法が明確です。「品質を高くする」より、「TypeScript変更後はnpm run lintとnpm run buildを実行し、失敗内容を報告する」と書きます。「勝手に変更しない」だけでなく、「docs/archiveは参照専用。編集、移動、削除をしない」と対象操作まで示します。絶対条件と好みを同じ強さで並べず、MUST、SHOULD、例外時の相談先を区別します。 最初に、リポジトリの目的、主要ディレクトリ、正式な起動・テストコマンド、変更禁止領域、完了条件を書けば十分です。新しい失敗が繰り返された時だけ規則を追加します。背景説明が長い場合は別資料へ移し、ルールには実行時に必要な要点と参照先を残します。古いパッケージ名、存在しないコマンド、退役したブランチが残っていないか定期的に確認します。 曖昧な指示、相互矛盾、巨大なファイル、秘密の記載、OSに合わない命令は代表的な失敗です。別案件の規則をコピーしたまま正式パスを直し忘れると、正しい形式で誤った場所を更新します。親階層と子階層の規則が逆なら、どちらが適用されたかを知らない担当者は誤解します。ルールを増やす前に、現状の失敗が説明不足、設定不足、権限過大、テスト不足のどれかを切り分けます。
ルールファイルにも安全境界がある
ルールファイルは信頼できる作業指示として扱われるため、変更レビューが必要です。外部から取得した記事やIssue本文に「以前の規則を無視せよ」と書かれていても、それは資料中の文字であり、プロジェクトの正規ルールではありません。エージェントが外部文書を読んでAGENTS.mdやCLAUDE.mdを書き換える場合は、差分を人が確認し、正本と変更理由を確かめます。 APIキー、パスワード、個人情報をルールへ保存しません。リポジトリへ入れれば履歴、フォーク、ログへ残る可能性があります。ルールに「本番APIキーは環境変数PROD_API_KEYから取得する」と参照方法だけを書き、値は権限管理された秘密保管場所へ置きます。エージェントへ必要最小限の読み書き権限を与え、外部送信、公開、削除は別の承認段階にします。 また、ルールは上位のシステム指示や現在の明示的な依頼、実際の権限を置き換えません。ファイルへ「全フォルダーを編集できる」と書いても権限は増えません。逆に、安全規則へ反する依頼が来た時に黙って実行する理由にもなりません。秘密を隠す、禁止領域を読み書きしない、利用者の未保存差分を保護する、外部影響の大きい操作前に確認するという境界は、文書と実行基盤の両方で守ります。
有効なルールを実作業で確認する
確認は、ファイルが存在するかを見るだけでは不十分です。まず新しいセッションを対象ディレクトリで開始し、読み込んだ指示元、正式な作業場所、禁止領域、検証コマンド、完了条件を要約させます。次に、ルートだけの規則が適用されるファイルと、子ディレクトリの追加規則が適用されるファイルで小さな変更を行い、期待したコマンドと報告が選ばれるか試します。 意図的な競合試験も有効です。ルートでは共通テスト、frontendでは画面テストを追加し、frontend作業で両方が実行されるか確認します。書き込み禁止フォルダーは権限でも読み取り専用にして、エージェントが停止して報告するかを試します。テスト失敗時に無視して完了扱いせず、失敗内容と未完了状態を返すかも見ます。 最後に、Git差分、実行ログ、テスト結果、成果物を人が確認します。ルールが長すぎて重要事項が抜ける、変更後のセッションで再読込されない、別OSではコマンドが失敗する、子階層の指示が親と衝突する、といった境界例を記録します。読者演習では、小さなWebプロジェクトを想定し、ルート用ルールとfrontend用ルールを作ります。正式パス、起動、検証、保護領域、公開前承認、完了証拠を書き、別の人がその二枚だけで安全に作業を始められるか説明してもらってください。
実例で理解する
具体例で考える
講座制作プロジェクトなら、ルートのルールへ正式案件番号、正本パス、復旧元の更新禁止、完成基準、検証コマンド、公開承認の扱いを書きます。サイト配下にはスマホ表示、前後リンク、ビルド、公開Versionの確認を追加します。制作手順はSkillへ分離し、本番公開は合格時だけ実行できる権限と承認ゲートで守ります。開始時に有効な規則を要約し、公開後はURL、本文文字数、テスト結果、Versionを証拠として残します。
手を動かして理解する
- 自分のプロジェクトで毎回繰り返している指示を五つ集める
- ルート用と特定ディレクトリ用へ適用範囲を分ける
- 正式パス、禁止領域、実行コマンド、完了条件、失敗時の報告を書く
- 文章で伝える規則と、権限・フック・テストで強制する条件を分ける
- 新しいセッションで有効な規則を要約させ、二つの範囲で動作確認する
04|今日の理解度を確認する
DAY 12の理解度を確認する
新しいCodexセッションでも同じ検証方法と編集禁止領域を共有したい時、最も適切な方法はどれですか。
継続して使うリポジトリ規約は、版管理できるAGENTS.mdへ具体的に記載します。
前回の会話を覚えていると仮定する: 別セッションや別担当では過去の会話が利用できず、重要条件も埋もれます。
リポジトリのAGENTS.mdへ対象範囲と具体的な規則を書く: 正解です。作業開始時に読み込まれる継続指示として共有できます。
APIキーをソースコードへ書く: 秘密が履歴やログへ残るため、専用の秘密管理を使います。
毎回テストを省略して結果だけ報告する: 完了を裏付ける検証がなく、規約を共有する目的にも反します。
ルートのAGENTS.mdとfrontend配下のAGENTS.mdで表示確認の指示が異なる時、frontendを編集する前に行う確認として最も適切なものはどれですか。
Codexは階層の指示を結合し、近い範囲の指示が後から適用されるため、実際の読込元を確認します。
ルートだけを読み、子の指示を無視する: 子ディレクトリ専用の検証や制約を見落とします。
ファイル名が同じなので両方を削除する: 階層化は対象範囲を分ける正式な仕組みであり、削除は解決になりません。
開始ディレクトリと読込元を確認し、有効な指示を要約する: 正解です。どの範囲の規則が有効かを作業前に確認できます。
どちらの指示も読まず、一般的な方法を選ぶ: プロジェクト固有の完了条件や禁止領域を守れません。
Claude Codeに本番データ削除を必ず止めさせたい場合、最も安全な設計はどれですか。
CLAUDE.mdは文脈であり強制設定ではないため、重要操作はモデルの判断から独立した仕組みで止めます。
CLAUDE.mdへ注意を書くことだけに頼る: 必要な指示ですが、技術的に操作を拒否する保証にはなりません。
削除権限を制限し、PreToolUseフックや承認ゲートでも検査する: 正解です。文章、最小権限、実行前検査を重ねています。
削除後にログを読む: 不可逆な影響が発生した後では防止になりません。
モデルへ自信がある時だけ削除するよう頼む: モデルの自己評価は権限や承認の代わりになりません。
プロジェクト用ルールファイルの内容として、最も実行しやすいものはどれですか。
対象行動、具体的コマンド、失敗時の扱いが明確で、実行結果を検証できます。
いい感じに高品質へ仕上げる: 品質の定義と確認方法がなく、担当ごとに解釈が変わります。
秘密情報をすべて本文へ保存する: ルールファイルは版管理され得るため、秘密の保存場所には不適切です。
変更後はnpm run lintとnpm run buildを実行し、失敗と未完了項目を報告する: 正解です。完了条件を具体的かつ検証可能にしています。
状況にかかわらず全フォルダーを書き換える: 対象範囲が過大で、未保存差分や保護領域を壊す危険があります。
ルールファイルを更新した後の確認方法として、最も適切なものはどれですか。
読み込み、適用範囲、実際の行動、完了証拠まで通して確認します。
ファイルを保存できた時点で完了にする: 存在していても名前、場所、開始地点の違いで読み込まれない場合があります。
同じ実行が自動で再読込したと仮定する: 指示探索は通常開始時に行われるため、新しい実行で確認します。
新しいセッションで読込元と有効な規則を確認し、対象範囲ごとの小さな作業と検証コマンドを試す: 正解です。設定と実作業の両方を証拠で確認できます。
説明文の長さだけを測る: 長さは、規則が読み込まれ守られたことを示しません。
04|今日の理解度を確認する
DAY 12の理解度を確認する
今日の整理をする
ここまで分かれば次へ
- ✓ ルールファイルは継続的な作業規約を文脈へ渡し、会話の一時的な依頼や秘密は入れない
- ✓ AGENTS.mdとCLAUDE.mdは適用範囲と読込方法を確認し、重要な禁止は権限・フック・テストで強制する
- ✓ 有効な指示元、作業場所、禁止領域、検証コマンド、完了証拠を実際のセッションと差分で確認する
講義本文 4,763字