creating-claude-rules

Claude ルールの作成

概要

.claude/rules/ のルールは、glob パターンを使って特定のファイルを対象にできるモジュール式の指示です。CLAUDE.md と同じ優先度で自動的に読み込まれます。

使用する場面

• .claude/rules/ に新しいルールを作成するとき
• 誤ったフロントマター（paths ではなく globs）を使用しているルールを修正するとき
• Cursor のルールを Claude 形式に移行するとき
• プロジェクト固有の規約を整理するとき

クイックリファレンス

フィールド	Claude	Cursor
パスパターン	paths	globs
常に適用	paths を省略	alwaysApply: true
説明	ドキュメント化されていません	description

フロントマター

パスを指定したルール

---
paths:
  - 'src/api/**/*.ts'
  - 'tests/**/*.test.ts'
---

単一のパターンの場合：

---
paths: src/**/*.{ts,tsx}
---

グローバルルール

フロントマター全体を省略すると、すべてのファイルに適用されます：

# TypeScript Conventions

Use .js extensions in imports.

よくある間違い

# ❌ WRONG - globs is Cursor format
---
globs:
  - '**/*.ts'
---
# ✅ CORRECT - Claude uses paths
---
paths:
  - '**/*.ts'
---

# ❌ WRONG - alwaysApply is Cursor-only
---
alwaysApply: true
---
# ✅ CORRECT - just omit paths for global rules
# (no frontmatter needed)

# ❌ WRONG - unquoted patterns
---
paths:
  - **/*.ts
---

# ✅ CORRECT - quote glob patterns
---
paths:
  - "**/*.ts"
---

ディレクトリ構造

.claude/rules/
├── testing.md          # Path-scoped or global
├── typescript.md
└── frontend/           # Subdirectories supported
    └── react.md

ファイルは再帰的に検出されます。サブディレクトリを使って整理してください。

Glob パターン

パターン	対象
**/*.ts	任意の場所にあるすべての .ts ファイル
src/**/*	src/ 以下のすべて
*.md	ルート直下の Markdown ファイルのみ
**/*.{ts,tsx}	.ts および .tsx ファイル
{src,lib}/**/*.ts	src/ または lib/ 内の .ts ファイル

参考資料

https://code.claude.com/docs/en/memory#modular-rules-with-claude/rules/