specifica-br 1.2.2 → 1.5.0

package/dist/boilerplate/templates/codereview-template.md

@@ -0,0 +1,95 @@
+# Code Review - {{FEATURE_NAME}}
+
+## Metadados
+- **Escopo**: {{SCOPE_DESCRIPTION}}
+- **Data**: {{TIMESTAMP}}
+- **Contexto**: {{CONTEXT_DESCRIPTION}}
+- **Especificações**: {{SPECS_REFERENCE}}
+
+## Resumo
+| Severidade | Quantidade |
+|:---|---:|
+| CRITICAL | {{COUNT_CRITICAL}} |
+| HIGH | {{COUNT_HIGH}} |
+| MEDIUM | {{COUNT_MEDIUM}} |
+| LOW | {{COUNT_LOW}} |
+| **Total** | **{{COUNT_TOTAL}}** |
+
+## Findings Críticos (BLOCKER)
+
+{{FINDINGS_CRITICAL_SECTION}}
+
+{{IF_NO_CRITICAL_FINDINGS: *Nenhum finding crítico encontrado.* }}
+
+## Findings Alta Prioridade
+
+{{FINDINGS_HIGH_SECTION}}
+
+{{IF_NO_HIGH_FINDINGS: *Nenhum finding de alta prioridade encontrado.* }}
+
+## Demais Findings
+
+### Média Prioridade
+{{FINDINGS_MEDIUM_SECTION}}
+
+{{IF_NO_MEDIUM_FINDINGS: *Nenhum finding de média prioridade encontrado.* }}
+
+### Baixa Prioridade (Sugestões)
+{{FINDINGS_LOW_SECTION}}
+
+{{IF_NO_LOW_FINDINGS: *Nenhum finding de baixa prioridade encontrado.* }}
+
+## Pontos Positivos
+{{POSITIVE_POINTS_SECTION}}
+
+{{IF_NO_POSITIVE_POINTS: *Nenhum ponto positivo identificado.* }}
+
+## Veredito
+
+**Status**: {{VEREDICTO_STATUS}}
+
+**Justificativa**: 
+{{VEREDICTO_JUSTIFICATIVA}}
+
+**Pré-condições para merge**:
+{{PRE_CONDICOES_MERGE}}
+
+{{IF_NO_PRE_CONDITIONS: *Nenhuma pré-condição necessária.* }}
+
+**Recomendações gerais**:
+{{RECOMENDACOES_GERAIS}}
+
+{{IF_NO_RECOMMENDATIONS: *Nenhuma recomendação adicional.* }}
+
+---
+
+## Formato de Finding (Referência)
+
+Use este formato para cada finding:
+
+```markdown
+### [F-XXX] Título curto
+`arquivo.ext:linhas` | **SEVERIDADE** | Dimensão
+
+**Problema**: 1-2 frases sobre impacto e consequências
+
+**Código atual**:
+```linguagem
+// 3-6 linhas do código problemático
+```
+
+**Correção recomendada**:
+```linguagem
+// Código corrigido
+```
+*Por que*: Benefício principal em 1 frase
+
+**Alternativas**: 
+- Opção 2: breve descrição - quando usar
+- Opção 3: breve descrição - quando usar
+```
+
+---
+
+**Template Version:** 0.1.0
+**Generated by:** realizar-codereview.md v0.1.0

package/dist/boilerplate/templates/prd-template.md

@@ -0,0 +1,167 @@
+# PRODUCT REQUIREMENTS DOCUMENT (PRD)
+
+| Metadata | Details |
+| :--- | :--- |
+| **Status** | Draft |
+| **Data** | {{DATA_ATUAL}} |
+| **Feature** | [nome-da-funcionalidade] |
+ <!-- Status: DRAFT -> IN_PROGRESS -> IN_REVIEW -> APPROVED -->
+
+---
+
+## 1. Contexto e Problema
+<!--
+INSTRUÇÕES DE PREENCHIMENTO:
+- Problema: Descreva uma situação observável e mensurável
+- Causa Raiz: Hipótese do porquê o problema ocorre
+- Objetivo: Mudança concreta e observável após implementação
+-->
+
+**O Problema (Estado Atual):**
+    * [Situação observável e mensurável]
+
+**Causa Raiz (Hipótese):**
+    * [Por que o problema ocorre]
+
+**O Objetivo (Estado Futuro):**
+    * [Mudança observável após a feature]
+
+---
+
+## 2. Escopo
+
+### 2.1. O que Faremos (In-Scope)
+* [ ] Item de escopo 1
+
+### 2.2. O que NÃO Faremos (Out-of-Scope)
+* [ ] Funcionalidade futura X
+* [ ] Definições de arquitetura técnica (ex: Schema de Banco, Endpoints de API)
+
+** Regra de Escopo**: Qualquer item não listado explicitamente em "O que Faremos" deve ser considerado fora do escopo.
+
+ ### 2.3. Dependências de Sistema
+ | ID | Dependência | Tipo (Interna/Externa) | Crítico? | Observações |
+ |:---|:---|:---|:---|:---|
+ | DEP-001 | [Ex: API Pagamento] | Externa | Sim | [SLA: 99.9%, Timeout: 5s] |
+ | DEP-002 | [Ex: Módulo Usuários] | Interna | Não | [Versão >= 2.0] |
+<!--
+Regra: Liste apenas dependências que impactem diretamente esta feature.
+Se uma dependência for crítica, documente o plano de contingência.
+-->
+
+---
+
+ ## 3. Personas e User Stories
+ <!--
+ INSTRUÇÕES DE PREENCHIMENTO:
+ - Persona: Perfil de usuário que receberá o benefício
+ - Formato: "Como [persona], quero [ação], para [benefício]"
+ - Cada User Story DEVE resultar em >=1 Requisito Funcional
+ -->
+
+| [UserStoryID] | **[Persona]** | **[Ação]** (Quero...) | **[Benefício]** (Para...) |
+|:---|:---|:---|:---|
+| US-001 | Contador | Lançar débito automatizado | Reduzir erros manuais em 80% |
+| US-002 | Gerente | Aprovar débitos em lote | Agilizar fechamento mensal |
+
+**Regra**: Cada User Story deve resultar em pelo menos um Requisito Funcional.
+
+---
+
+## 4. Requisitos Funcionais e Regras de Negócio
+<!--
+INSTRUÇÕES DE PREENCHIMENTO:
+- Comportamento: Descrição detalhada e observável do comportamento esperado
+- Critério: Regra de negócio testável, mensurável e binária (passa/falha)
+- Fonte: User Story de origem (US-XXX)
+- Cenário de Teste: Formato Gherkin (Dado/Quando/Então)
+-->
+
+### 4.1. Regras Principais (Happy Path)
+* **[RF-001] Nome do Requisito:**
+    * **Comportamento:** [Descrição detalhada do comportamento esperado]
+    * **Critério de Sucesso:** [Regra de negócio testável e mensurável]
+    * **Fonte:** [US-001, US-002]
+    * **Cenário de Teste (Gherkin):**
+        - DADO que [precondição]
+        - QUANDO [ação do usuário]
+        - ENTÃO [resultado observável]
+
+### 4.2. Validações e Restrições
+* **[RF-003] Validação de Input:**
+    * O sistema deve rejeitar entradas que... [Descreva a regra claramente]
+    * **Cenário de Teste:**
+        - DADO que [input inválido]
+        - QUANDO [usuário submete]
+        - ENTÃO [erro específico retornado]
+
+---
+
+## 5. Fluxos de Exceção e Tratamento de Erros (Unhappy Path)
+<!--
+INSTRUÇÕES DE PREENCHIMENTO:
+- Cenário de Erro: Situação específica que pode falhar
+- Severidade: Crítica/Bloqueante | Alta | Média | Baixa
+- Comportamento: Como o sistema deve reagir (não código, comportamento)
+- Mensagem: O que o usuário vê (copywriting exato)
+-->
+
+| Cenário de Erro | Severidade | Comportamento do Sistema | Mensagem |
+| :--- | :--- | :--- | :--- |
+| **[Ex: Input Inválido]** | [Bloquear envio] | [Bloquear submissão e destacar campo] | ["O campo X é obrigatório"] |
+| **[Ex: API Falha]** | [Alta] | [Repetir 3x com backoff, então falhar gracefully] | ["Serviço temporariamente indisponível. Tente novamente em 5min."] |
+
+---
+
+## 6. Requisitos Não-Funcionais (Qualidade)
+<!--
+INSTRUÇÕES DE PREENCHIMENTO:
+- Liste APENAS requisitos não-funcionais que sejam críticos e testáveis
+- Use métricas específicas (ex: < 2s, > 99.9%, 1000 req/s)
+- Se não for crítico, não liste
+-->
+
+* **[RNF-001] Performance:** [Ex: O carregamento não deve exceder 2 segundos para 95% das requisições]
+* **[RNF-002] Disponibilidade:** [Ex: Sistema deve estar disponível 99.5% do tempo (SLA)]
+* **[RNF-003] Segurança:** [Ex: Dados sensíveis devem ser criptografados em repouso]
+
+**Regra:** Apenas Requisitos Não-Funcionais explicitamente listados aqui devem ser considerados.
+
+---
+
+## 7. Itens em Aberto e Dúvidas (TBD)
+<!--
+INSTRUÇÕES DE PREENCHIMENTO:
+- Use esta seção para decisões que ainda não foram tomadas
+- Classifique o impacto realisticamente (Alto pode bloquear desenvolvimento)
+- A feature não pode ser considerada DONE com TBDs de Alto impacto
+-->
+
+| ID | Questão / Dúvida | Quem deve responder? | Impacto | Ação Decisória |
+| :--- | :--- | :--- | :--- | :--- |
+| **[TBD-001]** | [Ex: Qual o texto final da mensagem de erro?] | [Marketing/Legal] | [Baixo - Copywriting] | [Definir até Q2] |
+| **[TBD-002]** | [Ex: Qual gateway de pagamento usar?] | [Arquitetura/Finanças] | [Alto - Bloqueia desenvolvimento] | [Decisão necessária antes do início] |
+
+---
+
+## 8. Critérios de Aceite (Definition of Done)
+<!--
+INSTRUÇÕES DE PREENCHIMENTO:
+- Esta seção define quando a feature está COMPLETA
+- Cada critério deve ser binário (passa ou falha)
+- Seja conservador: melhor ser mais restritivo aqui do que depois no development
+-->
+
+Para considerar esta feature concluída, o sistema deve:
+1. [ ] Cumprir todos os Requisitos Funcionais listados (seção 4).
+2. [ ] Tratar graciosamente todos os Fluxos de Exceção listados (seção 5).
+3. [ ] Não haver Itens em Aberto (TBD) com impacto "Alto" ou "Bloqueante" (seção 7).
+4. [ ] Todos os Requisitos Não-Funcionais (seção 6) foram atendidos e validados.
+ 5. [ ] Testes automatizados cobrem >= 80% dos cenários Happy Path e Unhappy Path.
+6. [ ] Documentação de usuário (se aplicável) está atualizada.
+
+**Regra de Ouro:** A feature só pode ser considerada DONE se todos os RF-XXX e RNF-XXX associados estiverem marcados como atendidos e validados.
+
+---
+
+**Template Version:** 0.0.5

package/dist/boilerplate/templates/product_vision-template.md

@@ -0,0 +1,284 @@
+# PRODUCT VISION
+
+| Metadata | Details |
+|:---|:---|
+| **Status** | DRAFT |
+| **Data** | {{DATA_ATUAL}} |
+| **Projeto** | {{NOME_PROJETO}} |
+<!-- Status: DRAFT to IN_PROGRESS to APPROVED -->
+
+---
+
+## 1. Declaração do Problema
+
+<!-- INSTRUÇÕES DE PREENCHIMENTO:
+OBJETIVO: Definir claramente o problema de negócio que o software resolve
+REGRA CRÍTICA: ZERO menções a tecnologia, bancos de dados, APIs ou implementação
+FORMATO: Situação observável e mensurável
+-->
+
+**Problema Central:**
+* [Descreva o problema de negócio em termos observáveis]
+
+**Causa Raiz:**
+* [Por que esse problema ocorre atualmente?]
+
+**Impacto no Negócio:**
+* [Quais as consequências de não resolver esse problema?]
+
+---
+
+## 2. Personas e Público-Alvo
+
+<!-- INSTRUÇÕES DE PREENCHIMENTO:
+OBJETIVO: Definir quem se beneficiará com o software
+REGRA: Descreva perfis de usuários em termos de comportamentos e necessidades, não habilidades técnicas
+-->
+
+| Persona | Descrição | Principais Necessidades | Dores Atuais |
+|:---|:---|:---|:---|
+| **[Nome da Persona]** | [Perfil demográfico e comportamental] | [O que essa pessoa precisa accomplish?] | [Quais obstáculos enfrenta hoje?] |
+| **[Nome da Persona]** | [Perfil demográfico e comportamental] | [O que essa pessoa precisa accomplish?] | [Quais obstáculos enfrenta hoje?] |
+
+**Segmentação de Usuários:**
+* [ ] **Usuário Final:** [Descreva características]
+* [ ] **Administrador:** [Descreva características]
+* [ ] **Gerente/Analista:** [Descreva características]
+
+---
+
+## 3. Proposta de Valor
+
+<!-- INSTRUÇÕES DE PREENCHIMENTO:
+OBJETIVO: Definir o benefício único que o software entrega
+REGRA: Foco em resultados de negócio, não funcionalidades
+-->
+
+**Promessa Central:**
+* [Em uma frase: O que este software faz que ninguém faz?]
+
+**Benefícios Chave:**
+* [ ] **Benefício 1:** [Descrição do valor entregue]
+* [ ] **Benefício 2:** [Descrição do valor entregue]
+* [ ] **Benefício 3:** [Descrição do valor entregue]
+
+**Diferenciais Competitivos:**
+* [O que torna esta solução única vs alternativas atuais?]
+
+---
+
+## 4. Métricas de Sucesso
+
+<!-- INSTRUÇÕES DE PREENCHIMENTO:
+OBJETIVO: Definir como medir se o software está cumprindo seu propósito
+REGRA: Métricas devem ser mensuráveis e rastreáveis
+-->
+
+### 4.1. Métricas de Negócio (KPIs)
+
+| Métrica | Como Medir | Meta Inicial | Meta Futura |
+|:---|:---|:---|:---|
+| **[Ex: Retenção]** | [Ex: % usuários ativos após 30 dias] | [Ex: 40%] | [Ex: 60%] |
+| **[Ex: Conversão]** | [Ex: % visitantes que viram clientes] | [Ex: 5%] | [Ex: 10%] |
+
+### 4.2. Métricas de Valor para Usuário
+
+| Métrica | Como Medir | Meta |
+|:---|:---|:---|
+| **[Ex: Tempo de tarefa]** | [Ex: Tempo médio para completar fluxo principal] | [Ex: < 5 minutos] |
+| **[Ex: Satisfação]** | [Ex: NPS ou avaliação média] | [Ex: NPS > 40] |
+
+---
+
+## 5. Fronteiras do Produto (Scope)
+
+<!-- INSTRUÇÕES DE PREENCHIMENTO:
+OBJETIVO: Definir claramente o que o produto É e NÃO É
+REGRA CRÍTICA: NÃO mencione tecnologias específicas
+-->
+
+### 5.1. Escopo Includente (IN-SCOPE)
+
+**O que este produto FAZ:**
+* [ ] **Funcionalidade Principal 1:** [Descrição de negócio]
+* [ ] **Funcionalidade Principal 2:** [Descrição de negócio]
+* [ ] **Funcionalidade Principal 3:** [Descrição de negócio]
+
+**Usuários Suportados:**
+* [ ] [Tipo de usuário 1]
+* [ ] [Tipo de usuário 2]
+
+### 5.2. Escopo Excludente (OUT-OF-SCOPE)
+
+**O que este produto NÃO faz (explicitamente):**
+* [ ] **Funcionalidade Futura A:** [Descrição] - Motivo: [Por que não agora?]
+* [ ] **Funcionalidade Futura B:** [Descrição] - Motivo: [Por que não agora?]
+* [ ] **Funcionalidade Excluída C:** [Descrição] - Motivo: [Fora do domínio]
+
+**Regra de Escopo:** Qualquer funcionalidade não listada em "IN-SCOPE" deve ser considerada OUT-OF-SCOPE.
+
+---
+
+## 6. Jornada do Usuário
+
+<!-- INSTRUÇÕES DE PREENCHIMENTO:
+OBJETIVO: Descrever a experiência do usuário do início ao fim
+REGRA: Foco em comportamentos e resultados, não em telas ou botões
+-->
+
+### 6.1. Primeiro Contato
+
+**Como usuários descobrem o produto:**
+* [Canal de aquisição]
+
+**Momento da primeira necessidade:**
+* [Quando surge o problema que o produto resolve?]
+
+### 6.2. Fluxo Principal (Happy Path)
+
+**Etapas da jornada:**
+1. **[Etapa 1]:** [O que usuário faz/pensa]
+   - Resultado esperado: [O que acontece]
+2. **[Etapa 2]:** [O que usuário faz/pensa]
+   - Resultado esperado: [O que acontece]
+3. **[Etapa 3]:** [O que usuário faz/pense]
+   - Resultado esperado: [O que acontece]
+
+**Momento de Valor ("Aha!"):**
+* [Quando usuário percebe o valor do produto?]
+
+### 6.3. Retorno e Uso Recorrente
+
+**O que traz usuários de volta:**
+* [Motivo para uso contínuo]
+
+**Padrões de uso esperados:**
+* [Com que frequência usuário deve usar?]
+* [Quais gatilhos disparam a necessidade?]
+
+---
+
+## 7. Riscos e Suposições
+
+<!-- INSTRUÇÕES DE PREENCHIMENTO:
+OBJETIVO: Identificar incertezas que podem impactar o sucesso do produto
+-->
+
+### 7.1. Suposições Chave
+
+| Suposição | Plano de Validação | Risco se Falso |
+|:---|:---|:---|
+| **[Ex: Usuários têm smartphone]** | [Ex: Pesquisa de mercado] | [Ex: Produto inutilizável] |
+| **[Ex: Mercado paga pelo benefício]** | [Ex: Testes A/B com pagamento] | [Ex: Modelo de negócio inválido] |
+
+### 7.2. Riscos de Negócio
+
+| Risco | Probabilidade | Impacto | Plano de Mitigação |
+|:---|:---:|:---:|:---|
+| **[Risco 1]** | [Alta/Média/Baixa] | [Alto/Médio/Baixo] | [Como reduzir?] |
+| **[Risco 2]** | [Alta/Média/Baixa] | [Alto/Médio/Baixo] | [Como reduzir?] |
+
+---
+
+## 8. Visão de Futuro
+
+<!-- INSTRUÇÕES DE PREENCHIMENTO:
+OBJETIVO: Definir direção de longo prazo (2-3 anos)
+REGRA: Manter em nível de negócio, não implementação
+-->
+
+**Evolução Planejada:**
+* **Curto Prazo (6 meses):** [Foco em validar proposta de valor]
+* **Médio Prazo (1 ano):** [Expansão para novos segmentos/funcionalidades]
+* **Longo Prazo (2-3 anos):** [Visão de produto maduro]
+
+**Sinais de Sucesso para Próxima Fase:**
+* [ ] [Sinal 1 que indica pronto para evoluir]
+* [ ] [Sinal 2 que indica pronto para evoluir]
+
+---
+
+## 9. Stakeholders
+
+<!-- INSTRUÇÕES DE PREENCHIMENTO:
+OBJETIVO: Mapear quem influencia e é impactado pelo produto
+-->
+
+| Stakeholder | Interesse | Poder de Influência | Estratégia de Engajamento |
+|:---|:---|:---:|:---|
+| **[Papel 1]** | [O que quer do produto?] | [Alto/Médio/Baixo] | [Como manter alinhado?] |
+| **[Papel 2]** | [O que quer do produto?] | [Alto/Médio/Baixo] | [Como manter alinhado?] |
+
+---
+
+## 10. Inferências do Código Legado
+
+<!-- INSTRUÇÕES DE PREENCHIMENTO:
+OBJETIVO: Documentar como a visão de negócio foi inferida do código existente
+REGRA: Mapear evidências técnicas para inferências de negócio com níveis de confiança
+-->
+
+### 10.1. Mapeamento Técnico -> Negócio
+
+| Inferência de Negócio | Fonte Técnica | Confiança | Justificativa |
+|:---|:---|:---:|:---|
+| **[Ex: Multi-tenant SaaS]** | [JWT com tenant_id em todos os tokens] | [85%] | [Autenticação por tenant detectada] |
+| **[Ex: Pagamentos assíncronos]** | [Stripe webhooks, background jobs] | [95%] | [Webhooks configurados, filas detectadas] |
+| **[Ex: Sistema em escala]** | [Rate limiting (Redis), load balancer] | [78%] | [Infraestrutura elástica configurada] |
+| **[Ex: E-commerce B2C]** | [Catalog de produtos, checkout flow] | [90%] | [Fluxo completo de vendas detectado] |
+| **[Ex: Autenticação corporativa]** | [OAuth2 + SAML configuration] | [82%] | [SSO com providers múltiplos] |
+
+### 10.2. Entidades Inferidas
+
+| Entidade de Negócio | Fonte Técnica | Confiança | Observações |
+|:---|:---|:---:|:---|
+| **[Cliente]** | [User aggregate, UsersController] | [95%] | [Entidade principal do domínio] |
+| **[Pedido]** | [Order aggregate, OrderItems] | [92%] | [Aggregate com 1-N relation] |
+| **[Pagamento]** | [PaymentService, Stripe integration] | [70%] | [Contexto externo, wrapper] |
+
+### 10.3. Casos de Uso Inferidos
+
+| Caso de Uso | Fonte Técnica | Confiança | Observações |
+|:---|:---|:---:|:---|
+| **[Cadastrar usuário]** | [UsersController.Create] | [98%] | [Endpoint com validação completa] |
+| **[Criar pedido]** | [OrdersController.PlaceOrder] | [95%] | [Fluxo com cálculo de total] |
+| **[Processar pagamento]** | [PaymentService.Process, Stripe] | [88%] | [Assíncrono, com webhooks] |
+| **[Notificar usuário]** | [SendGrid templates, events] | [85%] | [Emails transacionais] |
+
+### 10.4. Limitações das Inferências
+
+**O que NÃO foi possível inferir com alta confiança:**
+- [ ] [Ex: Motivação dos usuários para usar o sistema]
+- [ ] [Ex: Diferenciais competitivos vs alternativas]
+- [ ] [Ex: Estratégia de monetização/preços]
+- [ ] [Ex: Canais de aquisição de clientes]
+
+**Razões:**
+- Código foca em implementação, não em estratégia
+- Ausência de documentação de produto
+- Métricas de negócio não monitoradas
+
+**Recomendação:**
+Validar inferências com stakeholders de negócio para confirmar ou ajustar a visão de produto.
+
+---
+
+**Notas de Decisão:**
+<!--
+Documente aqui decisões importantes sobre o produto e o porquê foram tomadas.
+Exemplo: "Decidimos focar em usuário X porque representam 80% do mercado"
+-->
+
+---
+
+**Validação de Qualidade (Zero-Code Check):**
+- [ ] Zero menções a frameworks, bibliotecas ou linguagens de programação
+- [ ] Zero menções a bancos de dados, APIs ou endpoints
+- [ ] Zero menções a infraestrutura (cloud, deploy, CI/CD)
+- [ ] Todo conteúdo focado em problema, usuários e valor de negócio
+- [ ] Métricas são mensuráveis e rastreáveis
+
+---
+
+**Template Version:** 0.2.0
+**Command:** `/gerar-visao` - Fase de Produto | `/gerar-contexto` - Brownfield Inference