Практики и правила
Правила работы с агентом, которые помогают делать стабильный и предсказуемый проект.
Одна задача — один цикл
Каждый промпт решает одну задачу. Гигантские «сделай всё сразу» дают гигантские поломки, в которых непонятно, что чинить.
План до кода
Требуйте у агента план изменений до правок. Дёшево поправить план до того, как 20 файлов уже «улучшены» не туда.
PRD живёт в docs/
PRD, технический дизайн, журнал решений — файлами в репозитории. Это контекст для любого будущего агента и страховка от «забыл, что мы делали».
Проверка после каждого шага
Агент закончил шаг — вы открыли приложение и проверили. Не копите 10 шагов «на потом».
Маленькие коммиты
Агент коммитит часто и по делу. Сломалось → откатили один коммит, а не разбирали неделю диффов.
Тесты на важное
Минимум: один тест на критичный путь (оплата, вход, сохранение). Автотест — не роскошь, а разрешение менять код без страха.
Фиксируйте решения
«Почему выбрали X, а не Y» записывайте сразу. Через месяц это сэкономит час переписки с агентом.
Защита с первого дня
Секреты в .env — с первого коммита, проверка прав — с первой авторизации. Добавлять защиту потом — дороже и сложнее.
⚑ Самый маленький контур проверки
Каждое изменение проходит цикл «сделал → запустил → проверил». Чем длиннее цепочка без проверки, тем больше времени уйдёт на поиск, что именно сломалось.
⚑ Правь маленькими шагами
Одна логическая правка за раз. Маленькие шаги — это не медленно, это обнаружимо: поломка локализуется в последнем шаге.
⚑ Не доверяй красивому коду
ИИ пишет код, который выглядит уверенно. Проверяется поведение: открыл, кликнул, посмотрел. Красивый код с багом — всё равно баг.
⚑ Фиксируй контекст
AGENTS.md, PRD, журнал решений. Проект без контекста — каждый следующий агент начинает с нуля и «гениально» ломает то, что работало.
⚑ Оставляй выходы
Частые коммиты, ветки для экспериментов, автотесты на критичное. Вайбкодинг без выходов — игра в русскую рулетку с проектом.
⚑ Требуй обоснований
Когда агент предлагает переписать модуль — спроси «зачем?». Переписка ради переписки и «улучшения» без метрики — главный источник поломок.