Planejamento com IA (Ideate)
O planejamento é onde a maioria dos projetos falha, não na execução. E o problema não é a falta de ideias, mas a falta de questionamento. As equipes começam a construir sem validar premissas, sem desafiar o escopo e sem identificar riscos evidentes.
O AI Planning no Almirant não é uma ferramenta que gera work items. É um sparring partner que desafia você antes que escreva uma única linha de código.
Por que um sparring partner, e não um gerador
A diferença é fundamental:
- Um gerador recebe seu input e produz output. Você diz "quero autenticação" e ele fornece 15 tasks.
- Um sparring partner questiona seu input. Ele pergunta por que você precisa de autenticação, quais alternativas considerou e onde estão os riscos.
O resultado não é apenas uma lista de itens: é um escopo validado e premissas questionadas.
De uma ideia vaga a um escopo validado em uma única sessão. Epics, stories e tasks gerados automaticamente com definições de conclusão.
Planning Sessions
As sessões de planejamento são conversas multi-turno com a IA. Não se trata de um único prompt: é um diálogo iterativo em que a IA:
- Desafia premissas: questiona decisões que você considera certas.
- Identifica riscos: aponta pontos cegos no seu planejamento.
- Propõe alternativas: sugere abordagens que você não havia considerado.
- Refina o escopo: ajuda a delimitar o que entra e o que fica de fora.
Estados de uma sessão
Cada sessão passa por diferentes fases:
| Fase | Descrição |
|---|---|
idle | Aguardando você iniciar a conversa |
chatting | Trocando mensagens com a IA |
streaming | Recebendo a resposta em tempo real |
thinking | A IA processa e raciocina (modo thinking ativo) |
reviewing | Revisando itens sugeridos para aceitar ou rejeitar |
completed | Sessão finalizada |
paused | Sessão pausada para continuar mais tarde |
Histórico de sessões
Suas sessões são salvas automaticamente e podem ser acessadas depois:
- Ativa: sessão em andamento; você pode continuar o diálogo.
- Concluída: sessão encerrada com itens criados.
- Arquivada: sessão salva para referência futura.
Cada sessão registra os tokens usados (totalInputTokens, totalOutputTokens), o custo estimado e a duração, para que você possa otimizar o uso da cota.
Seeds de ideação
Antes de iniciar o diálogo de planejamento, você pode selecionar seeds: ideias anteriores registradas no Almirant que servem de ponto de partida. As seeds fornecem contexto inicial à sessão:
- Notas de brainstorming salvas.
- Ideias de sessões anteriores.
- Requisitos registrados em conversas com stakeholders.
Fluxo de trabalho
- Selecione seeds (opcional): escolha ideias anteriores para fornecer contexto inicial.
- Inicie a sessão: descreva o que quer alcançar, mas espere questionamentos.
- Dialogue com a IA: responda a perguntas, defenda decisões e reconsidere premissas.
- Revise a proposta: quando o escopo estiver claro, a IA gera work items estruturados.
- Aceite ou rejeite itens: selecione os que se aplicam e descarte os demais.
- Itens criados no board: os itens aceitos são criados automaticamente no board ativo.
A IA começa revisando o que está em andamento e em review. Ela evita propor trabalho já concluído ou que entre em conflito com o que alguém está implementando neste momento.
A conversa é bidirecional, mas sua primeira mensagem importa:
Bons pontos de partida
| Prompt | Por que funciona |
|---|---|
| "Quero adicionar autenticação social, mas não sei se vale o esforço em comparação com magic links" | Convida a IA a comparar alternativas |
| "Preciso melhorar o desempenho da lista de produtos; os usuários reclamam de lentidão" | Define o problema real, não a solução presumida |
| "Precisamos migrar de REST para GraphQL; a equipe diz que é melhor, mas não estou convencido" | Abre espaço para questionar a decisão |
Evite
| Prompt | Problema |
|---|---|
| "Gere tasks para autenticação" | Fecha o espaço para diálogo e pede output direto |
| "Faça um CRUD de usuários" | Não há um problema a resolver, apenas mecânica |
| "Melhore todo o sistema" | Sem foco, é impossível questionar |
Modos de resposta
A IA pode operar em diferentes modos:
- Streaming: você vê a resposta enquanto ela é gerada, ideal para iteração rápida.
- Thinking: a IA raciocina passo a passo antes de responder, melhor para problemas complexos.
Você pode alternar entre os modos conforme a complexidade do que está discutindo.
"Você está falando de 5 coisas, mas na verdade são 3 problemas. Para a otimização do dashboard, há três causas possíveis: queries sem índice, rendering excessivo ou payload grande. Você tem alguma pista? Caso contrário, posso propor investigar as três."
Quando a IA gera sua proposta de work items, você vê uma lista organizada por tipo:
Com a intenção clara, a IA analisa o codebase:
- Quais arquivos são relevantes para esta seed.
- Como algo semelhante foi resolvido no projeto, incluindo padrões e convenções existentes.
- Qual approach técnico faz mais sentido considerando o contexto atual.
- Quais dependências ou riscos precisam ser considerados.
Cada item inclui título, descrição e hierarquia proposta. Você pode:
- Aceitar itens individuais.
- Rejeitar itens que não se apliquem.
- Aceitar todos se a proposta completa convencer você.
Pré-requisitos
- Um provedor de IA configurado com uma API key válida.
- Cota disponível na sua organização.
- Um projeto com pelo menos um board ativo.
Para desenvolvedores: ferramentas MCP
As seguintes tools estão disponíveis via MCP:
| Tool | Descrição | Parâmetros principais |
|---|---|---|
record_ai_session | Registra uma sessão de planejamento | projectId, prompt, response, tokensUsed |
get_ai_sessions | Histórico das sessões de planejamento | projectId, limit |
Exemplo: registrar uma sessão do Ideate
Tool: record_ai_session
Parâmetros:
projectId: "uuid-do-projeto"
prompt: "Seeds: otimizar dashboard, adicionar exportação de relatórios"
response: "Proposta: Feature com 3 Tasks — índice de banco de dados, lazy loading, botão de exportação"
tokensUsed: 2840