Готовые для агентов кодовые базы: отрицательные правила, точные имена, 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 проводить жесткие ревью кода, представляя, что код написан ненавистной тещей. В результате — 27 найденных проблем от 4 враждебно настроенных агентов-рецензентов после 31 минуты глубокого анализа.
Проверка неиспользованных кредитов на сброс кодекса в нескольких аккаунтах ChatGPT через OpenClaw
Один пользователь обнаружил, что кредиты на сброс лимита запросов истекают на второй учетной записи OAuth. Агент проверил обе, нашел 6 неиспользованных. Один был погашен, что очистило кулдаун менее чем за минуту. Подводные камни включают недокументированную конечную точку и проблемы с обнаружением навыков.
7 уязвимостей шлюза MCP: утечки сессий, мертвый SSE и OAuth в режиме шлюза
Пост на Reddit описывает семь реальных багов шлюза MCP — утечка состояния сессии между клиентами, молчаливые разрывы SSE-соединений, проблемы OAuth в режиме шлюза и другое — с исправлениями на основе скучной инфраструктуры, а не лучших промптов.
Запускайте код Claude в интегрированном терминале VSCode/Cursor для улучшения рабочего процесса
Запуск Claude Code во встроенном терминале VSCode или Cursor вместо внешнего терминала обеспечивает мгновенный доступ к панелям git diff и отладчикам без переключения окон, при этом не требуется никакой настройки.