Топ-3 правила CLAUDE.md для идеального вайбкодинга

Система вместо мотивации — защити проект от технического долга

#1 — Код как референс, не копипаста

Правило: Любой код в промпте — это идея, не готовое решение

Адаптация под архитектуру. AI адаптирует код под существующую архитектуру проекта, а не вставляет сниппеты вслепую
Переиспользование компонентов. Переиспользует готовые хуки и компоненты — без дублей и лишних зависимостей
Контроль производительности. Следит за производительностью: нет лишних ре-рендеров, нет утечек памяти
Осознанная интеграция. Не вставляет сниппеты слепо — интегрирует осознанно с учётом контекста

Запрещено

копировать код 1-в-1 без анализа контекста и существующей архитектуры

Правило: После любого изменения — обновляй документацию автоматически

Изменение логики

Обновить PROJECT_DOCUMENTATION.md сразу после изменения бизнес-логики

Схема БД

Зафиксировать новую структуру базы данных и миграции

Роуты и маршруты

Обновить карту маршрутов после любых изменений роутинга

UI-архитектура

Описать новые компоненты и их взаимосвязи после изменения UI

Перед новым чатом

Прочитать документацию для восстановления контекста перед началом работы

Запрещено

начинать задачу без актуального слепка системы

Правило: AI проверяет себя сам перед отчётом о готовности

Единый компонент. Единый компонент с viewMode — не плодим дубли под разные состояния
Fallback-стратегия. Описана стратегия: что показывать при отсутствии данных
SEO-оптимизация. Title до 60 символов, meta description заполнен, robots настроен для приватных страниц
Авто-обновление. Статусы с auto-refresh реализованы для асинхронных операций

Запрещено

создавать упрощённые шаблоны вместо единого компонента с параметрами