O ciclo completo de trabalho
O Almirant organiza o trabalho em cinco fases. Cada uma tem sua ferramenta e seu momento. O objetivo é que você passe de uma ideia em movimento a uma feature implementada e documentada sem atritos.
Seeds → Ideate → Implement → Validate → Document
Visão geral
Cada fase pode ser executada localmente, com seu terminal disponível, ou na nuvem, sem você estar presente. O OnCloud separa sua presença da execução.
As cinco fases
1. Seeds: capturar a intenção
O que é: a unidade mínima de intenção. Uma ideia, uma melhoria, um problema. Ela não precisa estar bem definida, precisa existir.
Quando usar: quando você identifica algo para melhorar, em reuniões ou em movimento. Registre agora, planeje depois.
Como criar:
- Pelo celular, com seu assistente conectado ao MCP
- Pelo Claude Code:
/seed "descrição" - Pelo app web, na seção Seeds do projeto
Resultado: um registro da intenção vinculado ao projeto, preservando o contexto do momento em que surgiu.
→ Seeds: a unidade mínima de intenção
2. Ideate: planejar com IA
O que é: a sessão de planejamento em que a IA transforma seeds em tarefas bem definidas.
Quando usar: quando você tem seeds acumuladas e tempo para uma sessão de planning.
Como iniciar:
> /ideate
O que a IA faz:
- Revisa o board, incluindo o que está em progresso e bloqueado
- Lê as seeds pendentes
- Agrupa as que são variações do mesmo problema
- Se a seed for ambígua → faz perguntas de esclarecimento ou brainstorming
- Se a seed for concreta → realiza pesquisa técnica (arquivos, padrões, abordagem)
- Propõe tarefas com definition of done, arquivos relevantes e considerações técnicas
- Com sua aprovação → cria as tarefas no board
Resultado: tarefas no board, prontas para implementação, rastreáveis até a seed que as originou.
→ A sessão de planejamento (Ideate)
3. Implement: executar o trabalho
O que é: o agente implementa a tarefa a partir de sua especificação.
Quando usar: quando uma tarefa está no backlog e pronta para implementação.
Duas maneiras de fazer:
Local (você está presente):
> /implement A-T-42
O agente trabalha no seu terminal. O work item passa para "In Progress" e depois para "Review".
OnCloud (sem você estar presente):
> /runner-implement A-T-42
O agente trabalha em um ambiente remoto. Você inicia e se desconecta. Quando termina, a PR está pronta.
Resultado: código implementado, PR gerada e work item em Review.
4. Validate: verificar se está bem feito
O que é: o agente verifica se a implementação cumpre os critérios de aceitação definidos no planning.
Quando usar: quando uma tarefa está em Review e você quer verificar antes do merge.
Como iniciar:
> /validate A-T-42 # local
> /runner-validate A-T-42 # na nuvem
A IA compara o resultado com a definition of done original, não com sua própria interpretação. Se algo não estiver certo, ela informa em detalhes.
Automação noturna: você pode configurar um processo automático que valide todas as tarefas em Review durante a noite e as marque como Done se forem aprovadas. Javi usa isso para chegar de manhã com o board atualizado.
Resultado: tarefa verificada, pronta para merge ou com feedback concreto sobre o que falta.
5. Document: documentar as mudanças
O que é: o agente gera documentação sobre o que foi implementado.
Quando usar: após a validação, para manter a documentação do projeto atualizada.
Como iniciar:
> /document A-T-42 # local
> /runner-document A-T-42 # na nuvem
Resultado: documentação das mudanças, decisões tomadas e arquivos afetados.
O contexto em cada fase
O que faz esse ciclo funcionar é que o contexto não se perde entre as fases:
| Fase | Qual contexto está disponível |
|---|---|
| Seeds | São criadas com o contexto do momento em que a ideia surgiu |
| Ideate | Vê as seeds, o board completo e o codebase |
| Implement | Lê a tarefa com toda a especificação (from Ideate) |
| Validate | Compara com os critérios definidos no Ideate |
| Document | Conhece a tarefa original e o que foi implementado |
Cada agente começa com o mapa completo. Não começa do zero.
Local vs. OnCloud
Todas as fases de execução (Implement, Validate, Document) têm uma versão local e uma versão na nuvem:
| Local | OnCloud | |
|---|---|---|
| Quando | Você está diante do computador | Você quer se desconectar |
| Skill | /implement, /validate, /document | /runner-implement, /runner-validate, /runner-document |
| Resultado | No seu terminal em tempo real | A PR/o resultado espera por você quando voltar |
| Provedores | O configurado no seu IDE | Claude, Codex, Gemini (configurável) |