LLM не имеет памяти между сессиями - без CLAUDE.md каждая сессия генерирует код в своём стиле, нарушаются naming conventions, используются запрещённые паттерны.

Создай CLAUDE.md в корне репозитория с обязательными разделами: архитектура (слои), стек, структура проекта, правила кодирования, API-контракты, БД-схема, тесты, NATS, безопасность, Git-процесс. Это контракт LLM с собой. Архитектор ревьюит его при каждом изменении, Lead отвечает за актуальность.

Что внутри:

  • Что происходит без такого контракта
  • Решение - один файл в корне репозитория
  • Дальше - обязательные разделы, по порядку
  • Дальше стек и структура проекта
  • Правила кодирования. Стиль - линтером Ruff, со ссылкой на конфиг

Смотреть полностью

Коротко