Pipeline

O Helm organiza o trabalho em 5 fases com 13 agentes (11 pipeline, 1 sob demanda, 1 orquestrador). Cada agente tem uma missão clara, entradas e saídas definidas, e limites de qualidade que devem ser atingidos antes de progredir.

Fases

Fase	Propósito	Agentes
Descoberta	Entender o problema	Scout/Survey, Research
Planejamento	Definir a solução	Planning, Architect, Roadmap, Breakdown
Qualidade	Validar o plano	Review (gate de 95%)
Construção	Implementar código	Build
Deploy	Testar e entregar	Verify (gate de 95%), Ship

Fluxo Greenfield

Para projetos novos começando do zero:

scout → research → planning → architect → roadmap → breakdown → review → build → verify → ship

Scout explora requisitos através de conversa — o que você está construindo, para quem e por quê?

Fluxo Brownfield

Para codebases existentes:

survey → research → planning → architect → roadmap → breakdown → review → build → verify → ship

Survey analisa o codebase primeiro — stack, arquitetura, integrações, dívida técnica — e então Research extrai o que precisa mudar.

Como os Agentes Passam o Bastão

Todo agente produz um documento de handoff armazenado em .helm/handoffs/{agente}.md. Os handoffs têm duas camadas:

Resumo (máx 150 linhas) — Missão completada, decisões-chave, artefatos, score de auto-validação
Contexto Profundo (opcional, máx 500 linhas) — Descobertas complexas que não cabem no resumo

O próximo agente lê o handoff antes de começar. Se o handoff estiver ausente ou incompleto, o orquestrador bloqueia a progressão.

Gates de Qualidade

Dois checkpoints críticos garantem qualidade:

Gate	Agente	Limite	O Que Valida
Gate do Plano	Review	95%	Rastreabilidade: Research → PRD → Fases → Tarefas → Critérios de Aceite
Gate do Build	Verify	95%	Testes passam, SAST limpo, código segue arquitetura, critérios de aceite atendidos

Veredictos

APPROVED (≥ 95%) — Prosseguir para próxima fase
NEEDS_REVISION (85–94%) — Problemas listados, enviado de volta ao agente responsável
BLOCKED (< 85%) — Lacunas críticas, reiniciar do agente falho

Dashboard de Status

Execute helm status para ver o progresso do pipeline:

  Helm v0.1.0

  Project:  my-api
  Type:     brownfield
  Phase:    build
  Profile:  guided

  Pipeline:
    [done]  survey       100%
    [done]  research     100%
    [done]  planning     100%
    [done]  architect    100%
    [done]  roadmap      100%
    [done]  breakdown    100%
    [done]  review       100%
    [>>  ]  build        in progress
    [    ]  verify       pending
    [    ]  ship         pending