AgentFlow

Visão Geral

AgentFlow transforma seu quadro Kanban existente em um pipeline de desenvolvimento de IA totalmente autônomo. Em vez de construir infraestrutura de orquestração personalizada, ele trata sua ferramenta de gerenciamento de projetos (Asana, GitHub Projects, Linear) como uma máquina de estados distribuída — tarefas se movem por estágios, agentes de IA leem e escrevem o estado através de comentários, e humanos intervêm através da mesma interface que já utilizam.

O resultado é visibilidade completa do pipeline a partir do seu celular, estado de tarefa recuperável (o estado vive na sua ferramenta de gerenciamento de projetos, não na memória) e substituição humana a qualquer momento arrastando um cartão.

Quando Usar Esta Habilidade

• Use quando precisar orquestrar múltiplos workers Claude Code através de um ciclo de desenvolvimento completo (construir, revisar, testar, integrar).
• Use quando quiser portões de qualidade determinísticos (tsc/eslint/testes) antes da revisão por IA em código gerado por IA.
• Use quando quiser visibilidade completa do pipeline a partir do seu quadro Kanban ou celular.
• Use ao executar um projeto solo ou em equipe que precise de despacho autônomo de tarefas com rastreamento de custos.
• Use quando precisar de orquestração projetada para se recuperar após reinícios de sessão.

Conceitos Principais

Pipeline Kanban de 7 Estágios

Tarefas fluem por: Backlog, Pesquisa, Construir, Revisar, Testar, Integrar, Concluído. Cada estágio tem portões específicos. O quadro Kanban É a camada de orquestração — sem banco de dados separado, sem fila de mensagens, sem infraestrutura personalizada.

Orquestrador Sem Estado

Uma varredura única acionada por crontab roda a cada 15 minutos. Sem daemon, sem dependência de sessão. Se falhar, a próxima varredura continua de onde parou porque todo o estado vive na sua ferramenta de gerenciamento de projetos.

Determinístico Antes de Probabilístico

Portões rígidos (tsc + eslint + testes) rodam antes de qualquer revisão por IA, capturando erros detectáveis antes da revisão mais cara; cobertura e custo devem ser medidos. A revisão por IA vem depois, como uma segunda camada.

Revisão Adversária

Uma revisão independente deve relatar apenas achados comprovados e cobertura incompleta. Não exija um número arbitrário de falhas ou invente problemas para passar por um portão.

Despacho de Prioridade Transitiva

Tarefas que desbloqueiam o trabalho mais downstream são construídas primeiro, computando automaticamente o caminho crítico.

Pré-requisitos e autorização

Esta árvore AAS contém apenas o guia. Comandos de barra, script cron, tempo de execução do worker, integração do quadro e modelos nomeados abaixo pertencem à instalação upstream revisada separadamente; não afirme que eles existem localmente. Verifique primeiro uma revisão upstream fixa, licença, esquemas e configuração. A criação de tarefas/comentários no quadro, o acionamento de workers, a configuração de agendamentos, chamadas de modelo pagas, mesclagem e publicação exigem a autorização aplicável do usuário. Preserve os arquivos de host existentes e use os portões do mantenedor do repositório atual.

Para workers concorrentes, exija reivindicações de tarefa atômicas ou leases, propriedade de escrita disjunta, concorrência limitada e SHAs de artefatos verificados. Um heartbeat obsoleto não prova que um worker parou; evite trabalhos pagos duplicados ou gravações antes da reatribuição.

Habilidades / Comandos

/spec-to-board

Decompõe um SPEC.md em tarefas atômicas no seu quadro Kanban com dependências mapeadas.

/sdlc-orchestrate

Despacha tarefas para workers com base na prioridade transitiva e detecção de conflitos. Roda como uma varredura crontab.

/sdlc-worker --slot <N>

Roda um worker em um slot de terminal que pega tarefas, constrói código e cria PRs. Execute 3-4 workers em paralelo.

/sdlc-health

Painel de status do pipeline em tempo real mostrando o estágio atual, agente atribuído, contagem de retentativas e custo acumulado para cada tarefa.

/sdlc-stop

Desligamento gracioso: workers ativos terminam sua tarefa atual, tarefas não iniciadas retornam ao Backlog.

Guia Passo a Passo

1. Escreva Sua Especificação

Crie um SPEC.md para seu projeto descrevendo o que você deseja construir.

2. Decomponha em Tarefas

claude -p "/spec-to-board"

Isso lê seu SPEC.md, o decompõe em tarefas atômicas, mapeia dependências e as cria no seu quadro Kanban.

3. Inicie os Workers

Abra 3-4 janelas de terminal, cada uma como um slot de worker:

# Terminal 2 — Builder
claude -p "/sdlc-worker --slot T2"

# Terminal 3 — Builder
claude -p "/sdlc-worker --slot T3"

# Terminal 4 — Reviewer
claude -p "/sdlc-worker --slot T4"

# Terminal 5 — Tester
claude -p "/sdlc-worker --slot T5"

4. Inicie o Orquestrador

# Add to crontab (runs every 15 minutes)
crontab -e
# Add: */15 * * * * ~/.claude/sdlc/agentflow-cron.sh >> /path/to/private/agentflow-orchestrate.log 2>&1

5. Monitore e Intervenha

…