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

package/templates/.cursor/commands/common/prompts/README.md

@@ -0,0 +1,187 @@
+# Prompts de Geração de Documentação
+
+Este diretório contém prompts abrangentes projetados para guiar o Cursor na geração automática de arquiteturas completas de documentação para projetos. Estes prompts fazem engenharia reversa da estrutura de documentação multi-arquivo que desenvolvemos.
+
+## Prompts Disponíveis
+
+### 🧩 Prompts Modulares (Reutilizáveis)
+
+| Arquivo | Propósito | Uso |
+|---------|-----------|-----|
+| `clickup-patterns.md` | Padrões de formatação ClickUp | Tasks, comments, tags |
+| `validation-rules.md` | Regras de validação de inputs | Validação de parâmetros |
+| `output-formats.md` | Formatos de saída padronizados | Outputs consistentes |
+| `code-review-checklist.md` | Checklist de code review | Reviews de PR |
+| `git-workflow-patterns.md` | Padrões de workflow Git | GitFlow, commits |
+
+### 📄 Prompts de Geração
+
+### 📋 `technical.md` - Gerador de Documentação Técnica
+**Propósito**: Analisar um codebase e gerar documentação abrangente de contexto técnico
+
+**Saída**: Documentação técnica completa seguindo a arquitetura multi-arquivo:
+- Project charter e ADRs
+- Guias de desenvolvimento IA e navegação do codebase
+- Lógica de negócio e especificações de API  
+- Workflow de desenvolvimento e guias de troubleshooting
+
+**Melhor Para**: 
+- Projetos de software precisando de documentação técnica
+- Projetos open source requerendo onboarding de contribuidores
+- Codebases complexos precisando de contexto otimizado para IA
+
+### 🏢 `business.md` - Gerador de Contexto de Negócio  
+**Propósito**: Analisar um produto/projeto e gerar documentação abrangente de inteligência de negócio
+
+**Saída**: Contexto de negócio completo seguindo a arquitetura multi-arquivo:
+- Personas de cliente e mapeamento de jornada
+- Estratégia de produto e catálogos de funcionalidades
+- Panorama competitivo e análise de mercado
+- Processos de vendas e diretrizes de comunicação
+
+**Melhor Para**:
+- Produtos precisando de otimização de suporte ao cliente
+- Inteligência de negócio e análise de mercado
+- Sistemas de interação de IA com cliente
+- Alinhamento de vendas e marketing
+
+## Exemplos de Uso
+
+### Geração de Documentação Técnica
+```bash
+# Para um projeto Python
+cursor --prompt .cursor/commands/common/prompts/technical.md \
+  --project-path ./my-python-project \
+  --output-path ./my-python-project/docs/technical \
+  --technology-stack "Python, FastAPI, PostgreSQL" \
+  --focus-areas "performance,security"
+
+# Para uma aplicação React  
+cursor --prompt .cursor/commands/common/prompts/technical.md \
+  --project-path ./my-react-app \
+  --output-path ./docs/technical \
+  --existing-docs ./current-docs \
+  --focus-areas "scalability,testing"
+```
+
+### Geração de Documentação de Negócio
+```bash
+# Para um produto SaaS
+cursor --prompt .cursor/commands/common/prompts/business.md \
+  --project-path ./my-saas-product \
+  --output-path ./docs/business \
+  --business-model "B2B SaaS" \
+  --target-market "Enterprise developers" \
+  --competitive-analysis "Competitor1,Competitor2"
+
+# For an open source project
+cursor --prompt .cursor/commands/common/prompts/business.md \
+  --project-path ./my-oss-project \
+  --output-path ./specs/business \
+  --business-model "Open Source" \
+  --customer-research ./community-feedback.md
+```
+
+## Arquitetura de Prompts
+
+Ambos os prompts seguem uma abordagem sistemática:
+
+1. **Fase de Análise**: Compreensão profunda do projeto/produto
+2. **Fase de Pesquisa**: Coleta de contexto de múltiplas fontes
+3. **Fase de Geração**: Criação da estrutura de documentação multi-arquivo
+4. **Garantia de Qualidade**: Garantindo precisão e otimização para IA
+
+## Funcionalidades Principais
+
+### 🎯 **Estrutura Multi-Arquivo**
+- Gera arquivos de documentação vinculados e modulares
+- Cada arquivo foca em um domínio ou camada específica
+- Fácil de manter e atualizar
+
+### 🤖 **Otimizado para IA**
+- Conteúdo estruturado para consumo de IA
+- Inclui diretrizes específicas de interação com IA
+- Permite melhor desenvolvimento e suporte assistido por IA
+
+### 📊 **Baseado em Evidências**
+- Fundamentado em dados e artefatos reais do projeto
+- Evita conselhos genéricos em favor de insights específicos do projeto
+- Valida afirmações com código, configurações e feedback
+
+### 🔄 **Integração com Templates**
+- Referencia os templates abrangentes em `.cursor/commands/common/templates/`
+- Garante consistência entre diferentes projetos
+- Segue melhores práticas estabelecidas
+
+## Padrões de Qualidade
+
+### Documentação Técnica
+- ✅ Arquitetura corresponde à implementação real
+- ✅ Exemplos funcionam e são testados
+- ✅ Afirmações de performance apoiadas por evidências
+- ✅ Workflows de desenvolvimento correspondem às práticas do projeto
+
+### Documentação de Negócio  
+- ✅ Insights de cliente baseados em feedback real
+- ✅ Análise competitiva atual e precisa
+- ✅ Estratégia de produto alinhada com direção real
+- ✅ Diretrizes de comunicação correspondem às preferências do cliente
+
+## Personalização
+
+Os prompts são projetados para serem flexíveis e podem ser adaptados para:
+
+### Tipos de Projeto
+- Aplicações web
+- Apps mobile
+- APIs e serviços backend
+- Bibliotecas e frameworks
+- Ferramentas de desenvolvedor
+- Software empresarial
+
+### Modelos de Negócio
+- B2B SaaS
+- B2C applications
+- Open source projects
+- E-commerce platforms
+- Marketplace platforms
+- Developer tools
+
+### Estágios da Empresa
+- Early stage / startup
+- Growth stage
+- Enterprise / mature
+
+## Integração com Templates
+
+Estes prompts funcionam em conjunto com:
+- `.cursor/commands/common/templates/technical_context_template.md`
+- `.cursor/commands/common/templates/business_context_template.md`
+
+Os templates fornecem a estrutura e frameworks, enquanto estes prompts fornecem a metodologia de análise e estratégia de execução.
+
+## Resultados Esperados
+
+O uso destes prompts deve resultar em:
+
+### Para Equipes de Desenvolvimento
+- Onboarding mais rápido de novos membros da equipe
+- Melhor experiência de desenvolvimento assistido por IA
+- Tomada de decisões técnicas consistentes
+- Eficiência aprimorada na revisão de código
+
+### Para Equipes de Negócio  
+- Capacidades aprimoradas de suporte ao cliente com IA
+- Mensagens alinhadas de vendas e marketing
+- Decisões de produto baseadas em dados
+- Inteligência competitiva abrangente
+
+### Para Sistemas de IA
+- Compreensão profunda do contexto do projeto
+- Capacidade de fornecer assistência contextualmente apropriada
+- Melhor geração de código e sugestões
+- Capacidades aprimoradas de interação com cliente
+
+## Meta-Documentação
+
+Estes prompts representam uma abordagem "meta" para documentação - são prompts que geram a arquitetura de documentação que projetamos e validamos. Eles permitem escalar documentação de alta qualidade e otimizada para IA em múltiplos projetos, mantendo padrões de consistência e qualidade.

package/templates/.cursor/commands/common/prompts/clickup-patterns.md

@@ -0,0 +1,144 @@
+# Padrões de Formatação ClickUp
+
+## 📋 Task Descriptions (Markdown)
+
+### Estrutura Padrão
+
+```markdown
+## 🎯 Objetivo
+[Descrição clara do objetivo em 1-2 parágrafos]
+
+## 📋 Requisitos
+- [ ] Requisito 1
+- [ ] Requisito 2
+- [ ] Requisito 3
+
+## ✅ Critérios de Aceite
+- [ ] Critério 1
+- [ ] Critério 2
+
+## 🔗 Referências
+- [Link 1](url)
+- [Link 2](url)
+```
+
+### Headers por Tipo de Task
+
+| Tipo | Emoji | Uso |
+|------|-------|-----|
+| Feature | 🚀 | Nova funcionalidade |
+| Bug | 🐛 | Correção de bug |
+| Refactor | 🔧 | Refatoração |
+| Docs | 📚 | Documentação |
+| Test | 🧪 | Testes |
+| Chore | 🔨 | Manutenção |
+
+---
+
+## 💬 Task Comments (Unicode Visual)
+
+### Formato de Progresso
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📊 PROGRESS UPDATE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📅 {TIMESTAMP} | Status: {STATUS}
+
+✅ Concluído:
+∟ Item 1
+∟ Item 2
+
+🚧 Em Progresso:
+∟ Item 3
+
+⏳ Pendente:
+∟ Item 4
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Formato de Fase Completada
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ FASE {N} CONCLUÍDA - {NOME}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📅 {DATA} | Status: DONE
+
+📊 Resumo:
+∟ {Métrica 1}: {Valor}
+∟ {Métrica 2}: {Valor}
+
+📁 Arquivos Modificados:
+∟ path/to/file1.md
+∟ path/to/file2.md
+
+🚀 Próxima Fase: {Nome da Próxima}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Símbolos Padrão
+
+| Símbolo | Uso |
+|---------|-----|
+| ━━━ | Separador de seção |
+| ∟ | Item de lista |
+| ▶ | Ação/Step |
+| ◆ | Ponto importante |
+| ✅ | Concluído |
+| ❌ | Erro/Bloqueio |
+| ⚠️ | Aviso |
+| 🚧 | Em progresso |
+| ⏳ | Pendente |
+
+---
+
+## 🏷️ Tags Padrão
+
+### Por Prioridade
+- `urgent` - Crítico
+- `high` - Alta
+- `medium` - Média  
+- `low` - Baixa
+
+### Por Tipo
+- `feature` - Funcionalidade
+- `bug` - Bug
+- `refactor` - Refatoração
+- `docs` - Documentação
+- `subtask` - Subtask
+
+### Por Status
+- `blocked` - Bloqueado
+- `review` - Em revisão
+- `testing` - Em teste
+
+---
+
+## 📊 Estimativas
+
+| Tamanho | Horas | Pontos |
+|---------|-------|--------|
+| XS | 1-2h | 1 |
+| S | 2-4h | 2 |
+| M | 4-8h | 3 |
+| L | 1-2d | 5 |
+| XL | 2-5d | 8 |
+| XXL | 5d+ | 13 |
+
+---
+
+## 🔄 Status Flow
+
+```
+TO DO → IN PROGRESS → REVIEW → DONE
+         ↓
+      BLOCKED → IN PROGRESS
+```
+
+### Transições Automáticas
+- PR aberto → `review`
+- PR merged → `done`
+- Bloqueio detectado → `blocked`
+

package/templates/.cursor/commands/common/prompts/code-review-checklist.md

@@ -0,0 +1,168 @@
+# Checklist de Code Review
+
+## 🔍 Análise de Código
+
+### 1. Correção Funcional
+- [ ] Código faz o que deveria fazer?
+- [ ] Casos extremos tratados?
+- [ ] Validação de inputs adequada?
+- [ ] Tratamento de erros apropriado?
+
+### 2. Qualidade de Código
+- [ ] Código legível e auto-documentado?
+- [ ] Nomes de variáveis/funções descritivos?
+- [ ] Funções com responsabilidade única?
+- [ ] Sem código duplicado (DRY)?
+- [ ] Sem código morto/comentado?
+
+### 3. Performance
+- [ ] Algoritmos eficientes?
+- [ ] Sem loops desnecessários?
+- [ ] Queries otimizadas?
+- [ ] Recursos liberados corretamente?
+
+### 4. Segurança
+- [ ] Sem dados sensíveis hardcoded?
+- [ ] Inputs sanitizados?
+- [ ] Autenticação/autorização corretas?
+- [ ] Sem vulnerabilidades conhecidas?
+
+### 5. Testes
+- [ ] Testes unitários para nova lógica?
+- [ ] Testes de integração se necessário?
+- [ ] Cobertura adequada?
+- [ ] Testes passando?
+
+### 6. Documentação
+- [ ] Funções complexas documentadas?
+- [ ] README atualizado se necessário?
+- [ ] Comentários onde não óbvio?
+- [ ] Changelog atualizado?
+
+---
+
+## 📝 Template de Feedback
+
+### Crítico (Bloqueia PR)
+
+```markdown
+🔴 **CRÍTICO** - [Arquivo:Linha]
+
+**Problema**: [Descrição]
+**Impacto**: [Por que é crítico]
+**Sugestão**: 
+\`\`\`[linguagem]
+// código sugerido
+\`\`\`
+```
+
+### Importante (Deve corrigir)
+
+```markdown
+🟡 **IMPORTANTE** - [Arquivo:Linha]
+
+**Problema**: [Descrição]
+**Sugestão**: [Como melhorar]
+```
+
+### Sugestão (Nice-to-have)
+
+```markdown
+💡 **SUGESTÃO** - [Arquivo:Linha]
+
+**Ideia**: [Melhoria opcional]
+```
+
+### Elogio
+
+```markdown
+✨ **ÓTIMO** - [Arquivo:Linha]
+
+[O que foi bem feito]
+```
+
+---
+
+## 📊 Categorias de Issues
+
+| Categoria | Emoji | Severidade |
+|-----------|-------|------------|
+| Bug | 🐛 | Crítico |
+| Security | 🔐 | Crítico |
+| Performance | ⚡ | Importante |
+| Maintainability | 🔧 | Importante |
+| Style | 🎨 | Sugestão |
+| Docs | 📚 | Sugestão |
+| Test | 🧪 | Importante |
+
+---
+
+## ✅ Resumo de Review
+
+```markdown
+## 📋 Code Review Summary
+
+**PR**: #[número] - [título]
+**Autor**: @[autor]
+**Reviewer**: @[reviewer]
+**Status**: [APPROVED | CHANGES_REQUESTED | COMMENT]
+
+### 📊 Estatísticas
+- Arquivos: X modificados
+- Linhas: +Y / -Z
+- Issues: A críticos, B importantes, C sugestões
+
+### 🔴 Issues Críticos
+1. [Descrição breve] - arquivo:linha
+
+### 🟡 Issues Importantes  
+1. [Descrição breve] - arquivo:linha
+
+### 💡 Sugestões
+1. [Descrição breve]
+
+### ✨ Pontos Positivos
+- [O que foi bem feito]
+
+### 🎯 Veredicto
+[Resumo e recomendação final]
+```
+
+---
+
+## 🔄 Fluxo de Review
+
+```
+1. Leitura Inicial
+   ↓
+2. Análise de Arquitetura
+   ↓
+3. Revisão Linha-a-Linha
+   ↓
+4. Verificação de Testes
+   ↓
+5. Teste Local (se necessário)
+   ↓
+6. Feedback Estruturado
+   ↓
+7. Discussão/Aprovação
+```
+
+---
+
+## ⚡ Quick Checks
+
+```bash
+# Lint
+npm run lint
+
+# Testes
+npm test
+
+# Build
+npm run build
+
+# Type check
+npm run type-check
+```
+