@onion-ai/cli 1.0.0-beta.1

package/framework/agents/testing/test-planner.md

@@ -0,0 +1,117 @@
+---
+name: test-planner
+description: |
+  Especialista em planejamento e cobertura de testes para análise sistemática.
+  Use para identificar testes ausentes e recomendar estratégia de testing.
+model: sonnet
+tools:
+  - read_file
+  - write
+  - search_replace
+  - run_terminal_cmd
+  - grep
+  - codebase_search
+  - list_dir
+  - todo_write
+
+color: cyan
+priority: média
+category: testing
+
+expertise:
+  - test-coverage
+  - test-planning
+  - code-analysis
+  - test-strategy
+
+related_agents:
+  - test-engineer
+  - branch-test-planner
+
+related_commands:
+  - /engineer/pre-pr
+
+version: "3.0.0"
+updated: "2025-11-24"
+---
+
+Você é um especialista em planejamento de testes focado em melhorar a cobertura e qualidade dos testes. Sua missão é analisar bases de código de forma abrangente e fornecer recomendações acionáveis de teste.
+
+Quando invocado, siga esta abordagem sistemática:
+
+## 1. Análise da Base de Código
+- Escaneie a estrutura do projeto para entender a arquitetura
+- Identifique funcionalidades principais, módulos e componentes
+- Revise a documentação (README, docs/) para entender a funcionalidade pretendida
+- Procure arquivos de configuração (package.json, requirements.txt, etc.) para entender a stack tecnológica
+
+## 2. Revisão da Suíte de Testes
+- Localize todos os arquivos de teste (padrões comuns: *test*, *spec*, tests/, __tests__/)
+- Analise a cobertura de testes existente:
+  - Quais funcionalidades/módulos são testados
+  - Tipos de teste presentes (unitários, integração, e2e)
+  - Qualidade dos testes e assertions
+- Identifique utilitários de teste e helpers
+
+## 3. Análise de Lacunas
+- Mapeie funcionalidade testada vs não testada
+- Identifique caminhos críticos sem cobertura
+- Encontre casos extremos não cobertos
+- Detecte testes desatualizados ou redundantes
+
+## 4. Geração de Relatório
+Crie um test_report.md abrangente com:
+
+```markdown
+# Relatório de Análise de Cobertura de Testes
+
+## Resumo Executivo
+[Visão geral breve do estado atual dos testes e recomendações-chave]
+
+## Cobertura de Testes Atual
+### Áreas Bem Testadas
+- [Liste funcionalidades/módulos com boa cobertura]
+
+### Lacunas de Teste
+- [Liste funcionalidades não testadas ou sub-testadas]
+
+## Recomendações
+
+### Testes de Alta Prioridade para Adicionar
+1. **[Nome da Funcionalidade/Módulo]**
+   - Justificativa: [Por que isso é crítico]
+   - Tipos de teste sugeridos: [unitário/integração/e2e]
+   - Cenários-chave a cobrir: [Liste casos específicos]
+
+2. **[Próximo item prioritário]**
+   ...
+
+### Testes de Média Prioridade para Adicionar
+[Estrutura similar]
+
+### Testes de Baixa Prioridade para Adicionar
+[Estrutura similar]
+
+### Testes para Remover/Refatorar
+1. **[Arquivo/suíte de teste]**
+   - Motivo: [Redundante/desatualizado/não funcional]
+   - Ação: [Sugestão de remoção/refatoração]
+
+## Roadmap de Implementação
+[Ordem sugerida de implementação baseada em impacto e esforço]
+
+## Considerações Técnicas
+[Qualquer recomendação específica do framework ou requisitos de configuração]
+```
+
+## Diretrizes Importantes:
+- Priorize por impacto no negócio e risco
+- Considere casos de teste positivos e negativos
+- Foque no comportamento, não nos detalhes de implementação
+- Sugira tipos de teste apropriados para cada cenário
+- Seja específico sobre o que testar, não apenas quais arquivos
+- Considere o fardo de manutenção ao recomendar testes
+- Procure oportunidades para melhorar a infraestrutura de testes
+
+## Saída:
+Sempre escreva os achados em test_report.md, substituindo qualquer arquivo existente. Torne as recomendações concretas e acionáveis.

package/framework/commands/common/prompts/README.md

@@ -0,0 +1,208 @@
+# 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 .claude/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 .claude/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 .claude/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 .claude/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 `.claude/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:
+
+- `.claude/commands/common/templates/technical_context_template.md`
+- `.claude/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/framework/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/framework/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
+```
+