親・子・孫と部門を階層化する

部門を細分化し、案件のフォルダを作っていくと、フォルダは親・子・孫と何段にも深くなります。この記事では、この階層を段と呼びます。

どの段で何が読まれ、どの段に何を置くのか。次にも使えるルールをどう上げるのか。私の例でまとめました。

フォルダは親・子・孫と深くなる

私のゲームの例ではフォルダが4段になっています。いちばん上が本部。その下にゲーム事業部、その下にゲーム開発部、さらにその下に案件のフォルダ。

ゲーム事業部を親とすると、ゲーム開発部が子、案件のフォルダが孫です。本部は、そのすべてを束ねるいちばん上の段です。どの段にも、それぞれの CLAUDE.md があります。

部門の細分化と、案件のフォルダの作り方はそれぞれこちらの記事で解説しています。

関連記事：部門の中にさらに部門を作って細分化する

関連記事：案件ごとにフォルダを分けて担当を変える

どの段で始めるかで読まれる範囲が変わる

チャットを始めたフォルダと、それより上のフォルダの CLAUDE.md は、始めたときに読まれます。下のフォルダの CLAUDE.md は、その中のファイルを読んだときに、はじめて読まれます。

この仕組みを4段に当てはめると、次のとおりです。

• 孫の案件で始めたとき：案件、ゲーム開発部、ゲーム事業部、本部の4段すべてがすぐに読まれる
• 親のゲーム事業部で始めたとき：ゲーム事業部と本部だけが読まれる。ゲーム開発部と案件は、Claude Code がそのフォルダのファイルを読んだときに読まれる

公式のドキュメントでは、上に何段あっても、上のフォルダはすべて読まれるとされています。上の段の決まりが下の段の決まりに置き換わるのではなく、すべてつなげて読まれる形です。

仕組みそのものは、こちらの記事で解説しています。

関連記事：Claude Code では方針と指示が上から下に流れる

段ごとの置き場所の目安

私は、本部にはすべてのプロジェクトに共通することを置いています。案件の CLAUDE.md には、作りたいゲームの概要を書かせています。

そのあいだの段は、たとえば次のように分けるとよいでしょう。

• ゲーム事業部：ゲーム全体で目指すところ
• ゲーム開発部：ゲーム作りのルール

下の段ほど、狭い範囲のことを書くわけです。どのフォルダで始めるかの選び方は、こちらの記事へ。

関連記事：どのフォルダでチャットを始めるか

深くしすぎない

段の数に上限はありません。ただ、深くするほど、案件で始めたときに読まれる CLAUDE.md の合計は長くなり、長いほど守られにくくなります。

段同士で決まりが食い違うと、Claude Code がどちらかを選んでしまうことも。

分けるのは、担当者を分けたい理由があるときだけにします。

次にも使えるルールは上の段へ

案件の中で決めたことが、次の案件でも使えそうなとき。私は、ゲームでもブログでも、そうしたルールを上の段に上げたことがあります。

上げるのは、次の案件にも必要な機能やルールだと思ったときです。

ゲーム開発部の CLAUDE.md に上げておけば、その下に新しい案件のフォルダを作って始めたときにも読まれます。次の案件がスムーズです。たとえば、次のように頼めます。

このルールは次の案件でも使えそうです。ゲーム開発部の CLAUDE.md に上げて保存してください。

Claude Code から提案してくれるようになった

上に上げるかどうかは私が判断することもあります。ただ、使い込んでくると、Claude Code のほうから聞いてくれるようになりました。

上に上げたほうがいいと思うのですが、上げていいですか？

私の方針や考え方を理解したのかもしれません。

Claude Code からの報告や相談の仕組みは、こちらの記事で解説しています。

関連記事：Claude Code も報連相が必要、相談・報告・連絡の決まり