Agent Flow
Uma coluna de cards do It’s a Plan executada sozinha, um card por vez, cada um na própria worktree.
O Agent Flow percorre uma coluna de cards do It’s a Plan sem você precisar começar cada um. Cada card ganha a própria worktree e os próprios agentes, e o próximo card só começa depois que o PR ou MR do anterior é aceito.
Criar um flow
Abra Agent Flow na barra lateral, logo abaixo de Automations, e clique em New flow.
| Campo | O que é |
|---|---|
| Name | Nome do flow. |
| Repository | O repositório onde as worktrees serão criadas. |
| Agent | O agente principal de cada card. |
| It’s a Plan project e Queue column | De onde vêm os cards, normalmente a coluna Todo. |
| Only cards with label | Opcional: só cards com uma etiqueta. |
| Only cards assigned to … | Opcional: só cards do dono da chave de API. |
| Agent prompt | O prompt do agente principal. Padrão: /implement {{identifier}} {{url}}. |
| Side terminal prompt | O prompt do segundo agente, aberto ao lado. Padrão: /relay rev. |
| Coordinator check, Coordinator agent e Coordinator model | A checagem do coordenador antes de cada card. |
Os agentes principal e lateral podem ser qualquer agente habilitado no Dusky. O coordenador pode ser qualquer agente que aceite uma pergunta única, sem sessão interativa.
Como um card anda
Fila
O flow pega os cards da coluna escolhida em ordem crescente de número, com os filtros de etiqueta e de responsável. Cards pai são pulados, porque o trabalho está nas subtarefas.
Bloqueios
Um card marcado como bloqueado por outro card ainda aberto é pulado. Se todos estiverem bloqueados, o flow pausa e mostra quem bloqueia quem.
Coordenador
Opcional e ligado por padrão. Um agente só de leitura responde uma vez, start ou pause, com o motivo. Ele procura dependências escritas nas descrições dos cards e leva em conta até 80 cards já concluídos.
Por padrão, usa o agente de IA do Source Control (o que escreve mensagens de commit); cada flow pode escolher outro agente e modelo. O Claude roda sem ferramentas e sem servidores MCP; o Codex roda numa sandbox só de leitura. Qualquer falha ou resposta fora do formato pausa o flow: ele nunca começa um card às cegas.
Início
Se já existe uma worktree para o card, o flow pausa em vez de criar outra. Senão, cria a worktree e a branch com o identificador em minúsculas (por exemplo, dsk-31), liga a issue, manda o prompt para o agente principal, abre o segundo agente numa divisão vertical e move o card para a primeira coluna de trabalho em andamento.
Fim
A cada 60 segundos, o flow confere o card e o PR ou MR, no GitHub ou no GitLab. Quem decide é o merge, não a coluna do card. Se o PR foi aceito e o card continua aberto, o flow move o card para Done, desde que o HEAD da worktree seja o mesmo do PR.
Antes de remover a worktree, o flow a coloca para dormir e confere o git. Arquivos alterados ou commits que não foram enviados pausam o flow, com uma exceção: um squash merge cujo topo é o do PR aceito. A worktree é removida sem forçar, e o flow segue para o próximo card.
O flow registra o que viu em cada checagem de espera, para explicar depois por que um card não andou.
Controles e estados
- Start, Pause, Resume e Stop. Parar mantém a worktree.
- Estados do flow: Running, Paused e Stopped. Estados do card: Starting, In progress e Removing worktree.
- O flow só roda com o Dusky aberto. Depois de reiniciar o app, um flow que estava rodando volta pausado.
- Se o It’s a Plan estiver fora do ar ou responder com erro 5xx, o flow tenta de novo a cada minuto. Outros erros pausam.
- Flows de projetos diferentes rodam em paralelo.
O Agent Flow não tem atalho de teclado.
Limitações
- Funciona com cards do It’s a Plan; o backlog nativo ainda não é fonte de cards.
- Só repositórios locais (Windows ou WSL); não funciona por SSH.