create-rule

name	create-rule
description	.claude/rules/ 配下のルールファイル (*.md) を新規作成・編集するときに、適切なメカニズム選択と paths スコープを保証する。ルールを書く前・書いた後に必ず適用する。
when_to_use	.claude/rules/ にルールファイルを新規作成するとき、既存のルールファイルを編集するとき、「ルールを追加して」「規約を書いて」と言われたとき、ルールが全タスクで常時注入されていることに気づいたとき。

Create Rule

.claude/rules/ のルールはコンテキストに注入される指示。書き方を誤ると無関係な作業でトークンを浪費し、モデルの判断を曇らせる。作成・編集のたびに次の手順を踏む。

STEP 0: そもそも rules が適切か判断する

書こうとしている内容を、まず置き場所で振り分ける。rules に何でも書かない。

内容	置き場所
全セッションで常に効かせたい事実 (ビルドコマンド・プロジェクト構成・全体規約・応答トーン)	CLAUDE.md
特定のファイル種別・ディレクトリにだけ効かせたい指示	.claude/rules/ (paths スコープ)
手順もの・呼び出し時だけ要る重い知識 (デプロイ・コミット・コード生成)	skill (/en/skills)
Claude の判断に関係なく確実にブロック/強制したい挙動	PreToolUse hook (/en/hooks-guide)

rules と CLAUDE.md は context であって enforcement ではない — 「決して X するな」を確実に止めたいなら hook にする。

STEP 1: ファイルを分ける

• 1 ファイル 1 トピック。 記述的なファイル名にする (testing.md, api-design.md, security.md)。
• 数が増えるなら frontend/・backend/ 等のサブディレクトリに分けてよい (再帰探索される)。

STEP 2: paths でスコープする

paths の無いルールは 全タスクで無条件ロード (.claude/CLAUDE.md と同優先度)。範囲が「全ファイル共通」でない限り、必ず paths フロントマターをファイル先頭に置く。

---
paths:
  - "**/*.{ts,tsx,js,jsx,mjs,cjs}"
---

• glob 形式。** = 任意階層、* = 単一階層。拡張子は brace expansion {ts,tsx,...} で 1 行にまとめる (1 拡張子 1 行に分けない)。
• マッチするファイルを Claude が読むとき に発火する (毎 tool use ではない)。
• 迷ったらスコープする (狭すぎる害は小さいが、広すぎるとコンテキストを汚す)。

適用範囲ごとの推奨 paths (出発点。実態に合わせて増減)

適用範囲	paths
TS/JS 全般	**/*.{ts,tsx,js,jsx,mjs,cjs}
Web 系言語 + SQL (セキュリティ系)	**/*.{ts,tsx,js,jsx,mjs,cjs,py,rb,go,php,sql}
API ハンドラ等の限定領域	src/api/**/*.ts **/*.handler.ts のようにディレクトリ/命名で絞る
Python のみ	**/*.py
全ファイル共通 (規約・トーン等)	paths を付けない

STEP 3: 整合と検証

• 本文と paths が一致しているか確認 — 本文が z.object・console.log 禁止など TS/JS 前提なのに paths が空、といった不整合がないこと。
• 既存ルール編集時は先頭の paths を確認 — 無ければ常時注入が妥当か判断し、不要なら追加する。
• /memory でロード状況を確認 (デバッグには InstructionsLoaded hook も使える)。

補足: 共有とユーザーレベル

• symlink でルールを共有できる (複数プロジェクトに同じルールをリンク):

  ln -s ~/shared-claude-rules .claude/rules/shared
  ln -s ~/company-standards/security.md .claude/rules/security.md
  

• ~/.claude/rules/ は全プロジェクトに効くユーザーレベルルール (プロジェクトルールより先にロードされ、プロジェクト側が優先)。プロジェクト非依存の個人設定向け。

参考

• 一次情報: How Claude remembers your project — Organize rules with .claude/rules/
• 設計の背景: Claude Code を操る — Skills, Hooks, Rules, Subagents