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

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

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

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

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

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

## #2 — Единый источник правды: PROJECT_DOCUMENTATION.md

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

- 1 «Изменение логики» — Обновить PROJECT_DOCUMENTATION.md сразу после изменения бизнес-логики
- 2 «Схема БД» — Зафиксировать новую структуру базы данных и миграции
- 3 «Роуты и маршруты» — Обновить карту маршрутов после любых изменений роутинга
- 4 «UI-архитектура» — Описать новые компоненты и их взаимосвязи после изменения UI
- 5 «Перед новым чатом» — Прочитать документацию для восстановления контекста перед началом работы

врезка `// Запрещено`: текст «начинать задачу без актуального слепка системы»

## #3 — Встроенные чеклисты самопроверки: Zero-костылей

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

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

врезка `// Запрещено`: текст «создавать упрощённые шаблоны вместо единого компонента с параметрами»

## Система трёх правил

Как три правила работают вместе, устраняя технический долг на каждом уровне

карточка 1 — метка «Код как референс» / значение «Чистая интеграция» / капшен «Нет дублей»; карточка 2 — метка «Документация живая» / значение «Нет потери контекста» / капшен «Нет галлюцинаций»; карточка 3 — метка «Самопроверка AI» / значение «Нет костылей» / капшен «Нет технического долга»

> Правила в CLAUDE.md — это архитектура мышления AI, а не просто инструкция

---

Источник: https://localhost:3000/m/top-3-pravila-claude-md