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

package/templates/.onion/contexts/technical/commands/advanced/feature-start.md

@@ -0,0 +1,158 @@
+---
+name: start
+description: Iniciar feature branch GitFlow com ambiente configurado.
+model: sonnet
+category: git
+tags: [feature, gitflow, branch]
+version: "4.0.0"
+updated: "2025-12-20"
+level: advanced
+context: technical
+---
+
+# 🌿 Git Flow - Iniciar Feature
+
+Iniciar desenvolvimento de uma nova funcionalidade criando uma branch GitFlow apropriada e configurando ambiente de desenvolvimento. Integração obrigatória com @gitflow-specialist para guidance especializada.
+
+## 🎯 Funcionalidades
+
+### Criação Inteligente de Feature Branch
+- Criar branch GitFlow no formato `feature/nome-da-funcionalidade`
+- Detectar automaticamente branch base apropriada (develop/main)
+- Validar nomenclatura seguindo convenções GitFlow
+- Configurar tracking com repositório remoto quando disponível
+
+### Integração com @gitflow-specialist
+- Consultar especialista para análise do repositório atual
+- Receber estratégia de branching personalizada
+- Validar compliance com workflows da equipe
+- Guidance contextual para desenvolvimento
+
+### Session Management Automático
+- Criar diretório `.cursor/sessions/<feature-slug>/` automaticamente
+- Gerar `context.md` com metadados da feature
+- Criar `plan.md` com template de desenvolvimento
+- Integração opcional com ClickUp tasks existentes
+
+## 🚀 Como Usar
+
+```bash
+/git/feature/start "nome-da-funcionalidade"
+```
+
+### Exemplos de Nomenclatura
+```bash
+/git/feature/start "implement-oauth-authentication"
+/git/feature/start "add-user-dashboard-filters"  
+/git/feature/start "fix-payment-validation"
+/git/feature/start "update-api-documentation"
+```
+
+## 🤖 Integração com @gitflow-specialist
+
+Para cada nova feature:
+
+1. **Consultar @gitflow-specialist** para análise do estado atual do repositório
+2. **Receber estratégia** de criação de branch baseada no contexto
+3. **Validar nomenclatura** e compliance com padrões da equipe
+4. **Executar criação** seguindo as recomendações do especialista
+5. **Configurar ambiente** de desenvolvimento otimizado
+
+## 📋 Processo de Criação
+
+### Validações Pré-Criação
+- **Parameter check**: Verificar se nome da feature foi fornecido
+- **Repository check**: Confirmar que GitFlow está inicializado  
+- **Status check**: Garantir working directory limpo
+- **Naming validation**: Validar convenções de nomenclatura
+
+### Criação da Branch
+- **Base detection**: Identificar branch base apropriada (develop)
+- **Branch creation**: Criar `feature/nome` baseada na develop
+- **Remote setup**: Configurar tracking se repositório remoto disponível
+- **Checkout**: Trocar para a nova branch automaticamente
+
+### Setup do Ambiente
+- **Session creation**: Criar estrutura `.cursor/sessions/`
+- **Context setup**: Gerar arquivos de contexto e planejamento
+- **ClickUp integration**: Conectar com tasks existentes se detectadas
+- **Development ready**: Ambiente pronto para desenvolvimento
+
+## ⚙️ Estrutura Criada
+
+### Branch GitFlow
+```
+feature/nome-da-funcionalidade ← nova branch
+├── baseada em: develop (branch de desenvolvimento)  
+├── tracking: origin/feature/nome (se remoto disponível)
+└── estado: pronta para desenvolvimento
+```
+
+### Session Directory
+```
+.cursor/sessions/nome-da-funcionalidade/
+├── context.md          # Metadados e objetivos da feature
+├── plan.md            # Plano de desenvolvimento estruturado  
+├── notes.md           # Notas de desenvolvimento
+└── (outros arquivos conforme necessário)
+```
+
+## ✅ Resultado da Execução
+
+Após execução bem-sucedida:
+
+- ✅ **Feature branch criada** no padrão GitFlow
+- ✅ **Branch checkout realizado** automaticamente
+- ✅ **Session configurada** com estrutura completa
+- ✅ **Ambiente pronto** para desenvolvimento
+- ✅ **Próximos passos** fornecidos contextualmente
+
+## 🔄 Fluxo de Desenvolvimento Sugerido
+
+Após criar a feature:
+
+1. **Desenvolvimento**: Implementar funcionalidade na branch criada
+2. **Commits frequentes**: Usar conventional commits para histórico limpo
+3. **Push regular**: `git push` para backup e colaboração  
+4. **Compartilhamento**: `/git/feature/publish` para code review
+5. **Finalização**: `/git/feature/finish` quando completo
+
+## ⚠️ Tratamento de Problemas
+
+### GitFlow não inicializado
+**Problema**: Repository não tem GitFlow configurado
+**Solução**: Execute `/git/init` primeiro para configurar GitFlow
+
+### Nome de feature inválido
+**Problema**: Nome não segue convenções ou contém caracteres inválidos
+**Solução**: Use nomes descritivos em kebab-case (letras, números, hífen)
+
+### Working directory não limpo
+**Problema**: Há mudanças não commitadas no repositório
+**Solução**: Commit ou stash mudanças antes de criar nova feature
+
+### Feature branch já existe
+**Problema**: Já existe branch com mesmo nome
+**Solução**: Use nome diferente ou finalize feature existente primeiro
+
+### Branch develop não encontrada
+**Problema**: Branch develop não existe (GitFlow mal configurado)
+**Solução**: @gitflow-specialist fornecerá estratégia de resolução
+
+## 💡 Melhores Práticas
+
+### Nomenclatura de Features
+- **Descritiva**: Nome deve explicar claramente a funcionalidade
+- **Kebab-case**: Use hífens para separar palavras
+- **Concisa**: Evite nomes muito longos, máximo 50 caracteres
+- **Sem prefixos**: Não usar "feature-" pois já está no path da branch
+
+### Desenvolvimento
+- **Commits atômicos**: Commits pequenos e focados
+- **Conventional commits**: Seguir padrão (feat:, fix:, docs:, etc.)
+- **Push frequente**: Backup regular do trabalho
+- **Testes**: Implementar testes conforme desenvolvimento
+
+---
+
+*Este comando sempre consulta @gitflow-specialist para garantir criação otimizada e compliance com padrões da equipe.*

package/templates/.onion/contexts/technical/commands/advanced/hotfix-finish.md

@@ -0,0 +1,98 @@
+---
+name: finish
+description: Finalizar hotfix com merge para main e develop, tag e deploy.
+model: sonnet
+category: git
+tags: [hotfix, gitflow, deploy]
+version: "4.0.0"
+updated: "2025-12-20"
+level: advanced
+context: technical
+---
+
+# ✅ Git Flow - Finalizar Hotfix
+
+Finalizar correção emergencial realizando deploy para produção com merge em main/master e develop, criação de tags emergenciais e cleanup. Workflow crítico para release de emergency fixes.
+
+## 🎯 Funcionalidades  
+
+### Emergency Release e Deployment
+- Merge emergencial de hotfix branch para main/master
+- Back-merge imediato para develop branch
+- Criação automática de emergency patch tags
+- Deploy preparation para production environment
+- Cleanup automático pós-deployment
+
+### Production Safety e Validation
+- Validações críticas pré-merge para produção
+- Emergency conflict detection e resolution guidance
+- Production readiness verification
+- Rollback preparation automática
+- Emergency testing validation
+
+### Critical Operations Management
+- ClickUp task completion com emergency status
+- Team notification de emergency deployment
+- Emergency documentation automática
+- Production deployment tracking
+- Integration com CI/CD emergency pipelines
+
+## 🚀 Como Usar
+
+```bash
+/git/hotfix/finish                        # Auto-detecta hotfix atual
+/git/hotfix/finish fix-payment-gateway    # Finaliza hotfix específica  
+```
+
+**Pré-requisitos**: Em hotfix branch ou especificar nome da correção
+
+### Processo Executado
+1. **Emergency Detection**: Detecta hotfix branch atual ou busca específica
+2. **Critical Validation**: Verifica hotfix state, conflicts, production readiness
+3. **Production Preview**: Exibe impacto do emergency deployment
+4. **Emergency Confirmation**: Solicita confirmação para production release
+5. **Production Merge**: Executa merge para main + back-merge para develop
+6. **Emergency Tagging**: Cria patch tag com emergency release notes
+7. **Production Deploy**: Prepara deployment e atualiza ClickUp status
+8. **Emergency Cleanup**: Remove hotfix branch e finaliza emergency workflow
+
+### Emergency Deployment Strategy
+Durante finalização emergencial:
+- Production merge: Emergency-optimized merge strategy
+- Conflict handling: Priority resolution guidance
+- Tag creation: Emergency patch version increment
+- Team communication: Immediate notification de production changes
+
+## 🤝 Integração @gitflow-specialist
+
+*Este comando sempre consulta @gitflow-specialist para emergency merge validation, critical conflict resolution, production deployment strategy e troubleshooting de emergency release complexos.*
+
+## ⚠️ Resolução de Problemas
+
+### Hotfix Branch Not Found
+- **Sintoma**: Não consegue detectar hotfix branch ativa
+- **Solução**: `git checkout hotfix/name` ou especificar nome no comando
+
+### Emergency Merge Conflicts
+- **Causa**: Conflicts críticos entre hotfix e production branches
+- **Fix**: Emergency resolution guidance via @gitflow-specialist
+
+### Production Branch Protection
+- **Sintoma**: Branch protection impede emergency merge
+- **Solução**: Emergency override procedures ou Pull Request workflow
+
+### Critical Tests Failing
+- **Causa**: Emergency tests falham durante validation
+- **Fix**: Emergency test strategy ou production override (com approval)
+
+### Emergency Tag Creation Failed
+- **Sintoma**: Problemas na criação de emergency patch tags
+- **Solução**: @gitflow-specialist orienta sobre tag strategy e conflicts
+
+### Production Deployment Issues
+- **Causa**: Problemas durante emergency deployment preparation
+- **Fix**: Emergency deployment guidance e rollback preparation
+
+### Team Notification Failed  
+- **Sintoma**: ClickUp ou team notifications não funcionando
+- **Solução**: Manual emergency communication + @gitflow-specialist guidance

package/templates/.onion/contexts/technical/commands/advanced/hotfix-start.md

@@ -0,0 +1,94 @@
+---
+name: start
+description: Iniciar hotfix branch para correção emergencial em produção.
+model: sonnet
+category: git
+tags: [hotfix, gitflow, emergency]
+version: "4.0.0"
+updated: "2025-12-20"
+level: advanced
+context: technical
+---
+
+# 🚨 Git Flow - Iniciar Hotfix
+
+Iniciar correção emergencial criando hotfix branch a partir de main/master para resolver problemas críticos em produção. Workflow otimizado para máxima velocidade com validações de segurança essenciais.
+
+## 🎯 Funcionalidades
+
+### Emergency Hotfix Workflow
+- Criação imediata de hotfix branch a partir de main/master (produção)
+- Auto-versioning para patch releases emergenciais
+- ClickUp task urgente com prioridade máxima automática
+- Validações críticas de estado de produção
+- Setup otimizado para correção imediata
+
+### Safety-First Emergency Operations
+- Detecção automática de primary branch (main/master)
+- Validações essenciais de working directory
+- Emergency override para uncommitted changes
+- Rollback preparation automática
+- Emergency documentation e tracking setup
+
+### Criticidade e Tracking Urgente
+- Tags de urgência automáticas no ClickUp
+- Notificações escaladas para team awareness
+- Emergency workflow prioritization
+- Integration com @gitflow-specialist para emergency guidance
+- Automated emergency documentation
+
+## 🚀 Como Usar
+
+```bash
+/git/hotfix/start "fix-payment-gateway"    # Emergency payment fix
+/git/hotfix/start "security-patch-auth"    # Security hotfix
+/git/hotfix/start "critical-memory-leak"   # Performance emergency
+/git/hotfix/start "api-timeout-fix"        # API emergency
+```
+
+**Pré-requisitos**: Nome da correção obrigatório, repositório Git válido
+
+### Processo Executado
+1. **Emergency Validation**: Verifica nome hotfix, repository state, critical validations
+2. **Primary Branch Detection**: Detecta main/master automaticamente
+3. **Emergency Override**: Handles uncommitted changes com emergency stashing
+4. **Hotfix Branch Creation**: Cria hotfix/name branch a partir de produção
+5. **ClickUp Emergency Setup**: Cria task urgente com máxima prioridade
+6. **Team Notification**: Alerta equipe sobre emergency fix em andamento
+
+### Emergency Features
+Durante execução emergencial:
+- Working directory: Emergency stash se necessário
+- Branch detection: Main/master identification automática  
+- Priority escalation: ClickUp task com urgência máxima
+- Team alerts: Notification automática de emergency workflow
+
+## 🤝 Integração @gitflow-specialist
+
+*Este comando sempre consulta @gitflow-specialist para emergency workflow guidance, critical branch validation, hotfix strategy optimization e troubleshooting de situações emergenciais complexas.*
+
+## ⚠️ Resolução de Problemas
+
+### Hotfix Name Required
+- **Sintoma**: Comando executado sem nome da correção
+- **Solução**: Fornecer nome descritivo da correção emergencial
+
+### Uncommitted Changes Emergency
+- **Causa**: Working directory não limpo durante emergency
+- **Fix**: Comando oferece emergency stash automático ou manual commit
+
+### Primary Branch Detection Failed  
+- **Sintoma**: Não consegue detectar main/master branch
+- **Solução**: @gitflow-specialist fornece detection strategy para repository
+
+### Not Git Repository
+- **Causa**: Executado fora de repositório Git válido
+- **Fix**: `git init && /git/init` para emergency setup
+
+### Emergency Override Issues
+- **Sintoma**: Problemas durante emergency workflow execution
+- **Solução**: @gitflow-specialist fornece emergency guidance específica
+
+### Critical State Validation Failed
+- **Causa**: Repository em estado inconsistente para hotfix
+- **Fix**: Emergency validation guidance via @gitflow-specialist consultation

package/templates/.onion/contexts/technical/commands/advanced/hotfix.md

@@ -0,0 +1,186 @@
+---
+name: hotfix
+description: |
+  Emergency workflow completo: task ClickUp + branch hotfix + desenvolvimento.
+  Use para correções urgentes em produção.
+model: sonnet
+
+parameters:
+  - name: description
+    description: Descrição do hotfix
+    required: true
+  - name: related_tasks
+    description: IDs de tasks relacionadas (comma-separated)
+    required: false
+  - name: tags
+    description: Tags adicionais (comma-separated)
+    required: false
+
+category: engineer
+tags:
+  - hotfix
+  - emergency
+  - gitflow
+
+version: "4.0.0"
+updated: "2025-12-20"
+
+related_commands:
+  - /git/hotfix/start
+  - /git/hotfix/finish
+  - /product/task
+
+related_agents:
+  - gitflow-specialist
+  - clickup-specialist
+level: advanced
+context: technical
+---
+
+# 🔥 Engineer Hotfix
+
+Emergency workflow completo: Task + Branch + Desenvolvimento.
+
+## 🎯 Objetivo
+
+Executar workflow de hotfix end-to-end em um único comando.
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: Validar Input
+
+```bash
+# Verificar descrição
+if [ -z "{{description}}" ]; then
+  echo "❌ Descrição obrigatória"
+  exit 1
+fi
+
+# Verificar branch atual
+CURRENT=$(git branch --show-current)
+if [[ ! "$CURRENT" =~ ^(main|master|develop)$ ]]; then
+  echo "⚠️ Recomendado: iniciar de main/master"
+fi
+```
+
+### Passo 2: Criar Task Emergencial
+
+Via ClickUp MCP:
+
+```yaml
+name: "🔥 HOTFIX: {{description}}"
+list_id: [lista de hotfixes]
+priority: urgent
+tags:
+  - hotfix
+  - urgent
+  - {{tags}}
+status: "In Progress"
+markdown_description: |
+  ## 🚨 Emergency Hotfix
+  
+  **Descrição**: {{description}}
+  
+  ## 📋 Checklist
+  - [ ] Diagnóstico
+  - [ ] Implementação
+  - [ ] Testes
+  - [ ] Deploy
+```
+
+### Passo 3: Criar Branch Hotfix
+
+```bash
+# Garantir main atualizada
+git checkout main
+git pull origin main
+
+# Criar hotfix branch
+VERSION=$(cat package.json | grep version | head -1 | awk -F'"' '{print $4}')
+PATCH=$(echo $VERSION | awk -F. '{print $1"."$2"."$3+1}')
+BRANCH="hotfix/$PATCH-$(echo '{{description}}' | tr ' ' '-' | tr '[:upper:]' '[:lower:]' | head -c 30)"
+
+git checkout -b $BRANCH
+```
+
+### Passo 4: Setup Session
+
+```bash
+# Criar sessão de desenvolvimento
+mkdir -p .cursor/sessions/hotfix-$(date +%Y%m%d)/
+
+# Criar context.md
+cat > .cursor/sessions/hotfix-$(date +%Y%m%d)/context.md << EOF
+# Hotfix Context
+
+## Task
+- ID: [task_id criado]
+- URL: [url do clickup]
+
+## Branch
+- Nome: $BRANCH
+- Base: main
+
+## Descrição
+{{description}}
+EOF
+```
+
+### Passo 5: Iniciar Desenvolvimento
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔥 HOTFIX INICIADO
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📋 Task: [URL do ClickUp]
+🌿 Branch: hotfix/X.X.X-description
+
+⚡ Próximos Passos:
+1. Implementar correção
+2. Testar localmente
+3. /engineer/pre-pr
+4. /git/hotfix/finish
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 📤 Output Esperado
+
+### Sucesso
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ HOTFIX SETUP COMPLETO
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📋 ClickUp:
+∟ Task: 🔥 HOTFIX: {{description}}
+∟ ID: 86adfxxxx
+∟ Status: In Progress
+∟ Priority: Urgent
+
+🌿 Git:
+∟ Branch: hotfix/1.2.3-fix-description
+∟ Base: main
+∟ Remote: origin
+
+📁 Session:
+∟ Path: .cursor/sessions/hotfix-20251124/
+
+🚀 Comandos:
+∟ Desenvolver: /engineer/work
+∟ Pre-PR: /engineer/pre-pr
+∟ Finalizar: /git/hotfix/finish
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🔗 Referências
+
+- Padrões: `common/prompts/git-workflow-patterns.md`
+- Agente: @gitflow-specialist
+
+## ⚠️ Notas
+
+- Sempre parte de `main` ou `master`
+- Task criada com prioridade máxima
+- Merge automático para main E develop no finish

package/templates/.onion/contexts/technical/commands/advanced/refine-vision.md

@@ -0,0 +1,27 @@
+---
+name: refine-vision
+description: Refinar visão e estratégia do produto/projeto.
+model: sonnet
+category: docs
+tags: [vision, strategy, refinement]
+version: "4.0.0"
+updated: "2025-12-20"
+level: advanced
+context: technical
+---
+
+# Refinar Visão do Projeto
+
+Ajudar a refinar e documentar a visão estratégica do projeto.
+
+## 🎯 Objetivo
+
+Clarificar e documentar a visão, missão e objetivos estratégicos.
+
+## ⚡ Processo
+
+1. Revisar documentação existente de visão
+2. Fazer perguntas de esclarecimento
+3. Documentar insights e decisões
+4. Gerar documento de visão atualizado
+

package/templates/.onion/contexts/technical/commands/advanced/release-finish.md

@@ -0,0 +1,98 @@
+---
+name: finish
+description: Finalizar release com merge, tag e publicação.
+model: sonnet
+category: git
+tags: [release, gitflow, deploy]
+version: "4.0.0"
+updated: "2025-12-20"
+level: advanced
+context: technical
+---
+
+# ✅ Git Flow - Finalizar Release
+
+Finalizar processo de release realizando merge seguro para main/master e develop, criação de tags, publicação e cleanup. Workflow completo de release deployment com validações automáticas e ClickUp integration.
+
+## 🎯 Funcionalidades
+
+### Release Completion e Merge Strategy
+- Merge seguro de release branch para main/master branch
+- Back-merge para develop branch mantendo sincronização
+- Criação automática de tags anotadas com release notes
+- Validações pré-merge (conflicts, tests, working directory)
+- Cleanup automático de release branch após finalização
+
+### Publishing e Deployment Integration  
+- Tag publishing para remote repository
+- Release notes generation baseada em changelog
+- ClickUp task completion e status updates
+- Team notification via release completion workflow
+- Integration com CI/CD pipelines através de tags
+
+### Safety-First e Validações
+- Confirmação obrigatória antes de merge para main
+- Análise de impacto completa (commits, files, changes)
+- Validação de release branch state e readiness
+- Preview detalhado das mudanças que serão mergeadas
+- Rollback guidance caso problemas sejam detectados
+
+## 🚀 Como Usar
+
+```bash
+/git/release/finish                   # Auto-detecta release branch atual
+/git/release/finish v2.1.0           # Finaliza release específica
+```
+
+**Pré-requisitos**: Em release branch ou especificar versão da release
+
+### Processo Executado
+1. **Detection**: Detecta release branch atual ou busca por versão específica
+2. **Validations**: Verifica release branch state, conflicts, working directory
+3. **Preview**: Exibe impacto do merge (commits, files, deployment implications)
+4. **Confirmation**: Solicita confirmação explícita para merge em main
+5. **Merge Strategy**: Executa merge para main + back-merge para develop
+6. **Tag Creation**: Cria tag anotada com release notes automáticas
+7. **Publishing**: Publica tags e atualiza remote branches
+8. **Cleanup**: Remove release branch e atualiza ClickUp completion
+
+### Merge Strategy Intelligence
+Durante execução, aplica strategy inteligente:
+- Main merge: Fast-forward quando possível, merge commit quando necessário
+- Develop back-merge: Garante sincronização sem perder desenvolvimento
+- Conflict detection: Identifica e orienta resolução antes do merge
+- Tag management: Cria tags consistentes com convention estabelecida
+
+## 🤝 Integração @gitflow-specialist
+
+*Este comando sempre consulta @gitflow-specialist para merge strategy validation, conflict resolution guidance, tag creation best practices e troubleshooting de release deployment complexo.*
+
+## ⚠️ Resolução de Problemas
+
+### Release Branch Not Found
+- **Sintoma**: Não consegue detectar release branch ativa
+- **Solução**: `git checkout release/version` ou especificar versão no comando
+
+### Merge Conflicts Detected
+- **Causa**: Conflicts entre release branch e main/develop
+- **Fix**: Resolver conflicts manualmente antes de finalizar release
+
+### Uncommitted Changes in Release
+- **Sintoma**: Release branch tem changes não commitadas
+- **Solução**: `git add . && git commit -m "final release changes"`
+
+### Tag Already Exists
+- **Causa**: Tag da versão já existe no repository
+- **Fix**: Usar `git tag -d tagname` para remover ou escolher versão diferente
+
+### Main Branch Protection
+- **Sintoma**: Branch protection impede merge direto
+- **Solução**: Usar Pull Request workflow ou ajustar branch protection
+
+### Tests Failing in Release
+- **Causa**: Release branch não passa nos testes automatizados
+- **Fix**: Corrigir testes ou usar override com approval (não recomendado)
+
+### Remote Publishing Issues
+- **Sintoma**: Problemas ao publicar tags ou branches
+- **Solução**: @gitflow-specialist orienta sobre remote configuration e permissions