git:20251222.3b0e150 to git:20260525.164e16b

---

name: creating-claude-rules

description: Use when creating or fixing .claude/rules/ files - provides correct paths frontmatter (not globs), glob patterns, and avoids Cursor-specific fields like alwaysApply

---

# Creating Claude Rules

## Overview

Rules in `.claude/rules/` are modular instructions scoped to specific files via glob patterns. They load automatically with same priority as `CLAUDE.md`.

## When to Use

- Creating new rules in `.claude/rules/`

- Fixing rules that use wrong frontmatter (`globs` instead of `paths`)

- Migrating Cursor rules to Claude format

- Organizing project-specific conventions

## Quick Reference

## Frontmatter

### Path-Scoped Rules

```yaml

---

paths:

---

```

Or single pattern:

```yaml

---

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

---

```

### Global Rules

Omit frontmatter entirely - applies to all files:

```markdown

# TypeScript Conventions

Use .js extensions in imports.

```

## Common Mistakes

```yaml

# ❌ WRONG - globs is Cursor format

---

globs:

---

# ✅ CORRECT - Claude uses paths

---

paths:

---

```

```yaml

# ❌ WRONG - alwaysApply is Cursor-only

---

alwaysApply: true

---

# ✅ CORRECT - just omit paths for global rules

# (no frontmatter needed)

```

```yaml

# ❌ WRONG - unquoted patterns

---

paths:

- **/*.ts

---

# ✅ CORRECT - quote glob patterns

---

paths:

- "**/*.ts"

---

```

## Directory Structure

```

.claude/rules/

├── testing.md # Path-scoped or global

├── typescript.md

└── frontend/ # Subdirectories supported

└── react.md

```

Files discovered recursively. Use subdirectories to organize.

## Glob Patterns

## Reference

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