Python-разработчик укротил Claude Code: конфиг против регрессий в открытом доступе

Разработчик из компании CREATMAN несколько недель изучал документацию, обсуждения на Reddit и чужие сетапы, чтобы собрать конфигурацию Claude Code с реальной защитой от регрессий. Итог — открытый репозиторий с готовыми файлами для немедленного использования.

Проблема, которую все знают

Claude Code работает мощно, но без правильной настройки действует слишком самостоятельно. Типичная картина для разработчика-одиночки: Попросил добавить авторизацию — агент переписал половину проекта Попросил поправить одну функцию — получил удалённые тесты и незапрошенную зависимость * За час собрал рабочий прототип — три часа разгребал «улучшения» агента Для тех, кто работает один, это критично вдвойне. Нет QA-инженера, который поймает регрессии после каждого промпта. Нет ревьюера, который заметит удалённые тесты. Каждая незапланированная правка — это время, потраченное на разбор чужих решений вместо работы над продуктом. Автор ведёт компанию CREATMAN без команды и столкнулся именно с этим: AI помогает быстро строить, но без контроля так же быстро создаёт новые проблемы.

Из чего собрана конфигурация

После нескольких недель чтения доков, обсуждений на форумах и анализа чужих сетапов автор выделил пять ключевых компонентов. Все они собраны в репозитории claude-code-antiregression-setup и готовы к использованию: CLAUDE.md — главный файл-контракт: скоуп задачи, явные запреты на самостоятельные решения, требования к описанию предстоящих изменений перед их выполнением Правила для директорий — ограничения на уровне папок, чтобы агент не трогал то, до чего его явно не просили Обязательный чеклист — перед любыми изменениями агент описывает план, разработчик подтверждает или отклоняет Хуки — автоматические скрипты, которые запускаются после каждого действия агента и проверяют соответствие задаче * Шаблоны промптов — готовые форматы запросов, которые убирают двусмысленность и сужают пространство для интерпретации Важно, что всё задокументировано.

Репозиторий рассчитан не на изучение, а на быстрое подключение: клонируй, адаптируй под проект, используй.

Почему контракт работает лучше запрета

Ключевая идея — дать агенту чёткие правила, а не просто ограничить. Claude Code читает CLAUDE.md в начале каждой сессии. Если там явно написано «не трогай тесты без запроса», «изменения только в пределах указанных файлов» или «предупреди перед добавлением зависимости» — агент следует этому.

«Мне нужно, чтобы AI-агент помогал быстрее шипить, а не создавал новые проблемы», — объясняет задачу автор.

Хуки добавляют второй уровень. Небольшие скрипты запускаются после изменений и проверяют, не вышел ли агент за рамки. Если вышел — изменения помечаются для ревью вместо того, чтобы молча уйти в кодовую базу.

Шаблоны промптов решают другую задачу. Расплывчатый запрос даёт агенту слишком много пространства для интерпретации — и именно здесь начинается самодеятельность. Готовые форматы с явным указанием скоупа, файлов и ожидаемого результата это пространство резко сужают.

CLAUDE.md — не просто README для агента, а живой документ проекта. В нём фиксируются архитектурные решения, критические модули, конвенции именования.

Агент использует этот файл как контекст при каждом запросе — и это делает его понимание проекта конкретнее, а случайные «улучшения» — менее вероятными. Конфигурация не привязана к конкретному стеку. Автор работает с Python-бэкендом, но принципы применимы к любому проекту, где нужно удерживать агента в рамках поставленной задачи.

Что это значит

Непредсказуемость — один из главных барьеров для внедрения AI-агентов в соло-разработку. Открытые конфиги вроде этого снижают порог входа: берёшь структуру, адаптируешь под проект и получаешь управляемый инструмент вместо хаотичного помощника. Чем больше таких сетапов появляется в открытом доступе, тем практичнее становится использование AI-агентов без команды поддержки.