@onion-architect-ai/cli 4.1.0-beta.1 → 4.1.0-beta.2

package/templates/.cursor/docs/templates/adr-template.md

@@ -0,0 +1,226 @@
+---
+# Cursor v2 - ADR Template Metadata
+template:
+  type: adr
+  version: 2.0
+  category: architecture-decision
+  adr_number: "XXX"
+
+decision_metadata:
+  status: "[Proposed | Accepted | Rejected | Superseded]"
+  date: "YYYY-MM-DD"
+  deciders: []
+  technical_story: "[Link para issue/ticket se aplicável]"
+
+quality_attributes:
+  performance: false
+  security: false
+  maintainability: false
+  scalability: false
+  usability: false
+  reliability: false
+  testability: false
+
+alternatives:
+  total_considered: 3
+  selected: "[Nome da alternativa selecionada]"
+
+decision_matrix:
+  criteria:
+    - name: "Performance"
+      weight: 20
+    - name: "Maintainability"
+      weight: 25
+    - name: "Development Speed"
+      weight: 15
+    - name: "Cost"
+      weight: 20
+    - name: "Risk"
+      weight: 20
+
+consequences:
+  positive: []
+  negative: []
+  neutral: []
+
+related_decisions:
+  supersedes: []
+  superseded_by: []
+  relates_to: []
+  impacts: []
+
+implementation:
+  timeline:
+    short_term: "[1-3 months]"
+    medium_term: "[3-6 months]"
+    long_term: "[6+ months]"
+  next_review: "[Data]"
+
+ai_assistant:
+  suggest_alternatives: true
+  validate_consequences: true
+  track_implementation: true
+  monitor_metrics: true
+  build_dependency_graph: true
+---
+
+# ADR-XXX: [Título da Decisão Arquitetural]
+
+**Status:** [Proposed | Accepted | Rejected | Superseded]  
+**Date:** YYYY-MM-DD  
+**Deciders:** [Lista de pessoas envolvidas]  
+**Technical Story:** [Link para issue/ticket se aplicável]
+
+---
+
+## 📋 **Context and Problem Statement**
+
+[Descrever o contexto arquitetural, tecnológico ou de negócio que levou à necessidade desta decisão. Incluir:]
+
+- **Problema específico** que precisamos resolver
+- **Restrições** t,écnicas, de tempo ou de recursos
+- **Drivers** de qualidade (performance, security, maintainability, etc.)
+- **Stakeholders** afetados pela decisão
+
+### **Quality Attributes Affected**
+- [ ] Performance
+- [ ] Security  
+- [ ] Maintainability
+- [ ] Scalability
+- [ ] Usability
+- [ ] Reliability
+- [ ] Testability
+
+---
+
+## 🎯 **Decision**
+
+[Descrever a decisão tomada de forma clara e concisa]
+
+### **Key Decision Points**
+1. **Tecnologia/Approach:** [Escolha principal]
+2. **Implementation Strategy:** [Como será implementado]
+3. **Migration Plan:** [Se aplicável]
+
+---
+
+## 🔍 **Alternatives Considered**
+
+### **Alternative 1: [Nome da alternativa]**
+- **Pros:** 
+  - [Vantagem 1]
+  - [Vantagem 2]
+- **Cons:**
+  - [Desvantagem 1]
+  - [Desvantagem 2]
+- **Cost/Effort:** [Alto/Médio/Baixo]
+
+### **Alternative 2: [Nome da alternativa]**
+- **Pros:** 
+  - [Vantagem 1]
+  - [Vantagem 2]
+- **Cons:**
+  - [Desvantagem 1]
+  - [Desvantagem 2]
+- **Cost/Effort:** [Alto/Médio/Baixo]
+
+### **Alternative 3: [Nome da alternativa]**
+- **Pros:** 
+  - [Vantagem 1]
+  - [Vantagem 2]
+- **Cons:**
+  - [Desvantagem 1]
+  - [Desvantagem 2]
+- **Cost/Effort:** [Alto/Médio/Baixo]
+
+---
+
+## ⚖️ **Decision Matrix**
+
+| Criteria | Weight | Alt 1 | Alt 2 | Alt 3 | **Selected** |
+|----------|--------|-------|-------|-------|--------------|
+| Performance | 20% | 3 | 4 | 2 | **4** |
+| Maintainability | 25% | 4 | 3 | 5 | **3** |
+| Development Speed | 15% | 5 | 2 | 3 | **2** |
+| Cost | 20% | 2 | 5 | 4 | **5** |
+| Risk | 20% | 4 | 3 | 2 | **3** |
+| **Total Score** | | **3.4** | **3.4** | **3.2** | **3.4** |
+
+*Scale: 1 (Poor) to 5 (Excellent)*
+
+---
+
+## 📊 **Consequences**
+
+### **✅ Positive Consequences**
+- [Consequência positiva 1 - específica e mensurável]
+- [Consequência positiva 2 - específica e mensurável]
+- [Consequência positiva 3 - específica e mensurável]
+
+### **⚠️ Negative Consequences**
+- [Consequência negativa 1 - e como mitigar]
+- [Consequência negativa 2 - e como mitigar]
+- [Consequência negativa 3 - e como mitigar]
+
+### **🔄 Neutral Consequences**
+- [Mudanças que são neutras mas importantes de documentar]
+
+---
+
+## 📈 **Expected Outcomes and Metrics**
+
+### **Success Metrics**
+- [ ] **Metric 1:** [Específica - ex: Response time < 200ms]
+- [ ] **Metric 2:** [Específica - ex: 95% test coverage]
+- [ ] **Metric 3:** [Específica - ex: Zero breaking changes]
+
+### **Timeline**
+- **Short-term (1-3 months):** [Resultados esperados]
+- **Medium-term (3-6 months):** [Resultados esperados]
+- **Long-term (6+ months):** [Resultados esperados]
+
+---
+
+## 🔗 **Related Decisions**
+
+- [Link para ADR relacionado]
+- [Link para ADR que esta decisão substitui]
+- [Link para ADR que pode ser impactado]
+
+---
+
+## 📚 **References**
+
+### **Technical References**
+- [Link para documentação técnica]
+- [Link para benchmarks ou estudos]
+- [Link para best practices]
+
+### **Implementation References**
+- [Link para código relevante]
+- [Link para configurações]
+- [Link para testes]
+
+---
+
+## 📝 **Implementation Notes**
+
+### **Action Items**
+- [ ] [Item específico com responsável e prazo]
+- [ ] [Item específico com responsável e prazo]
+- [ ] [Item específico com responsável e prazo]
+
+### **Risk Mitigation**
+- **Risk 1:** [Risco] → **Mitigation:** [Como mitigar]
+- **Risk 2:** [Risco] → **Mitigation:** [Como mitigar]
+
+### **Review Schedule**
+- **Next Review:** [Data]
+- **Review Criteria:** [O que avaliar na próxima revisão]
+
+---
+
+**📅 Created:** [Date]  
+**👤 Author:** [Name and role]  
+**🔄 Last Updated:** [Date]  
+**📋 Status:** [Current status] 

package/templates/.cursor/docs/templates/analysis-template.md

@@ -0,0 +1,280 @@
+---
+# Cursor v2 - Analysis Template Metadata
+template:
+  type: analysis
+  version: 2.0
+  category: documentation
+  name: "[Tipo de Análise]"
+
+analysis_metadata:
+  analysis_type: "[Crítica | Implementação | Status]"
+  date: "[YYYY-MM-DD]"
+  analyst: "[Nome do analista/equipe]"
+  base_document: "[Referência ao que está sendo analisado]"
+  scope: "[O que está sendo analisado - ex: Migração, Implementação, Arquitetura]"
+
+severity_config:
+  critical:
+    label: "🔴 CRÍTICO"
+    criteria: "[Critério para problemas críticos]"
+  high:
+    label: "🟡 ALTO"
+    criteria: "[Critério para problemas altos]"
+  medium:
+    label: "🟢 MÉDIO"
+    criteria: "[Critério para problemas médios]"
+
+status:
+  overall: "[EXCELENTE | BOM | CRÍTICO]"
+  completion_percentage: 0
+  critical_actions: 0
+  risks_identified: 0
+  main_findings: []
+
+tracking:
+  phases:
+    immediate: "[Esta Semana]"
+    short_term: "[Próximas 2 Semanas]"
+    medium_term: "[Próximo Mês]"
+  
+  metrics:
+    - name: "[Métrica 1]"
+      current: "[Valor]"
+      expected: "[Target]"
+      status: "[OK | WARNING | CRITICAL]"
+
+ai_assistant:
+  auto_status: true
+  track_actions: true
+  monitor_metrics: true
+  prioritize_risks: true
+  suggest_solutions: true
+---
+
+# Análise [Tipo]: [Título da Análise]
+
+**Documento de Análise [Crítica/Implementação/Status]**  
+**Data:** [YYYY-MM-DD]  
+**Analisado por:** [Nome do analista/equipe]  
+**Documento/Sistema Base:** [Referência ao que está sendo analisado]  
+**Escopo:** [O que está sendo analisado - ex: Migração, Implementação, Arquitetura]
+
+---
+
+## 🚨 **RESUMO EXECUTIVO**
+
+[Resumo conciso do status geral da análise, incluindo:]
+
+- **Status Geral**: [🟢 EXCELENTE / 🟡 BOM / 🔴 CRÍTICO] ([X%] implementado/conforme)
+- **Principais Achados**: [2-3 pontos mais importantes]
+- **Ações Críticas**: [Quantas ações críticas identificadas]
+- **Riscos Identificados**: [Número de riscos por severity]
+
+**Severity Levels:**
+- 🔴 **CRÍTICO**: [Critério para problemas críticos]
+- 🟡 **ALTO**: [Critério para problemas altos]
+- 🟢 **MÉDIO**: [Critério para problemas médios]
+
+---
+
+## 📋 **ANÁLISE DETALHADA**
+
+### **1. [CATEGORIA DE ANÁLISE 1]**
+
+#### **🟢 [Subcategoria] - STATUS POSITIVO**
+**Status**: ✅ **[STATUS]** ([X%] [métrica])
+
+**[Componentes/Aspectos] Analisados:**
+- ✅ **[Item 1]**: [Descrição do status]
+- ✅ **[Item 2]**: [Descrição do status] 
+- ✅ **[Item 3]**: [Descrição do status]
+
+**Evidências:**
+- [Evidência 1 - arquivo/configuração/teste]
+- [Evidência 2 - métrica/resultado]
+- [Evidência 3 - observação]
+
+#### **🟡 [Subcategoria] - STATUS PARCIAL**
+**Status**: ⚠️ **[STATUS]** ([X%] [métrica])
+
+**[Componentes/Aspectos] Analisados:**
+- ✅ **[Item implementado]**: [Descrição]
+- ⚠️ **[Item parcial]**: [Descrição do que falta]
+- ❌ **[Item faltando]**: [Descrição do problema]
+
+**Gaps Identificados:**
+- [Gap 1 com impacto]
+- [Gap 2 com impacto]
+
+#### **🔴 [Subcategoria] - STATUS CRÍTICO**
+**Status**: ❌ **[STATUS]** ([X%] [métrica])
+
+**Problemas Críticos:**
+- 🔴 **[Problema 1]**: [Descrição detalhada]
+  - **Impacto**: [Impacto específico]
+  - **Causa Raiz**: [Análise da causa]
+  - **Recomendação**: [Solução específica]
+
+---
+
+## 📊 **MATRIZ DE STATUS/PROBLEMAS**
+
+### **Matriz de Implementação**
+| Componente | Status | % Completo | Prioridade | Estimativa |
+|------------|--------|------------|------------|------------|
+| [Componente 1] | ✅ COMPLETO | 100% | - | - |
+| [Componente 2] | ⚠️ PARCIAL | 75% | 🟡 ALTA | 4h |
+| [Componente 3] | ❌ FALTANDO | 0% | 🔴 CRÍTICA | 8h |
+
+### **Matriz de Riscos**
+| Risco | Probabilidade | Impacto | Severity | Mitigação |
+|-------|--------------|---------|----------|-----------|
+| [Risco 1] | Alta | Crítico | 🔴 | [Estratégia de mitigação] |
+| [Risco 2] | Média | Alto | 🟡 | [Estratégia de mitigação] |
+| [Risco 3] | Baixa | Médio | 🟢 | [Estratégia de mitigação] |
+
+---
+
+## 🎯 **PROBLEMAS IDENTIFICADOS POR CATEGORIA**
+
+### **1. PROBLEMAS CRÍTICOS** 🔴
+
+#### **[Nome do Problema Crítico]**
+- **Problema**: [Descrição específica]
+- **Impacto**: [Consequências detalhadas]
+- **Evidência**: [Como foi identificado]
+- **Solução**: [Ação específica necessária]
+- **Prazo**: [Quando deve ser resolvido]
+
+### **2. PROBLEMAS ALTOS** 🟡
+
+#### **[Nome do Problema Alto]**
+- **Problema**: [Descrição específica]
+- **Impacto**: [Consequências detalhadas]
+- **Solução**: [Ação específica necessária]
+
+### **3. MELHORIAS RECOMENDADAS** 🟢
+
+#### **[Nome da Melhoria]**
+- **Oportunidade**: [Descrição da melhoria]
+- **Benefício**: [Vantagens esperadas]
+- **Implementação**: [Como implementar]
+
+---
+
+## 📈 **MÉTRICAS E VALIDAÇÃO**
+
+### **Métricas Atuais vs. Esperadas**
+| Métrica | Atual | Esperado | Status | Gap |
+|---------|-------|----------|--------|-----|
+| [Métrica 1] | [Valor] | [Target] | [✅/⚠️/❌] | [Diferença] |
+| [Métrica 2] | [Valor] | [Target] | [✅/⚠️/❌] | [Diferença] |
+| [Métrica 3] | [Valor] | [Target] | [✅/⚠️/❌] | [Diferença] |
+
+### **Critérios de Sucesso**
+- [ ] **[Critério 1]**: [Descrição específica e mensurável]
+- [ ] **[Critério 2]**: [Descrição específica e mensurável]
+- [ ] **[Critério 3]**: [Descrição específica e mensurável]
+
+### **Testes de Validação**
+```bash
+# Comandos para validar os resultados
+validation-command-1
+validation-command-2
+validation-command-3
+```
+
+---
+
+## 🔧 **RECOMENDAÇÕES PRIORITÁRIAS**
+
+### **AÇÕES IMEDIATAS** (Esta Semana) 🔴
+1. **[Ação Crítica 1]** - [Estimativa: Xh]
+   - **Por que**: [Justificativa da urgência]
+   - **Como**: [Passos específicos]
+   - **Resultado**: [Outcome esperado]
+
+2. **[Ação Crítica 2]** - [Estimativa: Xh]
+   - **Por que**: [Justificativa da urgência]
+   - **Como**: [Passos específicos]
+   - **Resultado**: [Outcome esperado]
+
+### **AÇÕES CURTO PRAZO** (Próximas 2 Semanas) 🟡
+1. **[Ação Importante 1]** - [Estimativa: Xh]
+2. **[Ação Importante 2]** - [Estimativa: Xh]
+
+### **AÇÕES MÉDIO PRAZO** (Próximo Mês) 🟢
+1. **[Melhoria 1]** - [Estimativa: Xh]
+2. **[Melhoria 2]** - [Estimativa: Xh]
+
+---
+
+## ✅ **PLANO DE AÇÃO DETALHADO**
+
+### **Fase 1: Correções Críticas** (Prazo: [Data])
+- [ ] **[Task 1]** - [Responsável] - [Deadline]
+- [ ] **[Task 2]** - [Responsável] - [Deadline]
+- [ ] **[Task 3]** - [Responsável] - [Deadline]
+
+**Critérios de Aceitação:**
+- [ ] [Critério específico 1]
+- [ ] [Critério específico 2]
+
+### **Fase 2: Melhorias** (Prazo: [Data])
+- [ ] **[Task 1]** - [Responsável] - [Deadline]
+- [ ] **[Task 2]** - [Responsável] - [Deadline]
+
+**Critérios de Aceitação:**
+- [ ] [Critério específico 1]
+- [ ] [Critério específico 2]
+
+### **Fase 3: Otimizações** (Prazo: [Data])
+- [ ] **[Task 1]** - [Responsável] - [Deadline]
+- [ ] **[Task 2]** - [Responsável] - [Deadline]
+
+---
+
+## 🏆 **CONCLUSÃO E PRÓXIMOS PASSOS**
+
+### **✅ PONTOS FORTES IDENTIFICADOS**
+- **[Ponto forte 1]**: [Por que é importante]
+- **[Ponto forte 2]**: [Por que é importante]
+- **[Ponto forte 3]**: [Por que é importante]
+
+### **⚠️ LACUNAS CRÍTICAS**
+- **[Lacuna 1]**: [Impacto e urgência]
+- **[Lacuna 2]**: [Impacto e urgência]
+- **[Lacuna 3]**: [Impacto e urgência]
+
+### **🎯 PRÓXIMO PASSO RECOMENDADO**
+**[Ação específica mais importante]** - [Justificativa detalhada]
+
+### **📊 EXPECTATIVA DE MELHORIA**
+Após implementar as recomendações:
+- **Status esperado**: [De X% para Y%]
+- **Riscos mitigados**: [Quantos riscos serão resolvidos]
+- **Benefícios**: [Principais benefícios esperados]
+
+---
+
+## 📚 **ANEXOS E REFERÊNCIAS**
+
+### **Documentos Analisados**
+- [Documento 1] - [Relevância para análise]
+- [Documento 2] - [Relevância para análise]
+
+### **Ferramentas Utilizadas**
+- [Ferramenta 1] - [Para que foi usada]
+- [Ferramenta 2] - [Para que foi usada]
+
+### **Metodologia**
+- **Critérios de análise**: [Como foi feita a análise]
+- **Fontes de dados**: [De onde vieram as informações]
+- **Limitações**: [O que não foi possível analisar]
+
+---
+
+**📅 Criado em:** [Data]  
+**👤 Analista:** [Nome e contato]  
+**🔄 Próxima revisão:** [Data recomendada para nova análise]  
+**📋 Status do documento:** [Draft/Review/Approved]