Как разработчик YADRO настраивает Claude Code по методу Spec-Driven Development

Программист и архитектор YADRO Даниил Подольский девять месяцев работает по методологии Spec-Driven Development и управляет AI-агентами, которые пишут код вместо него. Сам он называет себя не вайбкодером, а инженером — и объясняет почему. Это первая статья из его цикла об организации рабочего места SDD-разработчика: разбор базовой настройки Claude Code для быстрого переключения моделей без перезагрузки.

SDD против вайбкодинга

Вайбкодинг — это когда разработчик описывает задачу AI, смотрит что получилось и итерирует «на ощущение». Подход популярен именно потому, что работает быстро и не требует предварительной подготовки. Spec-Driven Development устроен принципиально иначе. Сначала создаётся полноценная спецификация: требования, архитектура, поведение системы, граничные случаи. Только после этого AI-агент начинает работать по документу как по техническому заданию. Разработчик формирует структуру и принимает архитектурные решения, AI реализует детали и заполняет код. Подольский настаивает: его подход «более комплексный, чем просто общение с AI». SDD возвращает инженерную дисциплину туда, где она стала исчезать из-за скорости AI-инструментов — требования, дизайн, реализация, верификация. Исполнитель сменился, но сам процесс остаётся инженерным. Именно это отличает SDD от вайбкодинга: не инструмент, а методология.

Настройка

Claude Code под несколько проектов Центральная задача статьи — как переключать модели в Claude Code без перезагрузки, индивидуально для каждого проекта. На первый взгляд деталь, на практике — серьёзный тормоз для тех, кто ведёт несколько репозиториев одновременно. Стандартная глобальная настройка модели не подходит в такой ситуации.

Разные проекты предъявляют разные требования: продакшен-сервис нуждается в Opus с глубоким reasoning и строгим следованием инструкциям, прототип или рутинная задача прекрасно обходится Sonnet или Haiku. Если каждый переход между проектами требует ручной перенастройки и перезагрузки агента, разработчик начинает избегать смены модели — и берёт «универсальную» вместо оптимальной. Ключевые принципы настройки: * `CLAUDE.

md` в корне проекта — модель и контекст полностью изолированы на уровне репозитория Команда `/model` переключает модель на лету без перезапуска текущей сессии `settings.json` уровня проекта хранит профили агентов, разрешения и набор инструментов Локальные override-файлы разграничивают dev и prod конфигурации Переменные окружения позволяют управлять моделью через CI/CD без правки файлов конфигурации ## Почему скорость переключения меняет качество При Spec-Driven Development один проект последовательно использует несколько моделей на разных этапах. Для создания спецификации нужна мощная модель с сильным reasoning и развёрнутыми ответами.

Для реализации по готовому ТЗ достаточно быстрой и предсказуемой — меньше вероятность отклонения от задания. Для финального ревью снова нужен другой профиль. Если переключение занимает полминуты и требует ручных манипуляций, разработчик постепенно начинает избегать смены моделей.

Это ухудшает и скорость, и качество — особенно на этапе написания спецификации, где reasoning критичен.

«Мой подход к работе более комплексный, чем просто общение с AI», — Даниил Подольский, YADRO.

Серия продолжится. Следующие статьи затронут оркестрацию нескольких агентов параллельно, управление контекстом и структуру самих спецификаций.

Что это значит Spec-Driven Development постепенно оформляется в отдельную инженерную дисциплину.

Пока большинство разработчиков осваивают вайбкодинг, часть переходит к строгим методологиям: документация, спецификация, агент, верификация. Разбор настройки Claude Code от архитектора из YADRO — один из первых системных русскоязычных материалов на эту тему. Следить за циклом стоит и тем, кто пока работает с AI-инструментами интуитивно.