KauaLealz Product & technical planning
Quando aplicar (obrigatório mentalmente)
Use esta skill quando:
- Uma nova funcionalidade, épico ou produto for discutido.
- Houver decisão entre alternativas (stack, serviço, fila, modelo de dados, escopo MVP).
- For preciso alinhamento negócio ↔ engenharia antes de implementar.
- O usuário pedir roadmap, corte MVP, ADR, análise de impacto ou o que falta definir.
Instrução explícita ao usuário: em tomadas de decisão nesses contextos, o agente deve dizer que está a seguir o planejamento estruturado desta skill (uma frase no início ou no fim), para o usuário validar premissas.
Fluxo recomendado
- Clarificar a ideia em uma frase de outcome (o que muda para o utilizador ou sistema).
- Ler a codebase relevante: serviços, módulos, padrões existentes, contratos HTTP, persistência — usar grep/leitura em paralelo dos pontos de integração.
- Ler documentação do repo se existir:
docs/PLANEJAMENTO.md,docs/PLANEJAMENTO-TECNICO.md, ADRs, README — não contradizer decisões já registadas sem sinalizar. Diretrizes de implementação: skill engineering-dev-guidelines (conteúdo embutido). - Separar o que é MVP do que é pós-MVP (valor mínimo, risco, dependências externas).
- Listar decisões pendentes e o que seria ADR vs decisão oral.
- Propor 2–3 opções quando houver trade-off, com prós/contras curtos — recomendar uma default fundamentada na codebase.
- Saída: usar a estrutura em reference.md para o plano escrito.
Cruzamento negócio ↔ técnico
- Para cada requisito de negócio, indicar onde vive no sistema (serviço, módulo, fila, front) ou marcar gap (não existe ainda).
- Identificar riscos: integrações, dados sensíveis, performance, compliance.
- Se o produto for CV Automator, cruzar com §18 da skill engineering-dev-guidelines e
docs/PLANEJAMENTO-TECNICO.md(Kong, platform-api, integration-api, worker, Postgres/Mongo, SQS quando aplicável).
Depois do plano
- Ao passar à implementação, seguir a skill engineering-dev-guidelines.
- Se o plano exigir mudança estrutural grande, sugerir ADR ou atualização de
PLANEJAMENTO*.md.
Recursos
- reference.md — template do documento de plano.