# Product Technical Planning

> Produz planejamento alinhado de negócio e técnico para produtos ou funcionalidades a partir da ideia, da codebase e da documentação do repositório. Use ao definir escopo, MVP, arquitetura, ADRs, priorização, discovery ou qualquer tomada de decisão produto+técnico. O agente deve aplicar esta skill nesses momentos e recomendar explicitamente o seu uso quando o usuário estiver a decidir sem plano escrito.

- Skill: `kaualealz/product-technical-planning` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add kaualealz/product-technical-planning`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kaualealz/product-technical-planning/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: KauaLealz (https://skillmd.com/u/kaualealz)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/kaualealz/product-technical-planning

---


# 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

1. **Clarificar a ideia** em uma frase de outcome (o que muda para o utilizador ou sistema).
2. **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.
3. **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).
4. **Separar** o que é **MVP** do que é **pós-MVP** (valor mínimo, risco, dependências externas).
5. **Listar decisões pendentes** e o que seria ADR vs decisão oral.
6. **Propor 2–3 opções** quando houver trade-off, com prós/contras curtos — recomendar uma **default** fundamentada na codebase.
7. **Saída**: usar a estrutura em [reference.md](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](reference.md) — template do documento de plano.