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

package/templates/.onion/contexts/business/commands/starter/warm-up.md

@@ -0,0 +1,187 @@
+---
+name: warm-up
+description: |
+  Preparação de contexto de produto e negócio.
+  Foca em documentação de produto, especificações, knowledge bases de negócio e frameworks de produto.
+model: sonnet
+category: product
+tags: [warmup, context, product, business]
+version: "4.0.0"
+updated: "2025-12-20"
+level: starter
+context: business
+---
+
+# 🔥 Warm-up de Produto
+
+Preparação específica para trabalho de produto, negócio e gestão de features.
+
+## 🎯 Objetivo
+
+Estabelecer contexto focado em:
+- Documentação de produto e negócio
+- Especificações de features e domínios
+- Knowledge bases de produto
+- Frameworks de produto (Story Points, etc)
+- Comandos e agentes de produto
+
+## 📋 Checklist de Preparação
+
+### 1. Contexto Geral (Base)
+- ✅ Revisar `README.md` para visão geral do Sistema Onion
+- ✅ Entender estrutura de documentação em `docs/`
+
+### 2. Meta Especificações
+- ✅ Revisar `docs/meta-specs/index.md`
+- ✅ Memorizar hierarquia de especificações
+- ✅ Entender quando consultar meta specs para decisões de produto
+
+### 3. Documentação de Produto
+- ✅ Revisar `docs/onion/commands-guide.md` - Seção "Comandos de Produto"
+- ✅ Mapear comandos de produto disponíveis:
+
+**Gestão de Tasks:**
+- `/product/task` - Criar tasks com estimativas automáticas
+- `/product/feature` - Criar tasks de feature para backlog
+- `/product/collect` - Coletar ideias de features/bugs
+- `/product/task-check` - Verificar status de tasks
+- `/product/validate-task` - Validar tasks contra meta-specs
+- `/product/checklist-sync` - Sincronizar checklists
+
+**Especificação e Refinamento:**
+- `/product/spec` - Especificações técnicas
+- `/product/refine` - Refinamento de requisitos
+- `/product/estimate` - Estimar story points
+- `/product/light-arch` - Arquitetura leve
+
+**Processamento de Reuniões:**
+- `/product/extract-meeting` - Extrair insights de reuniões (Framework EXTRACT)
+- `/product/consolidate-meetings` - Consolidar múltiplas reuniões
+
+**Análise e Validação:**
+- `/product/check` - Verificar requisitos contra meta-specs
+- `/product/analyze-pain-price` - Analisar dor do cliente e precificação
+
+**Comunicação:**
+- `/product/branding` - Trabalhar em branding e posicionamento
+- `/product/presentation` - Criar apresentações
+
+**Documentação Relacionada:**
+- `/docs/consolidate-documents` - Consolidar documentos de produto/negócio
+
+### 4. Knowledge Bases de Produto
+- ✅ Revisar `docs/knowbase/frameworks/framework_story_points.md`
+- ✅ Revisar `docs/knowbase/concepts/task-manager-abstraction.md`
+- ✅ Revisar `docs/knowbase/concepts/meeting-transcription-to-knowledge-base.md`
+- ✅ Revisar `docs/knowbase/concepts/identificar-precificar-dor-cliente.md`
+- ✅ Revisar `docs/knowbase/concepts/branding-posicionamento-marca.md`
+
+### 5. Agentes de Produto
+- ✅ Conhecer agentes especializados:
+  - `@product-agent` - Orquestração estratégica
+  - `@story-points-framework-specialist` - Estimativas ágeis
+  - `@extract-meeting-specialist` - Extração de reuniões
+  - `@meeting-consolidator` - Consolidação de reuniões
+  - `@storytelling-business-specialist` - Narrativas de negócio
+  - `@branding-positioning-specialist` - Branding e posicionamento
+
+### 6. Task Manager Integration
+- ✅ Verificar `TASK_MANAGER_PROVIDER` no `.env`
+- ✅ Entender abstração de Task Manager (ClickUp, Asana, Linear)
+- ✅ Revisar `docs/knowbase/concepts/task-manager-abstraction.md`
+
+### 7. Especificações de Features
+- ✅ Mapear estrutura de especificações:
+  - Domain Specs (L1) - Regras de negócio
+  - Feature Specs (L2) - Especificações de features
+- ✅ Entender formato de especificações do projeto
+
+## 🔍 Contexto Específico de Produto
+
+### Documentação Essencial
+- `docs/onion/commands-guide.md` - Comandos de produto
+- `docs/onion/practical-examples.md` - Exemplos práticos
+- `docs/knowbase/frameworks/framework_story_points.md` - Framework de estimativas
+- `docs/knowbase/concepts/meeting-transcription-to-knowledge-base.md` - Processamento de reuniões
+
+### Workflows de Produto
+
+**Workflow Completo de Feature:**
+1. **Coletar**: `/product/collect` → Coletar ideias de features/bugs
+2. **Criar Task**: `/product/task` → Cria com story points automáticos
+3. **Criar Feature**: `/product/feature` → Criar task de feature para backlog
+4. **Validar**: `/product/check` → Verificar requisitos contra meta-specs
+5. **Especificar**: `/product/spec` → Documenta feature completa
+6. **Estimar**: `/product/estimate` → Ajusta estimativas
+7. **Refinar**: `/product/refine` → Recalcula estimativas após mudanças
+8. **Arquitetura**: `/product/light-arch` → Arquitetura leve da feature
+
+**Workflow de Reuniões:**
+1. **Extrair Reunião**: `/product/extract-meeting` → Framework EXTRACT (7 dimensões)
+2. **Consolidar**: `/product/consolidate-meetings` → Análise de múltiplas reuniões
+3. **Consolidar Docs**: `/docs/consolidate-documents` → Consolidar documentos relacionados
+
+**Workflow de Validação:**
+1. **Validar Task**: `/product/validate-task` → Validar task contra meta-specs
+2. **Verificar**: `/product/task-check` → Verificar status e completude
+3. **Sincronizar**: `/product/checklist-sync` → Sincronizar checklists com Task Manager
+
+**Workflow de Análise:**
+1. **Analisar Dor**: `/product/analyze-pain-price` → Analisar dor do cliente e precificação
+2. **Branding**: `/product/branding` → Trabalhar em branding e posicionamento
+3. **Apresentação**: `/product/presentation` → Criar apresentações
+
+## 💡 Quando Usar Este Warm-up
+
+- ✅ Trabalho em especificações de features
+- ✅ Criação ou refinamento de tasks (`/product/task`, `/product/feature`, `/product/collect`)
+- ✅ Estimativas de story points (`/product/estimate`)
+- ✅ Processamento de reuniões (`/product/extract-meeting`, `/product/consolidate-meetings`)
+- ✅ Consolidação de documentos (`/docs/consolidate-documents`)
+- ✅ Análise de requisitos de negócio (`/product/check`, `/product/validate-task`)
+- ✅ Análise de dor do cliente (`/product/analyze-pain-price`)
+- ✅ Trabalho com Product Owners
+- ✅ Branding e posicionamento (`/product/branding`)
+- ✅ Criação de apresentações (`/product/presentation`)
+
+## 🔗 Integração com Engenharia
+
+Após preparar contexto de produto:
+- Tasks criadas são validadas por `/engineer/start`
+- Story points são verificados antes de iniciar desenvolvimento
+- Especificações alimentam sessões de engenharia
+
+## ⚠️ Notas
+
+- Foco em contexto de negócio e produto, não técnico
+- Mantenha conhecimento de frameworks de produto no contexto
+- Use agentes especializados para tarefas específicas
+- Sempre sincronize tasks com Task Manager configurado
+
+
+
+---
+
+## 🚀 Próximos Passos
+
+Agora que você preparou o contexto, comece o trabalho:
+
+1. **Criar nova especificação**:
+   ```bash
+   /business/spec "feature-name"
+   ```
+   O contexto carregado ajudará a criar specs mais completas.
+
+2. **Extrair informações de reunião**:
+   ```bash
+   /business/extract-meeting
+   ```
+   Use para documentar decisões e ações de meetings recentes.
+
+3. **Explorar comandos intermediate**:
+   ```bash
+   /business/help --level=intermediate
+   ```
+   Descubra workflows mais avançados como `/business/feature` (spec + tasks em um comando).
+
+💡 **Dica**: Warm-up é especialmente útil ao retomar trabalho após pausas ou ao entrar em novo projeto.

package/templates/.onion/contexts/technical/.context-config.yml

@@ -0,0 +1,64 @@
+# Technical Context Configuration
+# Onion v4.0 - Multi-Context Development Orchestrator
+
+context:
+  name: technical
+  description: Development, Testing, Git, Documentation workflows
+  version: "4.0.0"
+  created: "2025-12-20"
+
+commands:
+  prefix: /technical
+  levels:
+    starter: 10      # 80% dos casos de uso
+    intermediate: 15 # 15% dos casos de uso
+    advanced: 7      # 5% dos casos de uso
+
+agents:
+  - react-developer
+  - nodejs-specialist
+  - postgres-specialist
+  - zen-engine-specialist
+  - nx-monorepo-specialist
+  - nx-migration-specialist
+  - gitflow-specialist
+  - cursor-specialist
+  - c4-architecture-specialist
+  - c4-documentation-specialist
+  - mermaid-specialist
+  - system-doc-orchestrator
+  - docs-reverse-engineer
+  - linux-security-specialist
+  - runflow-specialist
+  - test-engineer
+  - test-planner
+  - test-agent
+  - code-reviewer
+  - branch-code-reviewer
+  - branch-doc-writer
+  - branch-metaspec-checker
+  - branch-test-planner
+
+integrations:
+  version_control:
+    provider: git
+    strategy: gitflow
+  testing:
+    unit: jest
+    integration: supertest
+    e2e: playwright
+  documentation:
+    format: c4-model
+    generator: mermaid
+  
+onboarding:
+  estimated_time: 30 minutes
+  required_reading:
+    - .onion/contexts/technical/README.md
+    - docs/meta-specs/
+  starter_commands:
+    - /technical/work "task-id"
+    - /technical/plan "feature"
+    - /technical/pr
+    - /technical/sync
+    - /technical/docs

package/templates/.onion/contexts/technical/README.md

@@ -0,0 +1,238 @@
+# Technical Context
+
+> **Onion v4.0** | Multi-Context Development Orchestrator
+
+**📚 Sistema de Níveis**: Leia `docs/onion/levels-system.md` para entender a filosofia 80/15/5
+
+---
+
+## 🎯 Sobre Este Contexto
+
+O **Technical Context** é dedicado a Developers, DevOps, QA Engineers, e todos os profissionais que trabalham com:
+
+- 💻 **Desenvolvimento de código**
+- 🧪 **Testes (unit, integration, e2e)**
+- 🔀 **Git workflows (gitflow, branches, PRs)**
+- 📚 **Documentação técnica**
+- 🏗️ **Arquitetura e design**
+- 🚀 **Deploy e CI/CD**
+
+---
+
+## 🚀 Quick Start
+
+### Comandos Starter (80% dos casos)
+
+Use estes comandos para 80% das suas necessidades diárias:
+
+```bash
+/technical/work "minha-task"        # Iniciar trabalho em uma task
+/technical/plan "feature-x"         # Planejar implementação técnica
+/technical/pr                       # Criar Pull Request
+/technical/sync                     # Sincronizar branch com main
+/technical/docs                     # Gerar documentação técnica
+```
+
+### Comandos Intermediate (15% dos casos)
+
+Para workflows mais avançados:
+
+```bash
+/technical/start                    # Iniciar sessão de desenvolvimento
+/technical/pre-pr                   # Preparar para PR
+/technical/code-review              # Review de código
+/technical/build-index              # Construir índice de docs
+/technical/unit                     # Executar testes unitários
+/technical/integration              # Executar testes de integração
+```
+
+### Comandos Advanced (5% dos casos)
+
+Para casos especializados:
+
+```bash
+/technical/hotfix                   # Criar hotfix urgente
+/technical/bump                     # Bump de versão
+/technical/consolidate-documents    # Consolidar documentação
+/technical/e2e                      # Executar testes end-to-end
+```
+
+---
+
+## 🤖 Agentes Especializados
+
+Invoque agentes especializados com `@nome-agente`:
+
+| Agente | Especialidade | Uso |
+|--------|--------------|-----|
+| @react-developer | React/TypeScript | Desenvolvimento frontend |
+| @nodejs-specialist | Node.js backend | Desenvolvimento backend |
+| @postgres-specialist | PostgreSQL | Banco de dados |
+| @zen-engine-specialist | ZenStack | Auth & access control |
+| @nx-monorepo-specialist | Nx monorepo | Workspace management |
+| @gitflow-specialist | Git workflows | Branching strategies |
+| @test-engineer | Testes | Estratégia de testes |
+| @code-reviewer | Code review | Revisão de código |
+| @cursor-specialist | Cursor IDE | Problemas de IDE |
+
+---
+
+## 📚 Estrutura
+
+```
+technical/
+├── commands/
+│   ├── starter/          # 10 comandos essenciais (80%)
+│   ├── intermediate/     # 15 comandos avançados (15%)
+│   └── advanced/         # 7 comandos especializados (5%)
+├── agents/               # 23 agentes especializados
+├── knowbase/             # Knowledge bases técnicas
+└── sessions/             # Sessions de desenvolvimento
+```
+
+---
+
+## 🔗 Integrações
+
+### Version Control
+- ✅ **Git** (gitflow)
+- ✅ GitHub
+- ✅ GitLab
+
+### Testing Frameworks
+- ✅ **Jest** (unit)
+- ✅ Playwright (e2e)
+- ✅ Supertest (integration)
+
+### Documentation
+- ✅ **C4 Model**
+- ✅ Mermaid
+- ✅ JSDoc/TSDoc
+
+---
+
+## 📖 Onboarding
+
+**Tempo estimado**: 30 minutos
+
+### Passo 1: Entenda os Comandos Starter (10 min)
+Leia e teste os 5 comandos starter principais:
+```bash
+/technical/work
+/technical/plan
+/technical/pr
+/technical/sync
+/technical/docs
+```
+
+### Passo 2: Conheça os Agentes (10 min)
+Invoque e converse com:
+```bash
+@react-developer
+@nodejs-specialist
+@gitflow-specialist
+```
+
+### Passo 3: Primeiro Workflow Completo (10 min)
+Execute um workflow end-to-end:
+```bash
+1. /technical/start "minha-feature"
+2. /technical/work
+3. /technical/pre-pr
+4. /technical/pr
+```
+
+---
+
+## 🎯 Workflows Comuns
+
+### Workflow 1: Nova Feature (30 min)
+```bash
+/technical/start "nome-da-feature"   # Criar session
+/technical/plan                      # Planejar arquitetura
+/technical/work                      # Implementar
+/technical/unit                      # Testar
+/technical/pre-pr                    # Validar
+/technical/pr                        # Criar PR
+```
+
+### Workflow 2: Hotfix Urgente (15 min)
+```bash
+/technical/hotfix "bug-critico"      # Criar branch hotfix
+/technical/work                      # Corrigir bug
+/technical/integration               # Testar
+/technical/pr                        # PR direto para main
+```
+
+### Workflow 3: Documentação Completa (20 min)
+```bash
+/technical/docs                      # Gerar docs técnicas
+/technical/build-index               # Construir índice
+/technical/validate-docs             # Validar consistência
+```
+
+---
+
+## 🔧 Configuração
+
+O arquivo `.context-config.yml` define integrações e preferências:
+
+```yaml
+context:
+  name: technical
+  version: "4.0.0"
+
+integrations:
+  version_control:
+    provider: git
+    strategy: gitflow
+  testing:
+    unit: jest
+    integration: supertest
+    e2e: playwright
+  documentation:
+    format: c4-model
+    generator: mermaid
+```
+
+---
+
+## 📊 Métricas
+
+| Métrica | Valor |
+|---------|-------|
+| **Comandos Totais** | 32 |
+| **Agentes** | 23 |
+| **Tempo Onboarding** | 30 min |
+| **Casos de Uso** | Dev, QA, DevOps, Docs |
+
+---
+
+## 🆘 Ajuda
+
+### Comandos Não Funcionam?
+1. Verifique se está no contexto correto: `/technical/help`
+2. Teste com warm-up: `/technical/warm-up`
+3. Consulte agente: `@react-developer "help with X"`
+
+### Testes Falhando?
+1. Verifique dependências: `nx affected:test`
+2. Consulte `@test-engineer`
+3. Execute: `/technical/unit` ou `/technical/integration`
+
+### Git Conflicts?
+1. Sincronize: `/technical/sync`
+2. Consulte: `@gitflow-specialist`
+3. Code review: `@code-reviewer`
+
+### Dúvidas?
+- 📖 Leia: `docs/onion/`
+- 🤖 Pergunte: `@react-developer` ou `@nodejs-specialist`
+- 🔧 CLI: `onion help technical`
+
+---
+
+**Versão**: 4.0.0  
+**Última Atualização**: 2025-12-20  
+**Migrado em**: FASE 2
+

package/templates/.onion/contexts/technical/agents/branch-code-reviewer.md

@@ -0,0 +1,200 @@
+---
+name: branch-code-reviewer
+description: |
+  Especialista em revisão de código pré-PR focado em mudanças do branch atual.
+  Use para análise de qualidade, bugs e best practices antes do merge.
+model: opus
+tools:
+  - read_file
+  - codebase_search
+  - grep
+  - run_terminal_cmd
+  - web_search
+  - todo_write
+
+color: green
+priority: alta
+category: git
+
+expertise:
+  - pre-pr-review
+  - branch-analysis
+  - code-quality
+  - best-practices
+
+related_agents:
+  - code-reviewer
+  - branch-test-planner
+
+related_commands:
+  - /engineer/pre-pr
+
+version: "4.0.0"
+updated: "2025-12-20"
+context: technical
+---
+
+Você é um revisor de código especialista encarregado de analisar mudanças de código em preparação para um pull request. Seu objetivo é fornecer feedback abrangente que ajude a garantir qualidade do código e prontidão para PR.
+
+## 🔍 Processo de Revisão
+
+### 1. Coletar Informações de Mudança
+Primeiro, entenda o que mudou:
+- Execute `git status` para ver mudanças não commitadas
+- Execute `git diff` para ver mudanças não staged
+- Execute `git diff --staged` para ver mudanças staged
+- Execute `git log origin/main..HEAD --oneline` para ver commits neste branch
+- Execute `git diff origin/main...HEAD` para ver todas as mudanças comparadas ao branch main
+
+### 2. Analisar Mudanças de Código
+Para cada arquivo alterado, avalie:
+
+**✅ Qualidade do Código & Melhores Práticas**
+- Estilo de código consistente com o projeto
+- Convenções de nomenclatura adequadas (código em inglês)
+- Organização e estrutura do código
+- Princípios DRY (Don't Repeat Yourself)
+- Princípios SOLID quando aplicável
+- Abstrações apropriadas
+- Comentários em pt-BR explicando lógica complexa
+
+**🐛 Bugs Potenciais**
+- Erros de lógica
+- Casos extremos não tratados
+- Verificações de null/undefined
+- Tratamento de erro adequado
+- Vazamentos de recursos
+- Condições de corrida (race conditions)
+
+**⚡ Considerações de Performance**
+- Algoritmos ineficientes
+- Computações desnecessárias
+- Preocupações de uso de memória
+- Otimização de consulta de banco de dados
+- Oportunidades de cache
+
+**🔒 Preocupações de Segurança**
+- Validação de entrada
+- Riscos de injeção SQL
+- Vulnerabilidades XSS
+- Problemas de autenticação/autorização
+- Exposição de dados sensíveis
+- Vulnerabilidades de dependência
+
+### 3. Revisão de Documentação
+Verifique se a documentação reflete as mudanças:
+- Atualizações de `README.md` para novas funcionalidades/mudanças
+- Documentação de API
+- Comentários de código em pt-BR para lógica complexa
+- Atualizações da pasta `docs/`
+- `CHANGELOG` ou notas de release
+- Conformidade com `.cursor/rules/language-and-documentation.mdc`
+
+### 4. Análise de Cobertura de Testes
+Avalie os testes:
+- Novas funcionalidades/mudanças estão testadas?
+- Casos extremos estão cobertos?
+- Testes existentes ainda passam?
+- Cobertura de testes é mantida ou melhorada?
+- Testes são significativos e não apenas para cobertura?
+
+## 📋 Formato de Saída
+
+Forneça uma revisão estruturada com:
+
+```markdown
+# Relatório de Code Review
+
+## Resumo
+[Status semafórico: 🟢 Verde / 🟡 Amarelo / 🔴 Vermelho]
+[Visão geral breve das mudanças e avaliação geral]
+
+## Mudanças Revisadas
+- [Lista de arquivos/funcionalidades revisadas]
+
+## Descobertas
+
+### 🔴 Problemas Críticos (Deve Corrigir)
+[Problemas que bloqueiam aprovação do PR]
+
+### 🟡 Recomendações (Deve Endereçar)
+[Melhorias importantes mas não bloqueantes]
+
+### 🟢 Observações Positivas
+[Boas práticas observadas]
+
+## Análise Detalhada
+
+### Qualidade do Código
+[Feedback específico sobre qualidade do código]
+
+### Segurança
+[Observações relacionadas à segurança]
+
+### Performance
+[Considerações de performance]
+
+### Documentação
+[Completude da documentação]
+
+### Cobertura de Testes
+[Avaliação dos testes]
+
+## Itens de Ação
+1. [Lista priorizada de mudanças necessárias]
+2. [Sugestões de melhoria]
+
+## Conclusão
+[Recomendação final e próximos passos]
+```
+
+## 📖 Diretrizes de Revisão
+
+- Seja construtivo e específico no feedback
+- Forneça exemplos ou sugestões de melhorias
+- Reconheça boas práticas observadas
+- Priorize problemas por impacto
+- Considere o contexto e padrões do projeto
+- Foque nas mudanças, não em todo o codebase
+- Valide conformidade com `.cursor/rules/language-and-documentation.mdc`:
+  - ✅ Código em inglês (variáveis, funções, classes, nomes de arquivos)
+  - ✅ Comentários em pt-BR
+  - ✅ Commits em inglês seguindo Conventional Commits
+  - ✅ Documentação em pt-BR
+
+## 🚦 Critérios do Semáforo
+
+**🟢 Luz Verde (Aprovado)**: 
+- Sem problemas críticos
+- Código segue padrões do projeto
+- Mudanças bem testadas
+- Documentação atualizada
+- Comentários em pt-BR, código em inglês
+- Pronto para PR
+
+**🟡 Luz Amarela (Aprovado com Ressalvas)**:
+- Problemas menores que devem ser endereçados
+- Faltam alguns testes ou documentação
+- Melhorias de performance possíveis
+- Pode prosseguir para PR com anotações
+
+**🔴 Luz Vermelha (Bloqueado)**:
+- Bugs críticos ou problemas de segurança
+- Mudanças significativas sem testes
+- Breaking changes sem plano de migração
+- Desvio importante dos padrões do projeto
+- Violação das regras de idioma (código não em inglês ou comentários não em pt-BR)
+- Deve corrigir antes do PR
+
+## ⚙️ Checklist de Conformidade
+
+Antes de aprovar, verificar:
+
+- [ ] Todo código (variáveis, funções, classes) está em inglês
+- [ ] Todos os comentários estão em português (pt-BR)
+- [ ] Commits seguem padrão Conventional Commits em inglês
+- [ ] Documentação atualizada quando necessário
+- [ ] Sintaxe oficial das bibliotecas foi respeitada
+- [ ] Nomes de arquivos e branches em inglês
+- [ ] Mensagens de erro para usuário final em pt-BR
+- [ ] Logs de debug em pt-BR quando aplicável