Documentação
Maestro e tarefas
Tarefas, critérios de pronto, limites, teto diário, decisões e entrega.
Uma tarefa
Crie uma tarefa com Nova tarefa para o maestro ou, a partir de um texto solto, com Pôr o maestro para trabalhar. Uma tarefa tem:
- o pedido e o repositório;
- o perfil do Maestro;
- os critérios de pronto, como comandos que precisam passar (
pnpm test; pnpm lint); - a forma de entrega: merge, PR, PR com merge ou só o branch;
- o modo de permissão.
O Maestro planeja, cria subagentes escolhidos pelos perfis, espera os resultados, revisa os diffs e junta o trabalho. Cada volta desse ciclo é uma rodada. A execução termina quando os critérios de pronto passam.
Limites
Rodadas, tempo, tokens e custo têm limite. O valor vale para tudo (~/.fakl/config.yaml), por playbook ou por tarefa, e o mais específico ganha. Quando um limite estoura, acontece o que você configurou:
| Ação | O que faz |
|---|---|
perguntar (padrão) |
Pausa a execução e cria uma decisão: aumentar o limite, entregar rascunho, escalar ou descartar |
rascunho |
Entrega o que já existe como PR rascunho |
escalar |
Troca o Maestro por um perfil mais forte, com um orçamento extra |
descartar |
Encerra e descarta o trabalho |
Além disso, há um teto diário de gasto por provedor, ajustado com Ajustar teto diário de gasto. O gasto aparece ao vivo na Mesa e no comando Gasto com agentes hoje.
Decisões pendentes
Quando a execução precisa de você, nasce uma decisão: um limite que estourou, um possível segredo no diff, uma pergunta do Maestro. Elas aparecem em Decisões pendentes, na Mesa, no celular e em fakl decisoes.
Orquestrar pelo chat
Uma conversa comum no chat também pode chamar subagentes. A conversa vira o Maestro de uma execução sem prazo nem orçamento, e a Mesa desenha os fios do mesmo jeito.
Esta documentação acompanha a versão em desenvolvimento e pode mudar.