Вход
Контекст задачи
- описание задачи
- требования и ограничения
- предпочтения по стеку
- примеры и критерии приемки
📄
Задание для агента
Один источник правды: что сделать, где границы, как понять, что задача завершена.
Выход
Понимание и план действий
Агент подтверждает задачу, фиксирует допущения и предлагает следующий шаг.
План должен включать
- ключевые этапы и задачи
- файлы и модули, которые будут изменены
- тест-план и критерии приемки
- риски, допущения и неизвестные
Роль человека
- утвердить план
- попросить изменить подход
- уточнить детали, если агент ушел не туда
После утверждения
Переходим к реализации. План становится картой для итераций, а не жесткой бюрократией.
Цикл повторяется
💻Пишет кодмаленький осмысленный шаг
🧪Запускает тестыunit, integration, e2e
📋Проверяет результатлоги, диффы, поведение
🛠Фиксит проблемыошибки, регрессии, стиль
После каждого шага агент дает короткий отчет: что сделано, что проверено, что дальше.
Ты
Контроль результата
- смотришь логи, диффы и тесты
- даешь обратную связь
- одобряешь или разворачиваешь шаг назад
Агент убеждается, что
- все тесты проходят
- код соответствует стилю проекта
- нет линтер-ошибок
- нет очевидных уязвимостей
- документация обновлена, если нужно
Дополнительно
- покрытие тестами в норме
- производительность приемлема
- обработка ошибок сделана на месте
На выходе
Качественный, готовый к обзору код.
🌿Создать PR / MR
⚙️Пройти CI / CD
👥Код-ревью
🔀Объединить в main
Агент помогает
- смотреть логи и метрики
- находить ошибки и узкие места
- собирать обратную связь
Следующий цикл
Планируются улучшения, фиксы и новые маленькие итерации.
Результат
Система становится лучше после каждого прохода.
🎯Четкая коммуникацияЯсные задачи и ожидания.
👣Маленькие шагиЛегче исправлять и понимать.
⚙️АвтоматизацияТесты, линтеры, CI/CD экономят время.
🛡️Доверяй, но проверяйАвтоматические тесты и ревью обязательны.
📚Контекст решаетРепозиторий, документация, примеры.
🔁ИтеративностьУчимся и улучшаем каждый цикл.
Коротко: весь цикл
1
Определи задание
2
Согласуй план
3
Реализуй итерациями
4
Проверь качество
5
Интегрируй через PR
6
Наблюдай и улучшай
∞
Повторяй цикл
Инструменты, которые помогают
🐙Git / GitHub / GitLabветки, PR, история
🔄CI/CDActions, GitLab CI
🧪Тестыunit, integration, e2e
✅ЛинтерыESLint, Prettier, Ruff
📄ДокументацияREADME, ADR
📈Мониторинглоги, метрики, алерты