A sessão de planejamento (Ideate)
Ideate é a skill de planejamento do Almirant. Você pega as seeds que vem acumulando há algum tempo, abre uma sessão e a IA as transforma em tarefas tão bem definidas que tanto um agente quanto uma pessoa poderiam implementá-las.
Como iniciar
No Claude Code:
> /ideate
A IA começa com acesso ao board do projeto, às seeds pendentes e ao contexto técnico. Você não precisa explicar nada de novo.
Pelo assistente:
"Abra uma sessão de planning para o projeto X"
As fases de uma sessão
Fase 1: Analisar o estado do projeto
A IA começa revisando o board: o que está em progresso, em revisão e pendente. Isso evita propor coisas que já estão em andamento ou que entram em conflito com o trabalho existente.
Fase 2: Revisar as seeds
Ela lê as seeds pendentes uma a uma e avalia quanto contexto cada uma tem:
- Seeds claras e concretas → seguem diretamente para a pesquisa técnica
- Seeds ambíguas ou vagas → ativam o modo de esclarecimento
Fase 3: Esclarecimento (se necessário)
Para seeds vagas, a IA não inventa. Ela faz perguntas específicas ou propõe alternativas:
"Você está dizendo que o dashboard carrega lentamente. Há três causas possíveis: as queries no banco de dados, o número de componentes renderizados ao mesmo tempo ou o tamanho dos dados baixados. Você tem alguma pista de qual delas é? Caso contrário, posso propor tarefas para investigar cada uma."
Ela também pode detectar que várias seeds são, na verdade, o mesmo problema:
"Você tem três seeds sobre desempenho. Vou tratá-las como uma única Feature para não duplicar trabalho. Tudo bem?"
Fase 4: Pesquisa técnica
Com a intenção clara, a IA analisa o codebase:
- Quais arquivos são relevantes para essa seed
- Como algo semelhante está resolvido no projeto (padrões, convenções)
- Qual abordagem técnica faz mais sentido dado o contexto
- Quais dependências ou riscos precisam ser considerados
Fase 5: Proposta de tarefas
A IA apresenta sua proposta: uma ou mais tarefas com:
| Campo | O que inclui |
|---|---|
| Título | Claro e acionável |
| Descrição | O que precisa ser feito e por quê |
| Definition of done | Critérios concretos e verificáveis |
| Arquivos relevantes | Quais partes do codebase serão alteradas |
| Considerações técnicas | Decisões de abordagem, riscos e alternativas descartadas |
Fase 6: Sua aprovação
Você revisa a proposta. Pode:
- Aprová-la como está: as tarefas são criadas no board
- Pedir ajustes: "separe esta tarefa em duas" / "adicione o critério de aceitação X"
- Rejeitar alguma: se algo não se encaixar, nós descartamos
A IA mantém o contexto da conversa. Você pode iterar até que a proposta esteja boa.
Fase 7: Criação no board
Com sua aprovação, as tarefas são criadas automaticamente no board, vinculadas às seeds que as originaram. Elas ficam no backlog, prontas para implementação.
O que muda em relação a planejar "manualmente"
| Antes | Com Ideate |
|---|---|
| Criar tarefas uma a uma do zero | A IA propõe a estrutura completa |
| Pensar sozinho em quais arquivos são afetados | A IA analisa o codebase por você |
| Esquecer o contexto de uma ideia de três dias atrás | As seeds preservam o contexto original |
| Duplicar trabalho sem perceber | A IA detecta sobreposições entre seeds |
| Tasks com definição vaga | Tasks com definition of done concreta |
Exemplo de uma sessão real
> /ideate
[Ideate] Revisando o board do projeto "App de faturamento"...
→ 2 tarefas em In Progress, 1 em Review, 4 seeds pendentes
[Ideate] Seeds detectadas:
1. "Dashboard carrega lentamente" (há 2 dias)
2. "Adicionar exportação de relatórios" (ontem)
3. "Revisar permissões de admin" (hoje)
4. "Botão de arquivar na tela de faturas" (hoje)
[Ideate] As seeds 1 e 2 têm relação com a tela principal.
Vou analisá-las juntas como uma possível Feature.
[Ideate] Analisando o codebase para "Dashboard"...
→ Detectados: DashboardPage.tsx, reportService.ts, api/reports.ts
→ Sem índice em `reports.created_at` (provável causa da lentidão)
→ Exportação não implementada; faturas têm um precedente em exportInvoices.ts
[Ideate] Proposta:
Feature: Melhorias no dashboard e nos relatórios
├── Task: Adicionar índice em reports.created_at
│ DoD: query < 200ms com 1000 registros, migration incluída
│ Arquivos: migrations/, reportService.ts
│
├── Task: Lazy loading nos componentes do dashboard
│ DoD: LCP < 2.5s no Lighthouse, sem regressões visuais
│ Arquivos: DashboardPage.tsx, componentes/
│
└── Task: Botão de exportação em relatórios (CSV e PDF)
DoD: exporta corretamente com filtros ativos, mesmo padrão das faturas
Arquivos: reportService.ts, api/reports.ts, componentes/ExportButton.tsx (novo)
Você aprova estas três tarefas ou quer ajustar algo?