Мульти-агентный pipeline от задачи до коммита — 11 шагов с quality gates

/workflow:dev

Главная команда. Оркестрирует 11-шаговый pipeline от задачи до коммита.

/workflow:dev "добавить валидацию email"
/workflow:dev .dev-vault/phases/phase-1-foundation.md
/workflow:dev "задача" --auto-commit

11 шагов

#	Шаг	Агент	Что делает
0	PREFLIGHT	bash	Baseline: git status, build, tests
1	READ	Explore	Сбор контекста из кодовой базы
2	PLAN	Explore	Детальный план с pseudo-code и архитектурным анализом
3	PLAN_REVIEW	Explore	9 критериев; verdict-aware gate (NEEDS_REVISION → fail)
4	PLAN_FIX	Full	Хирургические правки плана по PLAN_REMARKS (Next: plan-fix); no-op если APPROVED
5	CODER	Full	Реализация (test-first)
6	REVIEW×3	Explore×3	Параллельно: security, quality, coverage
7	fix loop	Full+Explore	CODER↔REVIEW до 3 итераций
8	TEST	bash	build + lint + tests
9	VERIFY	Explore	Соответствие исходной задаче
10	COMMIT	Full	git add + commit

Режимы

Interactive (default)

Спрашивает перед коммитом. При провале gate — спрашивает: продолжить или остановить.

Autonomous (`--auto-commit`)

Для использования в swarm. Коммитит автоматически. При провале gate — останавливается без коммита, stash-ит изменения.

Phase mode

При передаче файла фазы — планирует всю фазу, кодит каждую подзадачу отдельно:

READ → PLAN (full phase) → PLAN_REVIEW
→ for each subtask:
    CODER → REVIEW×3 → fix → TEST
→ VERIFY → COMMIT (один коммит)

Engineering principles

Все агенты получают shared PRINCIPLES block:

Single Responsibility, Dependency Rule, explicit dependencies
Fail fast, every error path tested, no silent swallowing
No TODO/FIXME, no debug logging, no hardcoded config
Max 300 lines/file, 30 lines/function
Test behaviour, not implementation

PLAN: архитектурный анализ

Planner обязан включить в план:

Layer — в каком слое сидит изменение
Boundaries — что вызывает, кто вызывает
Dependencies — с направлением стрелок
Error boundaries — где может сломаться
Pseudo-code — конкретный код для каждого изменения

REVIEW×3: параллельные специалисты

Reviewer	Фокус
Security	OWASP, injection, secrets, auth, validation
Quality	SRP, layers, conventions, DRY, dead code, architecture
Coverage	Все тесты написаны? edge cases? error paths?

Каждый получает реальный git diff, а не самоотчёт coder-а.

Plan persistence

После утверждения плана (PLAN_REVIEW APPROVED) — полный план сохраняется в vault:

Phase mode: .dev-vault/phases/<phase-file>.plan.md (рядом с файлом фазы)
Normal mode: .dev-vault/plans/<date>-<slug>.plan.md

Зачем: resume при обрыве сессии, аудит план vs реализация, context recovery.

Архитектура: step-файлы

Оркестратор (dev.md, ~14 строк — thin shim) не содержит инструкции для каждого шага. Перед каждым шагом он читает step-файл через Read tool — свежие сфокусированные инструкции.

.claude/commands/workflow/
  dev.md               ← оркестратор (~14 строк, thin shim)
  steps/
    principles.md      ← engineering principles (inlined в plan, coder, review)
    preflight.md       ← Step 0: baseline + phase task creation
    read.md            ← Step 1: context gathering
    plan.md            ← Step 2: architecture + pseudo-code
    plan-review.md     ← Step 3: 9 criteria + verdict-aware gate
    plan-fix.md        ← Step 4: surgical edits to plan (Next: plan-fix)
    coder.md           ← Step 5: test-first + fix mode
    review.md          ← Step 6: 3 parallel reviewers
    test.md            ← Step 8: build/lint/test gate
    verify.md          ← Step 9: task compliance
    commit.md          ← Step 10: interactive/autonomous
    vault-updates.md   ← Step 10b: daily log, status

Зачем: один 960-строчный промпт терял инструкции из начала к середине. Step-файлы дают свежий контекст на каждом шаге.

CODER: test-first

Пишет тесты (из секции Tests плана)
Запускает — проверяет что тесты ПАДАЮТ
Пишет реализацию
Запускает — проверяет что тесты ПРОХОДЯТ

/workflow:graph

Рендерит workflow в Mermaid DAG прямо в чате. Удобно для визуальной проверки pipeline до запуска.

/workflow:graph dev

Альтернативы для CLI:

ASCII (терминал): dev-workflow workflow graph dev --ascii
Полные тела step-файлов: dev-workflow workflow show dev --bodies
Разрешённый pipeline (после custom-first routing): dev-workflow workflow effective dev

/workflow:dev

On this page