Готовые для агентов кодовые базы: отрицательные правила, точные имена, README для каталогов

Разработчик на r/ClaudeAI подробно описал, как адаптировал свою Android-кодовую базу после того, как Claude Code постоянно добавлял новые функции в монолитный класс UserManager (аутентификация, сессии, профиль, аналитика). Ключевой вывод: агент каждый раз начинает с чистого листа, как новый сотрудник в первый день, не помня архитектурных решений. Исправление состояло в явных правилах в файле CLAUDE.md в корне репозитория.

Три паттерна, которые дали наибольший эффект

1. Негативные правила работают лучше позитивных

Вместо «следуй хорошему дизайну» разработчик пишет инструкции вроде:

НЕ трогай BaseActivity – он общий для 12 функций и ломается молча.

Агент по умолчанию оптимистичен и выбирает путь наименьшего сопротивления. Явное закрытие опасных путей останавливает плохие решения эффективнее, чем расплывчатые указания.

2. Имена важнее, чем кажется

Класс с именем UserSessionExpiryHandler – это контракт. Назвать его просто Handler – шум. Агент сильно ориентируется на имена; хорошие имена сокращают объём чтения файлов. Разработчик рекомендует избегать общих суффиксов и делать назначение явным в имени.

3. В каждой директории есть README с перечнем того, что там НЕ должно быть

Вместо «эта папка для UI» README говорит:

Никакой бизнес-логики в presentation/

Такая негативная формулировка «лучше воспринимается» агентом, предотвращая больше неудачных размещений, чем позитивные указания.

Практические правила для CLAUDE.md

• Держите файлы маленькими. Один класс – одна задача.
• Создавайте новый файл, а не расширяйте старый.
• Не создавайте монолиты – разделяйте обязанности заранее.

Разработчик сообщает, что после применения этих правил паттерн, когда агент трижды перечитывал 600-строчный файл за одну сессию, практически исчез. Он подозревает, что затраты токенов значительно снизились, но не проводил точных замеров.

Для кого это

Для разработчиков, использующих ИИ-агенты написания кода (Claude Code, Copilot и др.), которые хотят сократить расход токенов и предотвратить принятие агентом плохих архитектурных решений.