プロジェクトの目的や確認方法を、作業のたびに一から説明するのは手間がかかります。Claude Codeでは、CLAUDE.mdにプロジェクトの説明や作業上の指示を書いておけます。この記事では、QAの調査で使うことを想定して、書いておきたい項目を整理します。
この記事のポイント
最初は短いルールから書き、作業中に起きた誤解や迷いに合わせて追加します。CLAUDE.mdに書くだけで操作を制限できるわけではないので、権限設定と作業結果も確認してください。
プロジェクトの目的から書く
まず、このプロジェクトで何を管理し、どの資料を参照するかを書きます。CSVを扱うなら、各列の意味、更新してよい条件、まだ確認できていない値の書き方などを決めておくと、判断の違いを減らせます。
共通して必要な説明を短くまとめ、詳しい資料は参照先を書いておくと更新しやすくなります。関連資料をすべて一つのファイルに入れる必要はありません。
調査用CLAUDE.mdの記入例
架空のCRUD一覧を管理するプロジェクトを例に、短いCLAUDE.mdを作りました。使うときは、実際のフォルダ名や判断方法に合わせて書き換えてください。
# 目的
機能ごとのCRUD情報を、根拠付きの一覧で管理する。
# 調査の進め方
- 対象ブランチを最初に確認する
- 事実、推測、要確認を分けて記録する
- 判断の根拠となるファイルを示す
- 根拠が見つからない内容は「要確認」とする
# 変更の範囲
- 調査段階ではファイルを変更しない
- 更新が必要なら、対象と差分案を先に整理する
# 確認
- 一覧へ反映した後は差分を確認する
- 技術的な不明点は担当者へ確認する指示を書いても、権限の設定や結果の確認は必要
CLAUDE.mdで伝えられるのは、モデルへの指示やプロジェクトの背景です。それだけでアクセスや操作を強制的に制限するものではありません。機密情報にアクセスできるか、どの操作を実行できるかは、利用環境の権限設定でも確認してください。
また、書いたルールがすべて守られたとは限らないので、作業結果や変更した差分を確認します。公式ドキュメントでも、指示が常に完全に適用される保証はないと説明されています。
繰り返す誤解があれば、具体例を追加する
一度ですべてを書こうとせず、同じ誤解が起きたときに説明を追加していくと管理しやすくなります。たとえば、論理削除と物理削除を混同するなら、それぞれの定義と一覧への記載例を足します。
追加したままにせず、古くなった指示や矛盾する内容も見直してください。今のプロジェクトに合っていて、必要なときに読み返せる長さにしておくと使いやすくなります。