@onion-architect-ai/cli 4.1.0-beta.4 → 4.1.0-beta.5

package/templates/.cursor/commands/git/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/.cursor/commands/git/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/.cursor/commands/git/init.md

@@ -0,0 +1,139 @@
+---
+name: init
+description: Inicializar repositório com GitFlow e convenções padrão.
+model: sonnet
+category: git
+tags: [init, gitflow, setup]
+version: "4.0.0"
+updated: "2025-12-20"
+level: starter
+context: technical
+---
+
+# 🔧 Git Flow - Inicialização
+
+Configurar repositório Git com GitFlow seguindo as melhores práticas. Detectar automaticamente se deve usar `main` ou `master` como branch principal e configurar todas as branches e convenções necessárias.
+
+## 🎯 Funcionalidades
+
+### Detecção Automática Inteligente
+- Verificar se Git Flow já está inicializado  
+- Detectar branch principal existente (main/master) automaticamente
+- Configurar develop branch baseado na convenção detectada
+- Validar se repositório está em estado adequado para inicialização
+
+### Setup Seguro e Educativo
+- Configuração automática de prefixos GitFlow padrão (feature/, release/, hotfix/)
+- Verificações de integridade do repositório antes da inicialização
+- Criação da branch develop se não existir
+- Integração com @gitflow-specialist para guidance personalizada
+
+## 🚀 Como Usar
+
+```bash
+/git/init                    # Inicialização completa automática
+```
+
+## 🤖 Integração com @gitflow-specialist
+
+Para cada inicialização:
+
+1. **Consultar @gitflow-specialist** para análise do repositório atual
+2. **Receber estratégia** de inicialização baseada no contexto
+3. **Executar setup** seguindo as recomendações do especialista
+4. **Validar configuração** final e fornecer próximos passos
+
+## 📋 Processo de Inicialização
+
+### Verificações Pré-Inicialização
+- **Repository check**: Verificar se estamos em um repositório Git válido
+- **Status check**: Garantir que não há mudanças não commitadas
+- **Remote check**: Verificar configuração de repositório remoto
+- **GitFlow check**: Detectar se já está inicializado
+
+### Configuração Automática
+- **Branch detection**: Identificar main/master existente
+- **Develop setup**: Criar develop branch baseada na principal  
+- **Prefix configuration**: Configurar prefixos padrão GitFlow
+- **Validation**: Verificar configuração final
+
+## ⚙️ Configurações Aplicadas
+
+### Branches Principais
+```
+main/master  (produção) ← detectado automaticamente
+develop      (desenvolvimento) ← criado se não existir
+```
+
+### Prefixos de Branch
+```
+feature/     (novas funcionalidades)
+release/     (preparação de releases)
+hotfix/      (correções urgentes)
+```
+
+## ✅ Resultado da Inicialização
+
+Após execução bem-sucedida:
+
+- ✅ **Git Flow configurado** com branches apropriadas
+- ✅ **Branch develop criada** e configurada como development branch  
+- ✅ **Prefixos definidos** para todos os tipos de branch
+- ✅ **Configuração validada** e testada
+- ✅ **Próximos passos** fornecidos baseados no contexto
+
+## 🔄 Próximos Passos Sugeridos
+
+Após inicialização, o sistema recomendará:
+
+- **Primeira feature**: `/git/feature/start "nome-da-funcionalidade"`
+- **Sincronização**: `/git/sync` se houver repositório remoto
+- **Ajuda contextual**: `/git/help` para entender os workflows disponíveis
+
+## ⚠️ Tratamento de Problemas
+
+### Repository não é Git
+**Problema**: Pasta atual não é um repositório Git  
+**Solução**: Execute `git init` primeiro, depois `/git/init`
+
+### GitFlow já inicializado  
+**Problema**: GitFlow já está configurado
+**Resultado**: Mostra configuração atual e próximos passos sugeridos
+
+### Branch develop conflitante
+**Problema**: Já existe branch develop com conteúdo divergente
+**Solução**: @gitflow-specialist fornecerá estratégia de resolução
+
+### Repositório remoto não configurado
+**Problema**: Não há origin configurado
+**Resultado**: Configuração local apenas, com sugestão de setup remoto
+
+---
+
+*Este comando sempre consulta @gitflow-specialist para garantir inicialização otimizada para seu contexto específico.*
+
+---
+
+## 🚀 Próximos Passos
+
+Após inicializar o repositório:
+
+1. **Preparar primeiro commit**:
+   ```bash
+   /technical/fast-commit
+   ```
+   Cria commit inicial seguindo conventional commits.
+
+2. **Configurar documentação**:
+   ```bash
+   /technical/docs
+   ```
+   Gera README e docs técnicos iniciais.
+
+3. **Começar primeira feature**:
+   ```bash
+   /technical/start "setup-inicial"
+   ```
+   Inicia desenvolvimento estruturado desde o início.
+
+💡 **Dica**: Gitflow é recomendado para projetos colaborativos. Para solo dev, trunk-based pode ser mais simples.

package/templates/.cursor/commands/git/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

package/templates/.cursor/commands/git/release/start.md

@@ -0,0 +1,95 @@
+---
+name: start
+description: Iniciar release branch com versionamento e changelog.
+model: sonnet
+category: git
+tags: [release, gitflow, version]
+version: "4.0.0"
+updated: "2025-12-20"
+level: advanced
+context: technical
+---
+
+# 🚀 Git Flow - Iniciar Release
+
+Iniciar processo de release criando branch de release com versionamento automático, preparação de changelog e validações pré-release. Workflow completo para gestão segura de releases seguindo padrões GitFlow.
+
+## 🎯 Funcionalidades
+
+### Release Workflow e Versionamento
+- Criação de release branch a partir de develop branch
+- Auto-detecção e bump inteligente de versionamento (semver)
+- Preparação automática de changelog baseada em commits
+- Validações de estado pré-release (working directory, conflicts)
+- Setup de ClickUp task para release tracking completo
+
+### Versionamento Inteligente e Automação
+- Detecção automática de package.json e version files
+- Bump semântico (major.minor.patch) com validation
+- Support para diferentes tipos de projeto e convenções
+- Validações de tag conflicts e branch state
+- Integration com @gitflow-specialist para release strategy
+
+### Validações e Safety-First
+- Verificações de repository state e uncommitted changes
+- Primary branch detection (main/master) automática
+- Develop branch sync validation antes da release
+- Release branch creation com error handling robusto
+- Educational guidance durante processo de release
+
+## 🚀 Como Usar
+
+```bash
+/git/release/start "v2.1.0"           # Release com versão específica  
+/git/release/start "2.1.0"            # Versão sem prefixo v
+/git/release/start "patch"            # Auto-bump patch (2.0.1 → 2.0.2)
+/git/release/start "minor"            # Auto-bump minor (2.0.1 → 2.1.0) 
+/git/release/start "major"            # Auto-bump major (2.0.1 → 3.0.0)
+```
+
+**Pré-requisitos**: Working directory limpo, develop branch disponível
+
+### Processo Executado
+1. **Validações**: Verifica repository state, versão fornecida, working directory
+2. **Branch Detection**: Detecta primary branch (main/master) e develop
+3. **Version Processing**: Processa versioning (específica ou auto-bump)
+4. **Release Branch**: Cria release/version branch a partir de develop
+5. **ClickUp Setup**: Cria task de release tracking e atualiza status
+6. **Changelog Prep**: Prepara changelog baseado em commits desde última release
+
+### Version Bump Intelligence
+Durante execução, processa diferentes tipos de versionamento:
+- Versões explícitas: Valida formato semver e disponibilidade
+- Auto-bump: Detecta última tag e incrementa conforme tipo
+- Project detection: Identifica package.json, version files, etc.
+- Conflict prevention: Verifica tags existentes antes de proceder
+
+## 🤝 Integração @gitflow-specialist
+
+*Este comando sempre consulta @gitflow-specialist para release strategy validation, version bump analysis, branch creation guidance e troubleshooting de release workflows complexos.*
+
+## ⚠️ Resolução de Problemas
+
+### Version Required Error
+- **Sintoma**: Comando executado sem especificar versão
+- **Solução**: Fornecer versão específica ou tipo de bump (patch/minor/major)
+
+### Uncommitted Changes
+- **Causa**: Working directory não está limpo antes da release
+- **Fix**: `git add . && git commit -m "prepare for release"` antes de iniciar
+
+### Develop Branch Not Found
+- **Sintoma**: Develop branch não existe ou não está disponível
+- **Solução**: `git checkout -b develop` ou `git fetch origin develop`
+
+### Version Already Exists
+- **Causa**: Tag ou branch de release já existe para versão especificada
+- **Fix**: Usar versão diferente ou limpar tags/branches conflitantes
+
+### Primary Branch Detection Issues
+- **Sintoma**: Não consegue detectar main/master branch
+- **Solução**: Comando detecta automaticamente via @gitflow-specialist guidance
+
+### Release Branch Creation Failed
+- **Causa**: Problemas durante criação da branch de release
+- **Fix**: @gitflow-specialist fornece strategy específica para resolução