Урок 17Память

Модульные правила

Инструкции для путей

Что такое модульные правила

Модульные правила — это отдельные .md файлы в директории .claude/rules/, которые применяются только к определённым файлам.

.claude/rules/
├── typescript.md       # Rules for *.ts, *.tsx
├── react.md           # Rules for components
├── api.md             # Rules for API routes
├── tests.md           # Rules for tests
├── security.md        # Security guidelines
└── database.md        # Database conventions

💡 Правила автоматически подгружаются когда Claude работает с файлами, соответствующими паттернам.

Формат правила

Каждое правило — это Markdown файл с YAML frontmatter, содержащим paths:

---
paths:
  - "**/*.ts"
  - "**/*.tsx"
  - "!**/*.test.ts"
---

# TypeScript Rules

Your instructions here...

Включающие паттерны

**/*.ts — все TS файлы
src/components/** — все в components
*.config.js — конфиги в корне

Исключающие паттерны

!**/*.test.ts — кроме тестов
!**/node_modules/** — кроме modules
!dist/** — кроме dist

Примеры правил

typescript.md

**/*.ts**/*.tsx

---
paths:
  - "**/*.ts"
  - "**/*.tsx"
---

# TypeScript Rules

- Use strict TypeScript settings
- Prefer interfaces over types for objects
- Always add return types to functions
- Use 'unknown' instead of 'any'

react.md

src/components/**/*.tsx

---
paths:
  - "src/components/**/*.tsx"
---

# React Component Rules

- Use functional components only
- Props interface should be named {ComponentName}Props
- Use memo() for expensive renders
- Prefer composition over prop drilling

api.md

src/app/api/**/*.ts

---
paths:
  - "src/app/api/**/*.ts"
---

# API Route Rules

- Always validate request body with Zod
- Return proper HTTP status codes
- Handle errors with try/catch
- Log all errors to monitoring

tests.md

**/*.test.ts**/*.spec.ts

---
paths:
  - "**/*.test.ts"
  - "**/*.spec.ts"
---

# Testing Rules

- Use describe/it blocks
- Mock external dependencies
- Test edge cases
- Aim for 80% coverage

Когда применяются правила

Claude читает файл → Загружаются правила для этого типа файлов

Claude редактирует файл → Применяются правила при генерации кода

Claude создаёт новый файл → Правила определяются по расширению/пути

Лучшие практики

1.Создавайте отдельные правила для разных типов файлов
2.Используйте исключения (!) для тестов и сгенерированных файлов
3.Документируйте "почему", а не только "что"
4.Коммитьте правила в git вместе с проектом

Этот урок — часть структурированного курса по LLM.

Мой путь обучения