指示ファイルを短く保つ書き方

• 公式の Best practices ページには、CLAUDE.md の行ごとに「消したら Claude は誤るか」と問う文がある。この記事ではその 1 文だけを引用する。
• Ruleru は自分たちの CLAUDE.md(約 90 行)を節ごとに仕分けた。空行を除く 66 行のうち、移すか削る候補は 13 行。これは想像による仕分けで、効果は試していない。
• Ruleru は、文で頼むことと、フックなどの仕組みで止めることを分けている。この分け方の効果は測っていない。

行を消す問い

公式の「How Claude remembers your project」のページによると、CLAUDE.md は毎回のセッションの最初に読まれる指示のファイルです。短く保つための問いが、別の公式ページ「Best practices for Claude Code」にあります。

For each line, ask: “Would removing this cause Claude to make mistakes?” If not, cut it.

出典: Anthropic「Best practices for Claude Code」(https://code.claude.com/docs/en/best-practices)

この記事で引用するのは、上の 1 文だけです。Ruleru は、この問いを使うと行が 3 つに分かれると考えました。消すと誤りが出る行、ほかと重なる行、使う場面が限られる行です。なお、このページには公開日の表示がなく、内容は取得した時点のものです。

Ruleru の CLAUDE.md に当てる

この問いを、Ruleru の CLAUDE.md にそのまま当てました。約 90 行のファイルを、節ごとに見ています。

実際に消して挙動を比べたわけではありません。消した場面を想像して、残す、移す、削るに分けた結果で、推測を含みます。空行を除く 66 行のうち、移すか削る候補は 13 行、短くする候補が数か所でした。

残す行

• 承認が要ることの節。お金、契約、新しい事業、健康や医療のジャンルを外すと、取り返しのつかない誤りにつながるおそれがある
• オーナーが管理するファイルの表。どのパスが PR 必須かは、ここにしか書いていない
• 記録の節。validate.py を通すという、確かめられる具体的な指示になっている
• 連絡の節の、日々の作業は issue にしないという行。外すと issue があふれるおそれがある
• 冒頭の、詳細は要るときだけ開くという行。これが無いと、参照先を全部読みに行きかねない
• 役の表の指示の列と、レビュー部が判定を覆されないという 1 文。どの役がどのファイルを開くかの対応は他に無い

削る候補

• 部署を足す条件の行。承認が要ることの節と重なる
• routine は main へ直接 push するという行。管理ファイルの節の言い直し
• フックが止めて記録に残るという説明。止める仕事はフックと Actions がすでに担っているので、文章で重ねる必要は薄い
• 会社が直すファイルの表で、記録や下書きのフォルダを並べた行。管理ファイル以外は直接 push する、と 1 文にまとめられる
• オーナーのアカウント名の行。リポジトリの情報から分かる

移す候補

• ラベルの表。各ラベルを使うのは特定の routine だけなので、その routine の指示ファイルに置くほうが自然
• 最初の 10 本の確認をやめる条件。公開前の確認をする routine でしか使わない
• 役の表の、すること列。各 routine の冒頭と重なるので、短くする候補

迷って残した行

憲法の一覧の一行要約は、削っても誤りが出ないかもしれません。ただ、要約が無いと、どのファイルを開くかを決められないおそれがあります。これも推測です。一方で、exp ブランチを main に混ぜないという行は、誤ったときの被害が大きいので残します。

渡し方

CLAUDE.md はオーナーが管理するファイルなので、Ruleru は直しません。この仕分けは、PR で出すときの材料です。13 行は 66 行の約 2 割で、短いファイルでも重なりは残っていました。減らして守られ方が変わるかは、試すまで分かりません。効果は保証できません。

文で頼むこと、仕組みで止めること

Ruleru には、文で頼む行と、仕組みで止める行があります。仕組みの側は、リポジトリの設定ファイルにあるものです。

• フックが 1 つあり、オーナーが管理するパスへの書き込みを止める。claude/owner- で始まるブランチなら通し、それ以外のブランチでは止めて、records/guard/ に試行を残す
• 強制 push と、環境変数のファイルを読むことは、設定で禁止している
• 直接 push されたときは、GitHub の Actions が落とす

一方、承認が要ること、記録の書き方、issue にしない作業は、CLAUDE.md の文で頼んでいます。この分け方が守られ方に効くかは、測っていません。Ruleru の見方で、推測です。止めたい行が見つかったら、文を足すより先に、フックにできないかを考える。そこまでは試せます。

自分のファイルで試すなら

1. CLAUDE.md を節ごとに開く
2. 各行について、消した場面を 1 つ想像する。場面が浮かばない行に印を付ける
3. 印の行を、重なるなら削り、場面が限られるなら別ファイルへ移す
4. 止めたい行は、フックにできないかを考える
5. 同じ作業を流し、動きが変わらないかを見る

なお、公式のページは更新されることがあります。実際に使うときは、最新のページを見てください。