最終更新 11月8日 18:55

毎回同じ説明をしている人向け|クロードのプロジェクト用指示ファイルで相棒を残す

毎回同じ説明をしている人が最初に困るのは、「このリポジトリではこう進めて」と毎回打ち直し、相棒としての前提が残らないことです。

本記事では、プログラムのフォルダを直す開発用の画面(クロード Code)のプロジェクト用指示ファイル(CLAUDE.md)に、人が書く方針を残す方法を整理します。自動のメモ(メモリー)とは分けて扱います。

次は、人が書く方針と自動のメモを分け、同じ訂正が二度出たら指示へ昇格する順で進めます。

人が書く方針と、自動のメモ。人が書くのはプロジェクト用の指示ファイルで、方針・構成・レビュー観点をチームで共有する。自動のメモはクロードが取る自動メモリーで、訂正・好み・コードから読めない事情がリポジトリ単位で残る。
人が書く方針と、自動のメモ。人が書くのはプロジェクト用の指示ファイルで、方針・構成・レビュー観点をチームで共有する。自動のメモはクロードが取る自動メモリーで、訂正・好み・コードから読めない事情がリポジトリ単位で残る。
目次

人が書く方針と、自動のメモ

仕組み 誰が書くか 向く内容
プロジェクト用の指示ファイル(またはAGENTS.md) 人 方針、構成、レビュー観点
自動メモリー クロード 訂正、好み、コードから読めない事情

どちらも会話の開始時に読み込まれます。強制の設定ではなく文脈です。動作を必ず止めたいときは、公式どおり PreToolUse の自動実行(hooks)を使います。長い手順は呼び出し用の手順(スキル)へ移し、指示ファイルは毎回持たせたい事実に限ります。

相棒の残し方。避ける進め方は非公式のペット演出を製品機能だと書くこと、方針と自動メモを同じファイルに混ぜること。正しい進め方は人が書く方針と自動メモを分け、同じ訂正が二度出たら指示へ昇格すること。
相棒の残し方。避ける進め方は非公式のペット演出を製品機能だと書くこと、方針と自動メモを同じファイルに混ぜること。正しい進め方は人が書く方針と自動メモを分け、同じ訂正が二度出たら指示へ昇格すること。

相棒の残し方

避ける進め方は、非公式のペット演出を製品機能だと書くこと、方針と自動メモを同じファイルに混ぜることです。正しい進め方は、人が書く方針と自動メモを分け、同じ訂正が二度出たら人が一文に要約して指示ファイルへ昇格することです。

愛着のある演出より、次のセッションで同じ説明を省略できることが公式の目的です。作業時間の変化は、自社の前後記録と期間で確認します。

指示ファイルの置き場(広い順)。組織は管理ポリシー、ユーザーはホーム配下の指示、プロジェクトはリポジトリ直下または .claude 配下、ローカルは個人用で共有しない。組織・ユーザー・プロジェクト・ローカルの順で読み込まれる。
指示ファイルの置き場(広い順)。組織は管理ポリシー、ユーザーはホーム配下の指示、プロジェクトはリポジトリ直下または .claude 配下、ローカルは個人用で共有しない。組織・ユーザー・プロジェクト・ローカルの順で読み込まれる。

指示ファイルの置き場(広い順)

公式は広い順に、組織の管理ポリシー、ユーザーのホーム(ユーザー)フォルダ配下の指示、プロジェクトの ./CLAUDE.md または ./.claude/CLAUDE.md、個人用の ./CLAUDE.local.md を挙げています。チームで共有するのはプロジェクトファイルです。ローカル専用は共有対象から外します。

/init で草案を作れます。既存ファイルがあるときは上書きせず改善案を出す、とあります。読み込み確認は /context です。書くタイミングの公式例は、同じ失敗が二度出たとき、レビューで知るべき事情が見つかったとき、前回と同じ訂正を打ったとき、新しい人が同じ説明を必要とするときです。

ビルドコマンド、規約、配置、「常にこうする」を短く書きます。特定ディレクトリだけに効かせるなら .claude/rules/ です。個人の好みをプロジェクトファイルへ混ぜると、チーム共有のときにノイズになります。

文脈と強制の違い。文脈は指示ファイルで毎回読まれる方針(強制ではない)。強制は自動実行で、必ず止めたい操作に PreToolUse を使う。
文脈と強制の違い。文脈は指示ファイルで毎回読まれる方針(強制ではない)。強制は自動実行で、必ず止めたい操作に PreToolUse を使う。

文脈と強制の違い

指示ファイルは毎回読まれる方針ですが、強制ではありません。必ず止めたい操作は自動実行(hooks)です。方針に「削除するな」と書いただけでは止まらない場合があります。止めたいなら PreToolUse 側へ移してください。

チャットアプリ側のメモリー(設定画面のトピック)と、開発用の画面の指示ファイル/自動メモリーは、公式ドキュメントが別です。片方をオンにしたからといって、もう片方が同じ内容を持つとは書かれていません。入り口ごとに何が残るかを、それぞれの公式ページで確認してください。

相棒を残す五つの手順。1 禁止:禁止事項とビルド方法だけを先に書く。2 草案:/init で草案を作り事情は人が足す。3 確認:/context で読み込みを確認。4 移す:長い手順はスキルへ。5 昇格:同じ訂正は人が一文にして指示へ昇格。
相棒を残す五つの手順。1 禁止:禁止事項とビルド方法だけを先に書く。2 草案:/init で草案を作り事情は人が足す。3 確認:/context で読み込みを確認。4 移す:長い手順はスキルへ。5 昇格:同じ訂正は人が一文にして指示へ昇格。

相棒を残す五つの手順

  1. 禁止事項とビルド方法だけを先に書く
  2. /init で草案を作り、コードから読めない事情は人が足す
  3. /context で読み込みを確認する
  4. 長い手順はスキルへ移す
  5. 同じ訂正は人が一文にして指示へ昇格する

自動メモリーは、訂正や好みをクロードがメモし、次のセッションでも使います。リポジトリ単位で、公式は先頭200行または25KBを読み込むと書いています。サブエージェントが独自の自動メモリーを持てる、という案内もあります。人が書く方針と混ぜない方が、後から直せます。

チームで共有するとき

共有するのはプロジェクト用の指示ファイルです。個人の好みや端末固有の事情はローカル専用へ分けます。新しい人が同じ説明を必要とする一文だけを残すと、二度調べる必要が減ります。

レビュー観点、禁止事項、ビルドと確認のコマンド名を短く書くのが向いています。長い手順や画面操作の列挙はスキル側です。指示ファイルが長くなるほど、毎回の読み込み負担が増えます。

AGENTS.md を単独または指示ファイルと併せて読める、という公式案内もあります。リポジトリの既存方針に合わせてください。どちらを正にするかはチームで一文決めておけば足ります。

よくあるつまずき

  • 非公式のペット演出を製品機能として手順書に書く
  • 方針と自動メモを混ぜ、後から直せなくなる
  • 必ず止めたい操作を指示ファイルだけに書く
  • 個人の好みをプロジェクト共有ファイルへ入れる
  • チャットの記憶と開発用の記憶を同じものだと説明する

つまずいたときは、/context で何が読まれているかを確認し、禁止事項とビルド方法だけに戻してください。

FAQ

書けば毎回守られますか?

公式は文脈であり強制ではないと書いています。必ず止めたい操作は自動実行(hooks)です。

AGENTS.mdだけでもよいですか?

公式は、AGENTS.mdを単独またはプロジェクト用の指示ファイルと併せて読めると説明しています。リポジトリの既存方針に合わせてください。

チャットのメモリーと共有されますか?

公式は別ページで説明しています。同一内容になるとは書いていません。入り口ごとに確認してください。

/init で上書きされますか?

既存ファイルがあるときは上書きせず改善案を出す、とあります。確定は人が行います。

効果は何割ですか?

実測値は自分の利用枠と請求画面で確認します。目的は同じ説明の省略です。

次の一手は、プロジェクト直下に禁止事項とビルド方法だけを置き、/context で読み込みを確認することです。同じ訂正が二度出たら人が一文に要約して昇格してください。金額は料金ページです。

まとめ

毎回同じ説明をしているなら、人が書くプロジェクト用の指示ファイルと、クロードが取る自動メモリーを分けて残します。プログラムのフォルダを直す開発用の画面(クロード Code)の相棒は、非公式演出ではなく公式の記憶の仕組みです。必ず止めたい操作は自動実行(hooks)へ移してください。

参考文献

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

コメント

コメントする

目次