Agentes

O Helm usa 13 agentes — 11 no pipeline, 1 sob demanda e 1 orquestrador — para guiar projetos da descoberta ao deploy. Cada agente tem uma missão definida, entradas, saídas e critérios de sucesso.

Referência Rápida

Fase de Descoberta

Scout (Greenfield)

Missão: Extrair visão, objetivos e restrições do projeto através de conversa guiada.

Scout é o primeiro agente para projetos novos. Faz perguntas estruturadas sobre o que você quer construir, quem são os usuários, quais restrições existem e como é o sucesso. Saída: documento de contexto operacional.

Survey (Brownfield)

Missão: Análise abrangente de um codebase existente — stack, arquitetura, integrações e dívida técnica.

Survey executa scans automatizados antes de fazer perguntas. Mapeia estrutura de pastas, identifica padrões, categoriza dívida por severidade e captura contexto operacional. Saída: relatório de survey com inventário de dívida.

Research

Missão: Extrair, analisar e documentar problemas centrais, resultados desejados e restrições.

Research é o agente de descoberta mais crítico. Guia você através de extração de brain dump, análise estruturada, identificação de lacunas e síntese. Todo agente downstream rastreia até o que Research captura. Saída: relatório de pesquisa.

Fase de Planejamento

Planning

Missão: Transformar descobertas da pesquisa em um Documento de Requisitos do Produto (PRD) formal.

Todo requisito tem um ID, descrição, prioridade MoSCoW, referência de pesquisa e critérios de aceite Given-When-Then. Saída: PRD com requisitos funcionais e não-funcionais.

Architect

Missão: Projetar a arquitetura técnica que atende os requisitos do PRD.

Define stack, componentes do sistema, modelo de dados, design de API, modelo de segurança e estratégia de deploy. Para projetos brownfield, avalia stack existente contra novos requisitos. Saída: documento de arquitetura.

Roadmap

Missão: Dividir requisitos do PRD em fases de desenvolvimento ordenadas.

Fase 1 é sempre o MVP. Mapeia dependências, define entregas por fase e cria ordem de execução. Saída: documento de fases.

Breakdown

Missão: Decompor fases em tarefas atômicas e testáveis.

Cada tarefa tem ID, título, descrição, referência de requisito, estimativa de tamanho (XS a L), dependências e critérios de aceite Given-When-Then. Nenhuma tarefa excede 4-8 horas. Saída: breakdown de tarefas.

Fase de Qualidade

Review (Gate do Plano)

Missão: Validar rastreabilidade em todos os artefatos de planejamento.

Verifica 4 cadeias: Research → PRD, PRD → Fases, Fases → Tarefas, Tarefas → Critérios de Aceite. Cada requisito órfão gera penalidade. Requer 95% para prosseguir ao Build. Saída: relatório de review com veredicto.

Verify (Gate do Build)

Missão: Validar implementação contra critérios de aceite.

Executa testes, scanning SAST, revisão de código contra padrões de arquitetura e verificação de critérios de aceite. Requer 95% para prosseguir ao Deploy. Saída: relatório de verificação com veredicto.

Fase de Construção

Build

Missão: Implementar cada tarefa do breakdown aprovado.

Trabalha nas tarefas em ordem de dependência. Auto-valida contra critérios de aceite. Pode operar em modo interativo (confirmar cada tarefa) ou autônomo (auto-prosseguir quando gates passam). Saída: código implementado + relatório de build.

Fase de Deploy

Ship

Missão: Cuidar de operações git, criação de PR e deployment.

Cria commits, faz push para remote, abre pull requests e gerencia deployment. Saída: resumo de deployment.

Sob Demanda

Tradeoff

Missão: Analisar decisões com múltiplas opções usando prós/contras estruturados.

Pode ser invocado a qualquer momento por qualquer agente ao enfrentar uma decisão com múltiplas abordagens viáveis. Após a análise, o controle retorna ao agente que invocou.