Готовые для агентов кодовые базы: отрицательные правила, точные имена, 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 и др.), которые хотят сократить расход токенов и предотвратить принятие агентом плохих архитектурных решений.
📖 Источник: r/ClaudeAI
👀 Смотрите также
Пользователь Reddit предупреждает: при работе над сложными проектами в Claude начинайте с самой трудной части
Разработчик на r/ClaudeAI сообщает, что предоставление ИИ возможности планировать поэтапно для сложного редактора документов привело к «супу из сложностей» и сбоям. Пользователь советует заставить модель сначала решить самый сложный вариант использования, так как её производительность ухудшается с увеличением контекста.
Исправление системы проверки устраняет проблему выполнения плана Клода
Разработчик создал проверочный слой на bash или Python объемом 30-50 строк, который проверяет, действительно ли Claude выполняет каждый шаг своих планов, верифицируя артефакты, такие как существование файлов, ответы API и изменения конфигураций.
Запускайте код Claude в интегрированном терминале VSCode/Cursor для улучшения рабочего процесса
Запуск Claude Code во встроенном терминале VSCode или Cursor вместо внешнего терминала обеспечивает мгновенный доступ к панелям git diff и отладчикам без переключения окон, при этом не требуется никакой настройки.
Плагин OpenClaw Минимализм: Основные инструменты справляются с 95% задач
Разработчик, использующий OpenClaw в продакшене, сообщает, что отключение необязательных плагинов и замена критически важных на простые скрипты привело к ускорению запуска на 40%, снижению потребления памяти на 60% и отсутствию критических обновлений за четыре месяца.