Documentação / O agente
Missões e fases
Cada trabalho grande é uma missão com um ciclo de vida de 8 fases, um plano de execução e um objetivo que nunca se perde.
Cada trabalho grande é uma missão. Ela é salva com o projeto e preserva o pedido original, os requisitos, os critérios de aceitação, as decisões, as premissas, o plano, os arquivos tocados e onde o trabalho parou.
Assim, o objetivo e o plano nunca se perdem, mesmo que a conversa cresça.
As 8 fases
| # | Fase | O que responde |
|---|---|---|
| 1 | Análise | O que exatamente está sendo pedido? O que falta saber? |
| 2 | Design | Como resolver? Quais decisões são tomadas? |
| 3 | Planejamento | Em quais passos verificáveis se divide? |
| 4 | Implementação | Escrever o código, tocando apenas o necessário. |
| 5 | Medição | O código tocado é melhor que a versão anterior? |
| 6 | Testes | Compilar, testar e iniciar o aplicativo. |
| 7 | Revisão | Revisar o próprio diff como um revisor rigoroso. |
| 8 | Entrega | O que foi feito, o que foi verificado, as decisões e o que ficou pendente. |
A Medição compara o código tocado com a versão anterior (N−1) e devolve o trabalho para Implementação até que ele seja melhor. Ela não pode ser pulada. Veja Medição contra N−1.
As fases acompanham o trabalho
- Cada novo pedido começa em Análise.
- A fase avança conforme o que o agente faz, não apenas conforme o que ele declara: ler e buscar é Análise, editar é Implementação, executar testes é Testes.
- Só avança. Ler um arquivo enquanto você implementa continua sendo implementar.
- Funciona da mesma forma com o agente do Yuli, Claude Code, Kiro, Codex e Antigravity.
A barra da missão
Aparece acima do chat, sob as abas de conversa.
- As oito paradas, com as concluídas marcadas e a atual destacada.
- Fase n de 8 · Nome, desde quando e o que está fazendo.
- O Percurso da missão, com o tempo em cada fase.
- A medição atual, com o botão Ver em Qualidade.
Ao expandi-la, você verá:
| Seção | Conteúdo |
|---|---|
| Plano de execução | Os passos, Passo n de N, o tempo estimado e quem executa cada passo. |
| Requisitos | O que deve ser cumprido. |
| Critérios de aceitação | Como saber que está concluído. |
| Decisões recentes | O que foi decidido e por quê. |
| Autônomo | O interruptor do modo autônomo. |
Ações: Ver plano, Encerrar missão e Reabrir missão.
Remover um plano
O botão ✕ pergunta “O que faço com este plano?”:
- Cancelar plano: interrompe o plano; o histórico (
PLAN.md) é preservado. - Excluir: apaga o plano, o registro e a missão desta conversa.
- Manter: deixa como está.
O workboard
O workboard mostra ao vivo o que o agente e sua equipe fazem durante um turno.
- Estados: Analisando, Investigando, Editando, Verificando, Executando plano, Aguardando.
- Agentes: o Agente principal e cada Subagente.
- Ver o trabalho completo abre “Trabalho do turno” com as abas Linha do tempo, Agentes, Plano e Equipe.
No Modo assinatura, o plano do seu agente (por exemplo, a lista de tarefas do Claude Code) é refletido no workboard do Yuli.
Sem interrupções por limite de rodadas
Se um turno esgota suas rodadas, o agente deixa um ponto de transição e o turno seguinte continua a partir dali. Em PLAN.md, ele aparece como “Onde o trabalho parou”. O contexto é mantido enxuto com resumos incrementais.
Onde é salvo
.ai/missions/<conversa>/
├── mission.json a missão completa
└── PLAN.md o plano legível
Há uma missão por conversa. Veja A pasta .ai.
Documentação do SDLC
Ferramentas → Documentação do ciclo de vida (SDLC)… gera a documentação do ciclo de desenvolvimento do projeto.