claude-optimised

claude-optimised — это руководство по созданию и оптимизации файлов CLAUDE.md, которые действительно учитываются Claude Code. Основной фокус — сделать инструкции короткими, точными и практичными.

Что делает этот гайд

Большинство файлов CLAUDE.md становятся слишком длинными, из-за чего Claude игнорирует важные правила. Этот подход вводит принцип «сначала сокращай», позволяя оставлять только то, что реально влияет на поведение модели.

Гайд объясняет:

• что обязательно включать в файл
• что лучше удалить
• как структурировать документ
• как поддерживать его актуальность

Основной принцип: меньше — лучше

Длинный CLAUDE.md = половина правил будет проигнорирована.

Для каждой строки задавайте вопрос:

• Если удалить — приведёт ли это к ошибкам?
• Если нет → удалить
• Если Claude уже делает это правильно → удалить или вынести в автоматизацию

Что включать

Критически важное

• Контекст проекта — кратко, в одну строку
• Команды сборки/тестов
• Критичные ограничения (что нельзя делать)
• Неочевидные соглашения
• Термины предметной области

Только если нестандартно

• схема веток
• формат коммитов
• границы файлов и чувствительные зоны

Чего не должно быть

• общие советы вроде «пиши чистый код»
• очевидные паттерны из кода
• длинные объяснения
• теоретические или «на будущее» правила

Структура файла

# Project Name
Краткое описание

## Commands
- тесты
- сборка
- линт

## Code Style
- только неочевидные правила

## Architecture
- кратко, если нужно

## IMPORTANT
- критические ограничения

Правила форматирования

• используйте списки вместо длинных абзацев
• разделяйте разделы заголовками
• формулируйте конкретно («отступ 2 пробела», а не «форматируй правильно»)
• используйте IMPORTANT только для действительно важных правил

Размещение файла

• ~/.claude/CLAUDE.md — глобальные настройки
• ./CLAUDE.md — на уровне проекта
• ./subdir/CLAUDE.md — для конкретной папки
• .claude/rules/*.md — автоматически подгружаемые правила

Чек-лист оптимизации

• менее 50 строк
• каждая строка решает реальную проблему
• нет дублирования между файлами
• нет очевидных инструкций
• проверено на практике (поведение Claude изменилось)

Поддержка и обновление

• начинайте с /init, затем сокращайте
• раз в несколько недель пересматривайте файл
• если Claude ошибается — добавьте конкретное правило
• если игнорирует — файл слишком длинный, сокращайте

Антипаттерны

• 200+ строк — игнорируется
• дублирование правил
• абстрактные формулировки
• длинные тексты вместо списков

Пример минимального CLAUDE.md

# MyApp
React Native приложение с Expo. Backend — Supabase.

## Commands
- pnpm test
- pnpm ios

## Style
- использовать Zustand вместо Context
- clsx для условных классов

## IMPORTANT
- не коммитить .env
- логика авторизации только в src/lib/auth.ts

Пример занимает около 15 строк и содержит только то, что Claude не сможет вывести самостоятельно. Ничего лишнего.