Как разбить большую фичу для coding agent на рабочие этапы
Делите фичу по законченным проверяемым сценариям и зависимостям. Разбиение только на «сервер», «клиент» и «тесты» часто откладывает реальную проверку до самого конца.
Разберём рабочий случай
Нужно добавить экспорт отчётов с фильтрами. Агент пишет сразу очередь, хранение файлов, интерфейс и рассылку. Через несколько часов выясняется, что формат отчёта не согласован и клиент ожидает другие поля. Большая часть работы построена на непроверенном предположении. Первый этап мог быть гораздо меньше: сформировать один отчёт на фиксированных учебных данных и принять его содержимое.
Что изменить
Сначала зафиксируйте формат и пример файла. Затем проверьте экспорт по фильтру без фоновой обработки. После этого добавьте ограничение объёма, очередь при подтверждённой необходимости и понятный статус готовности. У каждого этапа должны быть вход, наблюдаемый результат и критерий остановки. Инфраструктурное разделение полезно внутри этапа, но не должно заменять проверку пользовательской ценности. Изменение требований после маленького принятого результата обходится дешевле.
Как проверить результат
| Проверка | Ожидаемое поведение |
|---|---|
| Первый этап без интерфейса и очереди | Полученный файл можно открыть и сравнить с заранее согласованным образцом по данным и структуре. |
| Фильтр по датам на втором этапе | Проверены границы периода и отсутствующие данные; форма файла не меняется случайно. |
| Добавление фоновой обработки | Старый функциональный пример продолжает проходить, появляется отдельная проверка статуса и повторного запроса. |
Завершённый этап должен оставлять артефакт проверки: образец файла, запрос или воспроизводящий сценарий. Один текстовый отчёт агента не позволяет следующему участнику независимо подтвердить сделанную часть большой задачи.
Некоторые изменения нельзя безопасно выпускать по частям без временных флагов или совместимых контрактов. Этап разработки не обязан быть отдельной публичной выкладкой; важно иметь способ его проверить.
Декомпозиция и управление длинной работой агента полезнее, когда опираются на конкретную приёмку каждого промежуточного результата. В платном курсе Vibecoding: Claude Code, Codex, Cursor и agentic development можно продолжить изучение соответствующего инженерного направления. Перед покупкой сравните программу и открытые материалы со своей задачей.
Документация для проверки технических деталей: Практики Claude Code.
Следующий шаг: AI-разработка: разборы ошибок, изменений и проверки кода. По смежным вопросам: Два coding agent в одном репозитории: как разделить работу, Какие логи можно давать coding agent для отладки.
