Documenta decisões técnicas no formato Contexto → Ação → Resultado → Aprendizado → Ferramentas IA. Use ao registrar ADRs, escolhas de arquitetura, trade-offs de MVP, escolha de bibliotecas, algoritmos, estratégia de testes ou quando o usuário pedir documentação de decisão, retrospectiva técnica ou histórico de decisões.
Use este formato para cada decisão técnica importante (escopo, estado, algoritmos, testes, stack, padrões de código). O objetivo é deixar rastreável por que algo foi feito, o que foi feito, o efeito e o que aprender para a próxima vez, incluindo como a IA ajudou. Decisões sobre organização de src/ ou padrões Next/Tailwind devem estar alinhadas a .cursor/rules/next-frontend.mdc / tailwind-styles.mdc quando aplicável.
Copie e preencha (títulos em português do projeto):
### [Título da Decisão]
**Contexto:** [Situação que levou à necessidade da decisão]
**Ação:** [O que foi decidido e implementado]
**Resultado:** [Impacto da decisão, métricas, feedback]
**Aprendizado:** [Insights, trade-offs, melhorias para próxima vez]
**Ferramentas IA:** [Como IA ajudou, prompts usados, adaptações manuais]
Para entradas completas no mesmo estilo do projeto World Cup Simulator, veja examples.md.