@luanpdd/kit-mcp 1.20.0 → 1.21.0

package/kit/framework/templates/research-project/PITFALLS.md

@@ -1,200 +1,200 @@
-# Template de Pesquisa de Armadilhas
-
-Template para `.planning/research/PITFALLS.md` — erros comuns a evitar no domínio do projeto.
-
-<template>
-
-```markdown
-# Pesquisa de Armadilhas
-
-**Domínio:** [tipo de domínio]
-**Pesquisado:** [data]
-**Confiança:** [HIGH/MEDIUM/LOW]
-
-## Armadilhas Críticas
-
-### Armadilha 1: [Nome]
-
-**O que dá errado:**
-[Descrição do modo de falha]
-
-**Por que acontece:**
-[Causa raiz — por que desenvolvedores cometem este erro]
-
-**Como evitar:**
-[Estratégia específica de prevenção]
-
-**Sinais de alerta:**
-[Como detectar isso cedo antes que se torne um problema]
-
-**Fase para abordar:**
-[Qual fase do roadmap deve prevenir isto]
-
----
-
-### Armadilha 2: [Nome]
-
-**O que dá errado:**
-[Descrição do modo de falha]
-
-**Por que acontece:**
-[Causa raiz — por que desenvolvedores cometem este erro]
-
-**Como evitar:**
-[Estratégia específica de prevenção]
-
-**Sinais de alerta:**
-[Como detectar isso cedo antes que se torne um problema]
-
-**Fase para abordar:**
-[Qual fase do roadmap deve prevenir isto]
-
----
-
-### Armadilha 3: [Nome]
-
-**O que dá errado:**
-[Descrição do modo de falha]
-
-**Por que acontece:**
-[Causa raiz — por que desenvolvedores cometem este erro]
-
-**Como evitar:**
-[Estratégia específica de prevenção]
-
-**Sinais de alerta:**
-[Como detectar isso cedo antes que se torne um problema]
-
-**Fase para abordar:**
-[Qual fase do roadmap deve prevenir isto]
-
----
-
-[Continue para todas as armadilhas críticas...]
-
-## Padrões de Dívida Técnica
-
-Atalhos que parecem razoáveis mas criam problemas a longo prazo.
-
-| Atalho | Benefício Imediato | Custo a Longo Prazo | Quando É Aceitável |
-|--------|--------------------|---------------------|--------------------|
-| [atalho] | [benefício] | [custo] | [condições, ou "nunca"] |
-| [atalho] | [benefício] | [custo] | [condições, ou "nunca"] |
-| [atalho] | [benefício] | [custo] | [condições, ou "nunca"] |
-
-## Armadilhas de Integração
-
-Erros comuns ao conectar a serviços externos.
-
-| Integração | Erro Comum | Abordagem Correta |
-|------------|------------|-------------------|
-| [serviço] | [o que as pessoas fazem errado] | [o que fazer em vez disso] |
-| [serviço] | [o que as pessoas fazem errado] | [o que fazer em vez disso] |
-| [serviço] | [o que as pessoas fazem errado] | [o que fazer em vez disso] |
-
-## Armadilhas de Performance
-
-Padrões que funcionam em pequena escala mas falham com o crescimento do uso.
-
-| Armadilha | Sintomas | Prevenção | Quando Quebra |
-|-----------|----------|-----------|---------------|
-| [armadilha] | [como perceber] | [como evitar] | [limite de escala] |
-| [armadilha] | [como perceber] | [como evitar] | [limite de escala] |
-| [armadilha] | [como perceber] | [como evitar] | [limite de escala] |
-
-## Erros de Segurança
-
-Problemas de segurança específicos do domínio além da segurança web geral.
-
-| Erro | Risco | Prevenção |
-|------|-------|-----------|
-| [erro] | [o que poderia acontecer] | [como evitar] |
-| [erro] | [o que poderia acontecer] | [como evitar] |
-| [erro] | [o que poderia acontecer] | [como evitar] |
-
-## Armadilhas de UX
-
-Erros comuns de experiência do usuário neste domínio.
-
-| Armadilha | Impacto no Usuário | Melhor Abordagem |
-|-----------|-------------------|------------------|
-| [armadilha] | [como os usuários sofrem] | [o que fazer em vez disso] |
-| [armadilha] | [como os usuários sofrem] | [o que fazer em vez disso] |
-| [armadilha] | [como os usuários sofrem] | [o que fazer em vez disso] |
-
-## Checklist "Parece Pronto Mas Não Está"
-
-Coisas que parecem completas mas estão faltando peças críticas.
-
-- [ ] **[Funcionalidade]:** Frequentemente falta [coisa] — verificar [checagem]
-- [ ] **[Funcionalidade]:** Frequentemente falta [coisa] — verificar [checagem]
-- [ ] **[Funcionalidade]:** Frequentemente falta [coisa] — verificar [checagem]
-- [ ] **[Funcionalidade]:** Frequentemente falta [coisa] — verificar [checagem]
-
-## Estratégias de Recuperação
-
-Quando armadilhas ocorrem apesar da prevenção, como se recuperar.
-
-| Armadilha | Custo de Recuperação | Passos de Recuperação |
-|-----------|----------------------|----------------------|
-| [armadilha] | LOW/MEDIUM/HIGH | [o que fazer] |
-| [armadilha] | LOW/MEDIUM/HIGH | [o que fazer] |
-| [armadilha] | LOW/MEDIUM/HIGH | [o que fazer] |
-
-## Mapeamento de Armadilhas por Fase
-
-Como as fases do roadmap devem abordar estas armadilhas.
-
-| Armadilha | Fase de Prevenção | Verificação |
-|-----------|-------------------|-------------|
-| [armadilha] | Fase [X] | [como verificar se a prevenção funcionou] |
-| [armadilha] | Fase [X] | [como verificar se a prevenção funcionou] |
-| [armadilha] | Fase [X] | [como verificar se a prevenção funcionou] |
-
-## Fontes
-
-- [Post-mortems referenciados]
-- [Discussões da comunidade]
-- [Documentação oficial de "armadilhas"]
-- [Experiência pessoal / problemas conhecidos]
-
----
-*Pesquisa de armadilhas para: [domínio]*
-*Pesquisado: [data]*
-```
-
-</template>
-
-<guidelines>
-
-**Armadilhas Críticas:**
-- Foque em problemas específicos do domínio, não em erros genéricos
-- Inclua sinais de alerta — detecção precoce evita desastres
-- Vincule a fases específicas — torna as armadilhas acionáveis
-
-**Dívida Técnica:**
-- Seja realista — alguns atalhos são aceitáveis
-- Indique quando atalhos são "nunca aceitáveis" vs. "apenas no MVP"
-- Inclua o custo a longo prazo para informar decisões de trade-off
-
-**Armadilhas de Performance:**
-- Inclua limites de escala ("quebra com 10k usuários")
-- Foque no que é relevante para a escala esperada deste projeto
-- Não super-otimize para escala hipotética
-
-**Erros de Segurança:**
-- Além das básicas do OWASP — problemas específicos do domínio
-- Exemplo: Plataformas comunitárias têm preocupações de segurança diferentes de e-commerce
-- Inclua nível de risco para priorizar
-
-**"Parece Pronto Mas Não Está":**
-- Formato de checklist para verificação durante a execução
-- Comum em demos vs. produção
-- Previne problemas de "funciona na minha máquina"
-
-**Mapeamento de Armadilhas por Fase:**
-- Crítico para a criação do roadmap
-- Cada armadilha deve mapear para uma fase que a previne
-- Informa o ordenamento de fases e critérios de sucesso
-
-</guidelines>
+# Template de Pesquisa de Armadilhas
+
+Template para `.planning/research/PITFALLS.md` — erros comuns a evitar no domínio do projeto.
+
+<template>
+
+```markdown
+# Pesquisa de Armadilhas
+
+**Domínio:** [tipo de domínio]
+**Pesquisado:** [data]
+**Confiança:** [HIGH/MEDIUM/LOW]
+
+## Armadilhas Críticas
+
+### Armadilha 1: [Nome]
+
+**O que dá errado:**
+[Descrição do modo de falha]
+
+**Por que acontece:**
+[Causa raiz — por que desenvolvedores cometem este erro]
+
+**Como evitar:**
+[Estratégia específica de prevenção]
+
+**Sinais de alerta:**
+[Como detectar isso cedo antes que se torne um problema]
+
+**Fase para abordar:**
+[Qual fase do roadmap deve prevenir isto]
+
+---
+
+### Armadilha 2: [Nome]
+
+**O que dá errado:**
+[Descrição do modo de falha]
+
+**Por que acontece:**
+[Causa raiz — por que desenvolvedores cometem este erro]
+
+**Como evitar:**
+[Estratégia específica de prevenção]
+
+**Sinais de alerta:**
+[Como detectar isso cedo antes que se torne um problema]
+
+**Fase para abordar:**
+[Qual fase do roadmap deve prevenir isto]
+
+---
+
+### Armadilha 3: [Nome]
+
+**O que dá errado:**
+[Descrição do modo de falha]
+
+**Por que acontece:**
+[Causa raiz — por que desenvolvedores cometem este erro]
+
+**Como evitar:**
+[Estratégia específica de prevenção]
+
+**Sinais de alerta:**
+[Como detectar isso cedo antes que se torne um problema]
+
+**Fase para abordar:**
+[Qual fase do roadmap deve prevenir isto]
+
+---
+
+[Continue para todas as armadilhas críticas...]
+
+## Padrões de Dívida Técnica
+
+Atalhos que parecem razoáveis mas criam problemas a longo prazo.
+
+| Atalho | Benefício Imediato | Custo a Longo Prazo | Quando É Aceitável |
+|--------|--------------------|---------------------|--------------------|
+| [atalho] | [benefício] | [custo] | [condições, ou "nunca"] |
+| [atalho] | [benefício] | [custo] | [condições, ou "nunca"] |
+| [atalho] | [benefício] | [custo] | [condições, ou "nunca"] |
+
+## Armadilhas de Integração
+
+Erros comuns ao conectar a serviços externos.
+
+| Integração | Erro Comum | Abordagem Correta |
+|------------|------------|-------------------|
+| [serviço] | [o que as pessoas fazem errado] | [o que fazer em vez disso] |
+| [serviço] | [o que as pessoas fazem errado] | [o que fazer em vez disso] |
+| [serviço] | [o que as pessoas fazem errado] | [o que fazer em vez disso] |
+
+## Armadilhas de Performance
+
+Padrões que funcionam em pequena escala mas falham com o crescimento do uso.
+
+| Armadilha | Sintomas | Prevenção | Quando Quebra |
+|-----------|----------|-----------|---------------|
+| [armadilha] | [como perceber] | [como evitar] | [limite de escala] |
+| [armadilha] | [como perceber] | [como evitar] | [limite de escala] |
+| [armadilha] | [como perceber] | [como evitar] | [limite de escala] |
+
+## Erros de Segurança
+
+Problemas de segurança específicos do domínio além da segurança web geral.
+
+| Erro | Risco | Prevenção |
+|------|-------|-----------|
+| [erro] | [o que poderia acontecer] | [como evitar] |
+| [erro] | [o que poderia acontecer] | [como evitar] |
+| [erro] | [o que poderia acontecer] | [como evitar] |
+
+## Armadilhas de UX
+
+Erros comuns de experiência do usuário neste domínio.
+
+| Armadilha | Impacto no Usuário | Melhor Abordagem |
+|-----------|-------------------|------------------|
+| [armadilha] | [como os usuários sofrem] | [o que fazer em vez disso] |
+| [armadilha] | [como os usuários sofrem] | [o que fazer em vez disso] |
+| [armadilha] | [como os usuários sofrem] | [o que fazer em vez disso] |
+
+## Checklist "Parece Pronto Mas Não Está"
+
+Coisas que parecem completas mas estão faltando peças críticas.
+
+- [ ] **[Funcionalidade]:** Frequentemente falta [coisa] — verificar [checagem]
+- [ ] **[Funcionalidade]:** Frequentemente falta [coisa] — verificar [checagem]
+- [ ] **[Funcionalidade]:** Frequentemente falta [coisa] — verificar [checagem]
+- [ ] **[Funcionalidade]:** Frequentemente falta [coisa] — verificar [checagem]
+
+## Estratégias de Recuperação
+
+Quando armadilhas ocorrem apesar da prevenção, como se recuperar.
+
+| Armadilha | Custo de Recuperação | Passos de Recuperação |
+|-----------|----------------------|----------------------|
+| [armadilha] | LOW/MEDIUM/HIGH | [o que fazer] |
+| [armadilha] | LOW/MEDIUM/HIGH | [o que fazer] |
+| [armadilha] | LOW/MEDIUM/HIGH | [o que fazer] |
+
+## Mapeamento de Armadilhas por Fase
+
+Como as fases do roadmap devem abordar estas armadilhas.
+
+| Armadilha | Fase de Prevenção | Verificação |
+|-----------|-------------------|-------------|
+| [armadilha] | Fase [X] | [como verificar se a prevenção funcionou] |
+| [armadilha] | Fase [X] | [como verificar se a prevenção funcionou] |
+| [armadilha] | Fase [X] | [como verificar se a prevenção funcionou] |
+
+## Fontes
+
+- [Post-mortems referenciados]
+- [Discussões da comunidade]
+- [Documentação oficial de "armadilhas"]
+- [Experiência pessoal / problemas conhecidos]
+
+---
+*Pesquisa de armadilhas para: [domínio]*
+*Pesquisado: [data]*
+```
+
+</template>
+
+<guidelines>
+
+**Armadilhas Críticas:**
+- Foque em problemas específicos do domínio, não em erros genéricos
+- Inclua sinais de alerta — detecção precoce evita desastres
+- Vincule a fases específicas — torna as armadilhas acionáveis
+
+**Dívida Técnica:**
+- Seja realista — alguns atalhos são aceitáveis
+- Indique quando atalhos são "nunca aceitáveis" vs. "apenas no MVP"
+- Inclua o custo a longo prazo para informar decisões de trade-off
+
+**Armadilhas de Performance:**
+- Inclua limites de escala ("quebra com 10k usuários")
+- Foque no que é relevante para a escala esperada deste projeto
+- Não super-otimize para escala hipotética
+
+**Erros de Segurança:**
+- Além das básicas do OWASP — problemas específicos do domínio
+- Exemplo: Plataformas comunitárias têm preocupações de segurança diferentes de e-commerce
+- Inclua nível de risco para priorizar
+
+**"Parece Pronto Mas Não Está":**
+- Formato de checklist para verificação durante a execução
+- Comum em demos vs. produção
+- Previne problemas de "funciona na minha máquina"
+
+**Mapeamento de Armadilhas por Fase:**
+- Crítico para a criação do roadmap
+- Cada armadilha deve mapear para uma fase que a previne
+- Informa o ordenamento de fases e critérios de sucesso
+
+</guidelines>

package/kit/framework/templates/research-project/STACK.md

@@ -1,120 +1,120 @@
-# Template de Pesquisa de Stack
-
-Template para `.planning/research/STACK.md` — tecnologias recomendadas para o domínio do projeto.
-
-<template>
-
-```markdown
-# Pesquisa de Stack
-
-**Domínio:** [tipo de domínio]
-**Pesquisado:** [data]
-**Confiança:** [HIGH/MEDIUM/LOW]
-
-## Stack Recomendado
-
-### Tecnologias Core
-
-| Tecnologia | Versão | Propósito | Por Que Recomendada |
-|------------|--------|-----------|---------------------|
-| [nome] | [versão] | [o que faz] | [por que especialistas usam para este domínio] |
-| [nome] | [versão] | [o que faz] | [por que especialistas usam para este domínio] |
-| [nome] | [versão] | [o que faz] | [por que especialistas usam para este domínio] |
-
-### Bibliotecas de Suporte
-
-| Biblioteca | Versão | Propósito | Quando Usar |
-|------------|--------|-----------|-------------|
-| [nome] | [versão] | [o que faz] | [caso de uso específico] |
-| [nome] | [versão] | [o que faz] | [caso de uso específico] |
-| [nome] | [versão] | [o que faz] | [caso de uso específico] |
-
-### Ferramentas de Desenvolvimento
-
-| Ferramenta | Propósito | Notas |
-|------------|-----------|-------|
-| [nome] | [o que faz] | [dicas de configuração] |
-| [nome] | [o que faz] | [dicas de configuração] |
-
-## Instalação
-
-```bash
-# Core
-npm install [pacotes]
-
-# Suporte
-npm install [pacotes]
-
-# Dependências de desenvolvimento
-npm install -D [pacotes]
-```
-
-## Alternativas Consideradas
-
-| Recomendado | Alternativa | Quando Usar a Alternativa |
-|-------------|-------------|---------------------------|
-| [nossa escolha] | [outra opção] | [condições onde a alternativa é melhor] |
-| [nossa escolha] | [outra opção] | [condições onde a alternativa é melhor] |
-
-## O Que NÃO Usar
-
-| Evitar | Por Que | Usar Em Vez Disso |
-|--------|---------|-------------------|
-| [tecnologia] | [problema específico] | [alternativa recomendada] |
-| [tecnologia] | [problema específico] | [alternativa recomendada] |
-
-## Variantes de Stack por Condição
-
-**Se [condição]:**
-- Usar [variação]
-- Porque [razão]
-
-**Se [condição]:**
-- Usar [variação]
-- Porque [razão]
-
-## Compatibilidade de Versões
-
-| Pacote A | Compatível Com | Notas |
-|----------|----------------|-------|
-| [pacote@versão] | [pacote@versão] | [notas de compatibilidade] |
-
-## Fontes
-
-- [ID de biblioteca Context7] — [tópicos pesquisados]
-- [URL de documentação oficial] — [o que foi verificado]
-- [Outra fonte] — [nível de confiança]
-
----
-*Pesquisa de stack para: [domínio]*
-*Pesquisado: [data]*
-```
-
-</template>
-
-<guidelines>
-
-**Tecnologias Core:**
-- Inclua números de versão específicos
-- Explique por que esta é a escolha padrão, não apenas o que faz
-- Foque em tecnologias que afetam decisões de arquitetura
-
-**Bibliotecas de Suporte:**
-- Inclua bibliotecas comumente necessárias para este domínio
-- Indique quando cada uma é necessária (nem todos os projetos precisam de todas)
-
-**Alternativas:**
-- Não apenas dispense alternativas
-- Explique quando as alternativas fazem sentido
-- Ajuda o usuário a tomar decisões informadas caso discorde
-
-**O Que NÃO Usar:**
-- Alerte ativamente contra escolhas desatualizadas ou problemáticas
-- Explique o problema específico, não apenas "é antigo"
-- Forneça a alternativa recomendada
-
-**Compatibilidade de Versões:**
-- Anote problemas conhecidos de compatibilidade
-- Crítico para evitar tempo de depuração mais tarde
-
-</guidelines>
+# Template de Pesquisa de Stack
+
+Template para `.planning/research/STACK.md` — tecnologias recomendadas para o domínio do projeto.
+
+<template>
+
+```markdown
+# Pesquisa de Stack
+
+**Domínio:** [tipo de domínio]
+**Pesquisado:** [data]
+**Confiança:** [HIGH/MEDIUM/LOW]
+
+## Stack Recomendado
+
+### Tecnologias Core
+
+| Tecnologia | Versão | Propósito | Por Que Recomendada |
+|------------|--------|-----------|---------------------|
+| [nome] | [versão] | [o que faz] | [por que especialistas usam para este domínio] |
+| [nome] | [versão] | [o que faz] | [por que especialistas usam para este domínio] |
+| [nome] | [versão] | [o que faz] | [por que especialistas usam para este domínio] |
+
+### Bibliotecas de Suporte
+
+| Biblioteca | Versão | Propósito | Quando Usar |
+|------------|--------|-----------|-------------|
+| [nome] | [versão] | [o que faz] | [caso de uso específico] |
+| [nome] | [versão] | [o que faz] | [caso de uso específico] |
+| [nome] | [versão] | [o que faz] | [caso de uso específico] |
+
+### Ferramentas de Desenvolvimento
+
+| Ferramenta | Propósito | Notas |
+|------------|-----------|-------|
+| [nome] | [o que faz] | [dicas de configuração] |
+| [nome] | [o que faz] | [dicas de configuração] |
+
+## Instalação
+
+```bash
+# Core
+npm install [pacotes]
+
+# Suporte
+npm install [pacotes]
+
+# Dependências de desenvolvimento
+npm install -D [pacotes]
+```
+
+## Alternativas Consideradas
+
+| Recomendado | Alternativa | Quando Usar a Alternativa |
+|-------------|-------------|---------------------------|
+| [nossa escolha] | [outra opção] | [condições onde a alternativa é melhor] |
+| [nossa escolha] | [outra opção] | [condições onde a alternativa é melhor] |
+
+## O Que NÃO Usar
+
+| Evitar | Por Que | Usar Em Vez Disso |
+|--------|---------|-------------------|
+| [tecnologia] | [problema específico] | [alternativa recomendada] |
+| [tecnologia] | [problema específico] | [alternativa recomendada] |
+
+## Variantes de Stack por Condição
+
+**Se [condição]:**
+- Usar [variação]
+- Porque [razão]
+
+**Se [condição]:**
+- Usar [variação]
+- Porque [razão]
+
+## Compatibilidade de Versões
+
+| Pacote A | Compatível Com | Notas |
+|----------|----------------|-------|
+| [pacote@versão] | [pacote@versão] | [notas de compatibilidade] |
+
+## Fontes
+
+- [ID de biblioteca Context7] — [tópicos pesquisados]
+- [URL de documentação oficial] — [o que foi verificado]
+- [Outra fonte] — [nível de confiança]
+
+---
+*Pesquisa de stack para: [domínio]*
+*Pesquisado: [data]*
+```
+
+</template>
+
+<guidelines>
+
+**Tecnologias Core:**
+- Inclua números de versão específicos
+- Explique por que esta é a escolha padrão, não apenas o que faz
+- Foque em tecnologias que afetam decisões de arquitetura
+
+**Bibliotecas de Suporte:**
+- Inclua bibliotecas comumente necessárias para este domínio
+- Indique quando cada uma é necessária (nem todos os projetos precisam de todas)
+
+**Alternativas:**
+- Não apenas dispense alternativas
+- Explique quando as alternativas fazem sentido
+- Ajuda o usuário a tomar decisões informadas caso discorde
+
+**O Que NÃO Usar:**
+- Alerte ativamente contra escolhas desatualizadas ou problemáticas
+- Explique o problema específico, não apenas "é antigo"
+- Forneça a alternativa recomendada
+
+**Compatibilidade de Versões:**
+- Anote problemas conhecidos de compatibilidade
+- Crítico para evitar tempo de depuração mais tarde
+
+</guidelines>