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

package/templates/.onion/contexts/technical/commands/intermediate/code-review.md

@@ -0,0 +1,215 @@
+---
+name: code-review
+description: |
+  Gerenciador de ChatGPT-CodeReview para setup, validação e otimização.
+  Use para configurar code review automático em projetos.
+model: sonnet
+
+parameters:
+  - name: mode
+    description: Modo de operação (auto/setup/validate/status)
+    required: false
+    default: auto
+
+category: git
+tags:
+  - code-review
+  - automation
+  - ci-cd
+
+version: "4.0.0"
+updated: "2025-12-20"
+
+related_commands:
+  - /engineer/pre-pr
+  - /git/feature/finish
+
+related_agents:
+  - code-reviewer
+  - branch-code-reviewer
+level: intermediate
+context: technical
+---
+
+# 🤖 ChatGPT Code Review Manager
+
+Gerenciador inteligente de ChatGPT-CodeReview para o Sistema Onion.
+
+## 🎯 Objetivo
+
+Automatizar setup, validação e otimização do code review automático.
+
+## ⚡ Modos de Operação
+
+```bash
+/git/code-review           # AUTO: detecta e executa ação apropriada
+/git/code-review setup     # Criar/reconfigurar arquivo
+/git/code-review validate  # Validar configuração existente  
+/git/code-review status    # Mostrar status atual
+```
+
+## 🔄 Fluxo de Execução
+
+### Passo 1: Detectar Modo
+
+```bash
+# Verificar se code-review.yml existe
+test -f .github/workflows/code-review.yml && MODE="validate" || MODE="setup"
+```
+
+SE `{{mode}}` fornecido → usar modo especificado
+SENÃO → usar detecção automática
+
+### Passo 2: Executar Modo
+
+#### 🆕 SETUP MODE
+
+1. **Detectar Stack**
+   ```bash
+   # Package manager
+   test -f pnpm-lock.yaml && PM="pnpm"
+   test -f package-lock.json && PM="npm"
+   
+   # Monorepo
+   test -f nx.json && MONO="nx"
+   
+   # Backend/Frontend
+   grep -q "fastify" package.json && BACKEND="fastify"
+   grep -q "react" package.json && FRONTEND="react"
+   ```
+
+2. **Gerar Template**
+   Criar `.github/workflows/code-review.yml`:
+```yaml
+   name: ChatGPT Code Review
+
+on:
+  pull_request:
+       types: [opened, synchronize]
+
+jobs:
+     review:
+    runs-on: ubuntu-latest
+    steps:
+         - uses: actions/checkout@v4
+         - uses: anc95/ChatGPT-CodeReview@main
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+   ```
+
+3. **Aplicar Configurações por Stack**
+   - TypeScript → adicionar regras de tipos
+   - React → regras de hooks
+   - NX → regras de monorepo
+
+#### 🔍 VALIDATE MODE
+
+1. **Verificar Arquivo**
+   - Existe?
+   - YAML válido?
+   - Secrets configurados?
+
+2. **Analisar Configuração**
+   Usar checklist de `common/prompts/code-review-checklist.md`
+
+3. **Gerar Relatório**
+   ```
+   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+   📊 CODE REVIEW VALIDATION
+   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+   
+   ✅ Arquivo: .github/workflows/code-review.yml
+   ✅ YAML: Válido
+   ⚠️ Secrets: OPENAI_API_KEY não detectado
+   
+   💡 Recomendações:
+   ∟ Configurar OPENAI_API_KEY em Settings > Secrets
+   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+   ```
+
+#### 📊 STATUS MODE
+
+Mostrar dashboard:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📊 CODE REVIEW STATUS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🔧 Configuração:
+∟ Arquivo: ✅ Configurado
+∟ Stack: TypeScript + React + NX
+∟ Última atualização: 2025-11-24
+
+📈 Métricas (últimos 30 dias):
+∟ PRs revisados: 45
+∟ Issues detectados: 127
+∟ Auto-fixes aplicados: 23
+
+🎯 Saúde: 95% ████████████░░░░░
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Passo 3: Atualizar ClickUp
+
+SE há task associada:
+- Adicionar comentário com resultado
+- Atualizar status se necessário
+
+## 📤 Output Esperado
+
+### Setup Sucesso
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ CODE REVIEW CONFIGURADO
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📁 Criado: .github/workflows/code-review.yml
+
+🔧 Stack Detectado:
+∟ Package Manager: pnpm
+∟ Monorepo: NX
+∟ Backend: Fastify
+∟ Frontend: React
+
+⚠️ Próximos Passos:
+1. Configurar OPENAI_API_KEY em Settings > Secrets
+2. Testar com um PR de teste
+
+🚀 Comando: /git/code-review validate
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Validação com Issues
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+⚠️ CODE REVIEW - ISSUES ENCONTRADOS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🔴 Críticos:
+∟ Secret OPENAI_API_KEY não configurado
+
+🟡 Importantes:
+∟ Versão do action desatualizada (usar @v1.2.0)
+
+💡 Sugestões:
+∟ Adicionar filtro de arquivos .ts/.tsx
+
+🔧 Auto-fix disponível? Sim
+Executar auto-fix? (s/n)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🔗 Referências
+
+- Checklist: `common/prompts/code-review-checklist.md`
+- Padrões Git: `common/prompts/git-workflow-patterns.md`
+- Agente: @code-reviewer para reviews manuais
+
+## ⚠️ Notas
+
+- Requer GitHub Actions habilitado
+- Secret `OPENAI_API_KEY` obrigatório
+- Funciona com qualquer stack JavaScript/TypeScript

package/templates/.onion/contexts/technical/commands/intermediate/docs-health.md

@@ -0,0 +1,142 @@
+---
+name: docs-health
+description: |
+  Health check completo da documentação do projeto.
+  Use para diagnóstico de qualidade, gaps e recomendações.
+model: sonnet
+
+parameters:
+  - name: path
+    description: Caminho para analisar (default: docs/)
+    required: false
+    default: docs/
+
+category: docs
+tags:
+  - health-check
+  - documentation
+  - quality
+
+version: "4.0.0"
+updated: "2025-12-20"
+
+related_commands:
+  - /docs/validate-docs
+  - /docs/build-tech-docs
+
+related_agents:
+  - system-documentation-orchestrator
+level: intermediate
+context: technical
+---
+
+# 🏥 Docs Health Check
+
+Verificação abrangente de saúde da documentação.
+
+## 🎯 Objetivo
+
+Fornecer diagnóstico completo com score, gaps e recomendações.
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: Coletar Métricas
+
+```bash
+# Contar arquivos de docs
+TOTAL=$(find {{path}} -name "*.md" | wc -l)
+
+# Verificar estrutura
+ls -la {{path}}/
+
+# Arquivos grandes (>500 linhas)
+find {{path}} -name "*.md" -exec wc -l {} \; | sort -rn | head -10
+```
+
+### Passo 2: Analisar Estrutura
+
+#### Checklist de Estrutura
+- [ ] README.md existe
+- [ ] Índice/navegação presente
+- [ ] Pastas organizadas por categoria
+- [ ] Naming consistente (kebab-case)
+
+### Passo 3: Avaliar Qualidade
+
+#### Critérios de Qualidade
+
+| Critério | Peso | Verificação |
+|----------|------|-------------|
+| Completude | 25% | Seções obrigatórias |
+| Consistência | 20% | Formatação uniforme |
+| Atualidade | 20% | Datas de update |
+| Links | 15% | Links funcionais |
+| Exemplos | 10% | Código de exemplo |
+| TOC | 10% | Table of contents |
+
+### Passo 4: Identificar Gaps
+
+```bash
+# Arquivos sem update recente (>90 dias)
+find {{path}} -name "*.md" -mtime +90
+
+# Arquivos pequenos (<50 linhas)
+find {{path}} -name "*.md" -exec wc -l {} \; | awk '$1<50'
+```
+
+### Passo 5: Calcular Score
+
+```
+Score = (Estrutura × 0.25) + (Qualidade × 0.25) + 
+        (Cobertura × 0.25) + (Atualidade × 0.25)
+```
+
+| Score | Status |
+|-------|--------|
+| 90-100 | 🟢 Excelente |
+| 70-89 | 🟡 Bom |
+| 50-69 | 🟠 Regular |
+| <50 | 🔴 Crítico |
+
+## 📤 Output Esperado
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🏥 DOCS HEALTH REPORT
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 Score Geral: 78/100 🟡
+
+📈 Métricas:
+∟ Arquivos: 45
+∟ Linhas: 12,450
+∟ Cobertura: 72%
+
+✅ Pontos Fortes:
+∟ Estrutura organizada
+∟ README completo
+∟ Exemplos presentes
+
+⚠️ Gaps Identificados:
+∟ 5 arquivos sem atualização >90d
+∟ API docs incompleta
+∟ Falta troubleshooting
+
+💡 Recomendações:
+1. Atualizar docs de API
+2. Adicionar seção troubleshooting
+3. Revisar arquivos antigos
+
+🎯 Meta: 85/100 (próximo quarter)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🔗 Referências
+
+- Validação: /docs/validate-docs
+- Agente: @system-documentation-orchestrator
+
+## ⚠️ Notas
+
+- Executar mensalmente para tracking
+- Score histórico salvo em `.cursor/metrics/`

package/templates/.onion/contexts/technical/commands/intermediate/fast-commit.md

@@ -0,0 +1,45 @@
+---
+name: fast-commit
+description: |
+  Adiciona todas as mudanças e faz commit rápido.
+  Use para commits típicos no fluxo do Sistema Onion.
+model: sonnet
+category: git
+tags: [git, commit, fast]
+version: "4.0.0"
+updated: "2025-12-20"
+level: intermediate
+context: technical
+---
+
+# Fast Commit
+
+Adiciona todas as mudanças e faz commit com mensagem especificada.
+
+## 🎯 Uso
+
+```bash
+/git/fast-commit "feat: implement admin dashboard basic flow"
+```
+
+## ⚡ Fluxo de Execução
+
+1. `git add .` — adiciona todas as mudanças
+2. `git commit -m "<mensagem>"` — commit com a mensagem
+
+## 📋 Convenção de Mensagens
+
+Use [Conventional Commits](https://conventionalcommits.org):
+
+| Tipo | Descrição |
+|------|-----------|
+| `feat:` | Nova funcionalidade |
+| `fix:` | Correção de bug |
+| `docs:` | Documentação |
+| `refactor:` | Refatoração |
+| `chore:` | Manutenção |
+
+## ⚠️ Notas
+
+- SEMPRE revise `git status` antes
+- Prefira commits atômicos e descritivos