Pular para o conteúdo principal

Seu primeiro fluxo de IA

Este é o ciclo que transforma uma ideia, registrada pelo celular enquanto você toma um café, em uma PR implementada na nuvem e pronta para revisão quando você volta ao computador.

Seeds → Planning (Ideate) → Implement → Validate → Document

Vamos percorrê-lo com um exemplo real.


A história

Javi está revisando seu app logo cedo. Ele percebe que o dashboard demora demais para carregar e que falta um botão de exportar na tela de relatórios. Está em movimento, sem o computador aberto.

Ele diz ao assistente, conectado ao MCP do Almirant:

"Crie uma seed para otimizar o carregamento do dashboard e outra para adicionar a exportação de relatórios."

As seeds ficam registradas. Quando ele iniciar a sessão de planejamento, a IA as terá em contexto.


Passo 1: Capturar Seeds

Uma seed é a unidade mínima de intenção. Ela não precisa ser perfeita, precisa existir.

Pelo celular, com seu assistente conectado ao MCP:

"Crie uma seed para que o dashboard carregue mais rápido"
"Crie uma seed para adicionar exportação na tela de relatórios"

Pelo app web: Acesse a seção Seeds do projeto e crie uma nova diretamente.

Pelo Claude Code no seu terminal:

> /seed "Otimizar o carregamento do dashboard — lazy loading e índices de banco de dados"

As seeds se acumulam. Você não precisa planejar agora: registre e siga em frente.

Registre no momento

O valor de uma seed está em registrá-la quando o contexto ainda está fresco. Vaga ou concreta, o importante é que exista. A IA cuida dos detalhes durante o planning.

Consulte Seeds: a unidade mínima de intenção para entender quando uma seed está pronta para planning.


Passo 2: Planejar com Ideate

Quando tem seeds acumuladas, você abre uma sessão de Ideate, a skill de planejamento do Almirant.

No Claude Code:

> /ideate

A IA começa sabendo o que existe no seu board, quais seeds estão pendentes e qual é o contexto técnico do projeto. A partir daí:

1. Agrupa e classifica

A IA pode ver que você tem cinco seeds, mas que elas representam, na verdade, três problemas diferentes. Ela avisa você e evita duplicar trabalho.

2. Brainstorming se a seed for ambígua

Se "otimizar o dashboard" puder significar várias coisas, a IA fará perguntas de esclarecimento ou proporá alternativas. Você decide.

3. Pesquisa técnica se estiver bem definida

Se a seed for concreta, a IA vai direto ao codebase: analisa quais arquivos serão afetados, quais padrões o projeto usa e qual abordagem faz mais sentido.

4. Propõe a estrutura de tarefas

Ela apresenta uma proposta de work items com:

  • Título e descrição
  • Definition of done concreta
  • Arquivos que serão alterados
  • Considerações técnicas relevantes

5. Cria as tarefas com sua aprovação

Você dá o aval. As tarefas são criadas no board, rastreáveis até a seed original.

No nosso exemplo, a IA poderia agrupar as duas seeds em uma Feature de "Melhorias de desempenho e usabilidade do dashboard", com três Tasks: índices no banco de dados, lazy loading de componentes e o botão de exportação.

Consulte A sessão de planejamento (Ideate) para ver as fases em detalhes.


Passo 3: Implementar

Você tem duas maneiras de implementar:

Opção A: Local (com seu terminal)

Abra o Claude Code no repositório e inicie a implementação de uma tarefa:

> /implement A-T-42

A IA lê a tarefa do board, com todo o contexto, analisa o codebase e escreve o código. O work item passa para "In Progress" enquanto ela trabalha e para "Review" quando termina.

Você permanece presente durante a execução.

Opção B: OnCloud (sem você estar presente) ⭐

Inicie a implementação na nuvem e desconecte-se. O agente trabalha em um ambiente remoto, sem depender de seu terminal estar aberto.

> /runner-implement A-T-42

Você escolhe o provedor (Claude, Codex, Gemini), inicia a tarefa e ela é executada na nuvem. Quando termina, a PR está pronta para revisão.

Javi faz assim: inicia as implementações antes de ir à academia. Quando volta, revisa como cada uma foi.

Você também pode iniciar pelo celular, usando seu assistente:

"Inicie a implementação na nuvem da tarefa A-T-42 com Claude"

Consulte Execução na nuvem (OnCloud) para ver os provedores disponíveis e como configurá-los.


Passo 4: Validar

Antes do merge, Validate verifica se a implementação cumpre a especificação original da tarefa, não apenas se o código compila, mas se faz o que prometia.

Local:

> /validate A-T-42

Na nuvem:

> /runner-validate A-T-42

A IA compara o resultado com os critérios de aceitação definidos no planning. Se algo não estiver certo, ela informa. Se tudo estiver correto, move o item.

Javi tem um processo automatizado noturno: todas as tarefas em Review são validadas automaticamente e marcadas como concluídas se forem aprovadas. Ele não precisa fazer nada.


Passo 5: Documentar

Depois da validação, Document gera a documentação das mudanças: o que foi implementado, quais arquivos foram alterados e quais decisões foram tomadas.

> /document A-T-42

Ou na nuvem:

> /runner-document A-T-42

O ciclo completo de um dia

MomentoO que Javi fazComo
Manhã, revisando o appRegistra ideias como seedsPelo celular, com seu assistente
Reunião com o co-founder"Então precisamos fazer isso: crie uma seed"Assistente conectado ao MCP
Sessão de trabalhoIdeate: transforma seeds em tarefasClaude Code no terminal
Antes de sairRunner-implement: inicia implementaçõesNuvem, sem estar presente
Ao voltarRevisa PRs e To-dosApp web ou celular
À noiteValidate automáticoProcesso configurado no Almirant

Requisitos

Próximos passos