Workflows

Workflow — последовательность агентов с gates (точками контроля). Каждый шаг может пройти, провалиться, или потребовать повтора.

Встроенные workflows

Workflow	Шаги	Когда использовать
dev	read → plan → code → review → test → commit	Полный цикл разработки
hotfix	read → code → test → commit	Быстрый фикс без ревью плана
review	read → review	Только ревью кода
test	read → test	Только тесты

/workflow:dev — полный pipeline

Slash-command /workflow:dev — мульти-агентный оркестратор с 11 шагами:

PREFLIGHT → READ → PLAN → PLAN_REVIEW
→ CODER → REVIEW×3 → fix loop
→ TEST → VERIFY → COMMIT

Quality gates

Gate	Шаг	Что проверяет
Plan review	PLAN_REVIEW	Полнота, архитектура, риски (9 критериев)
Code review	REVIEW×3	Security, quality, coverage (параллельно)
Tests	TEST	build + lint + tests (обязательно)
Verification	VERIFY	Соответствие исходной задаче

Режимы

/workflow:dev "задача"                  # interactive — спрашивает перед коммитом
/workflow:dev "задача" --auto-commit    # autonomous — для swarm

Phase mode

Если передать файл фазы — pipeline переключается в phase mode:

/workflow:dev .dev-vault/phases/phase-1-foundation.md

Plan создаётся для всей фазы, затем каждая подзадача проходит отдельный CODER→REVIEW→TEST цикл. Один коммит на всю фазу.

CLI workflows

dev-workflow run управляет directive-моделью reducer'а, а не запускает агентов. CLI:

печатает каждую директиву, которую эмитит reducer (dispatch, run_commands, user_approve, …);
выполняет только shell-free gate-команды (run_commands) — без shell, по allowlist;
останавливается на первой директиве, требующей агента или пользователя (dispatch / parallel_dispatch / user_approve), сохраняя её в pendingDirective.

Полное выполнение pipeline (запуск агентов) — это путь /workflow:dev в Claude Code через MCP workflow_step. dev-workflow resume переиздаёт сохранённую pendingDirective идемпотентно и продолжает цикл.

dev-workflow run dev "задача" --dry-run    # превью шагов (без запуска)
dev-workflow run dev "задача"              # прогон directive-цикла до первого агента
dev-workflow resume --run <id>             # переиздать pendingDirective и продолжить
dev-workflow validate workflow.yaml        # валидация кастомного

Кастомные workflows

Создать .dev-vault/workflows/custom.yaml:

name: custom
description: Custom workflow
steps:
  - name: read
    agent: reader
  - name: code
    agent: coder
    gate: tests-pass
  - name: commit
    agent: committer

Workflows

On this page