Что это такое
DEV-AGENT — это запуск Goose-агента «с идентичностью разработчика». Это не ЧЕЛОВЕК: программа. Она выполняет работу, описанную в спеке (ТЗ): читает код, вносит изменения и отчитывается о результате.
Простая аналогия: DEV-AGENT — это разработчик, который получает
одобренное ТЗ и «делает работу». Человек при этом в цикле остаётся: он одобрил спеку (ТЗ)
и проверяет результаты шагов.
В рамках чего запускается
DEV-AGENT запускает workflow на каждом шаге разработки — после того, как спека (ТЗ) одобрена. У workflow есть список шагов; каждый шаг — отдельный запуск DEV-AGENT с собственным промптом:
# workflows.py — список шагов (сейчас демонстрационные)
steps = [
Step(step_name="step-1-intro", job_name="dev-agent", ...),
Step(step_name="step-2-followup", job_name="dev-agent", ...),
]
for step in steps:
результат = запустить_шаг(step) # DEV-AGENT выполняет шаг
проверить_результат(результат) # Gate: PASS → дальше, иначе стоп- Запускается как одноразовая Nomad-задача (job
dev-agent) — стартовал, отработал, умер. - Каждый запуск получает свой промпт — тело спеки (ТЗ) + текст конкретного шага.
- Workflow «спит», пока агент работает, и просыпается по сигналу
agent_done.
Что он получает на вход
| Вход | Откуда | Что это |
|---|---|---|
| спеку (ТЗ) | workflow → activity | одобренное техническое задание — что нужно сделать |
| base_sha | поле спеки | от какой версии кода отталкиваться |
| снимок репозитория | Nomad prestart (fetch-repo) | код ровно на этом коммите |
| промпт шага | workflow | что именно сделать в этом конкретном шаге |
Что он делает и отдаёт
- Получает тело спеки (ТЗ) и снимок кода на
base_sha. - Выполняет работу шага (пишет код, правит файлы).
- Если шаг пишет в репозиторий — push изменений и создание merge request.
- В результат кладёт свой вывод (output) и, если есть,
commit_sha. - Завершается и шлёт workflow сигнал
agent_done; результат сохраняется как артефакт.
Права доступа: DEV-AGENT пишет в репозиторий. Перед запуском
workflow выпускает временный deploy-ключ; после шага ключ всегда отзывается, даже если шаг упал.
Такой ключ живёт ровно один шаг и никогда не попадает внутрь контейнера агента.
Связи
Вход
одобренная спека (ТЗ), base_sha, снимок кода, промпт шага.
Выход
вывод агента; при записи — push ветки и MR.
Перед
спеку (ТЗ) написал SPEC-AGENT и одобрил ЧЕЛОВЕК.
Дальше
проверка результата на Gate, шаг за шагом.