プロジェクトの指示を整える

このレッスンで学ぶこと

プロジェクト指示ファイルは、作業のたびに説明している「リポジトリ固有の前提」を共有するためのものです。Claude Codeの公式ドキュメントでは、CLAUDE.md に加え、既存プロジェクトの AGENTS.md も指示ファイルとして扱えると説明されています。

指示ファイルは会話のコンテキストとして参照されるもので、強制的なアクセス制御やセキュリティ境界ではありません。実際の権限管理や承認設定を置き換えるものではないため、秘密情報や認証情報を含めないでください。

何を記録するか

プロジェクトの構成を実際に調べた後、役立つ内容だけを選びます。

アプリや主要ディレクトリの役割
セットアップ、ビルド、テスト、型検査などの実在するコマンド
コード規約や既存の設計パターン
変更時に確認する必要がある項目
編集してはいけない生成物や、避けるべき危険な操作

同じ依頼で一度だけ必要な情報、コードを読めば分かる長い説明、まだ存在しないコマンドは追加しません。多くの作業ですぐに役立つ最小限の指示から始め、繰り返し発生した修正やレビュー指摘をもとに見直します。

1. 既存の指示を確認する

作成・編集を依頼する前に、ルートと関連ディレクトリの CLAUDE.md や AGENTS.md、既存ルールファイルの有無を調べます。すでに運用中の指示を無断で置き換えないでください。どのファイルを誰と共有するかも、プロジェクトの所有者と確認します。

2. 追加する内容を提案させる

このプロジェクトで実際に確認できた構成、既存の規約、package.jsonに定義された検証コマンドをもとに、短いプロジェクト指示の案を作ってください。まず案だけを示し、ファイルはまだ変更しないでください。推測した情報、秘密情報、個人設定、存在を確認できないコマンドは含めないでください。既存のCLAUDE.mdやAGENTS.mdがあれば、重複・矛盾を指摘してください。

内容の根拠を確認し、不要なルールや推測を削ってから、どのファイルを編集するかを明示して許可します。

3. 短く保ち、動作を確かめる

保存後はファイル全体を読み、事実の誤り、古くなったコマンド、他の開発者に適さない個人設定、秘密情報がないかレビューします。次のセッションで内容が読み込まれているか、公式のメモリとCLAUDE.mdガイドおよび現在の環境で確認します。

演習：プロジェクト指示をレビューする

練習用のリポジトリで、既存の指示ファイルがあれば一つ選んでレビューします。なければ、作業を始めたばかりの開発者向けに、次の項目を含む短い案を作ります。

プロジェクトの目的と構成
確認できた主要コマンド
コード変更後に行う検証
作業時の安全上の注意

完了条件

既存の指示ファイルを確認してから変更した
ルールごとに根拠または具体的な運用理由がある
存在しないコマンド、秘密情報、個人情報を含めていない
指示ファイルが権限管理や強制的なセキュリティ制御ではないと理解した

参考資料

Claude Code: プロジェクトのメモリとCLAUDE.md — 指示ファイルの用途、配置、AGENTS.mdとの関係。

公式ドキュメントの参照先を2026年10月18日に確認しました。Claude Codeの読み込み規則は変更される場合があるため、導入時に公式案内を確認してください。

次に読む

安全なバグ修正・テスト・レビューで、実際の課題を再現から検証まで進めます。