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.