--- name: workflow description: >- Gerencia fluxo Git com commits atômicos seguindo Conventional Commits. Use quando precisar organizar commits, gerenciar branches, ou seguir padrões de versionamento Git. compatibility: Git, projetos Laravel metadata: author: aronpc version: 1.0.0 category: github allowed-tools: - Read - Write - Edit - Bash --- # workflow ## Resumo Gerencia fluxo Git com commits atômicos seguindo Conventional Commits. ## Skills Relacionadas | Skill | Quando usar junto | |-------|-------------------| | `coder` | Para commits após implementação | | `sprint` | Para commits de tarefas do sprint | | `pr-review` | Para preparar PRs bem estruturados | | `cicd` | Para triggers de CI/CD | | `standards` | Para pre-commit hooks | ## Quando usar Use esta skill sempre que: - Antes de fazer commits - Para revisar histórico de commits - Para configurar pre-commit hooks - Para gerenciar branches e feature branches - Para configurar regras de merge e pull requests ## CRÍTICO: Commits Atômicos **NUNCA commit como "Claude" ou "AI Assistant"** - commits são SEMPRE no nome do desenvolvedor. ### CRÍTICO: Regras de Mensagem de Commit **NUNCA incluir** o seguinte em mensagens de commit: - ❌ `🤖 Generated with [Claude Code](https://claude.com/claude-code)` - ❌ `Co-Authored-By: Claude ` - ❌ Qualquer atribuição ou assinatura relacionada a AI **Commits devem parecer como foram escritos por um desenvolvedor humano.** ### Regras de Commit 1. **Um commit = Uma mudança lógica** - Uma feature = um commit - Um bug fix = um commit - Um refactor = um commit 2. **Formato de Mensagem:** ``` : - Ponto de mudanças - Outra mudança ``` 3. **Tipos de Commit:** - `feat:` Nova feature - `fix:` Bug fix - `refactor:` Refatoração de código - `docs:` Documentação - `test:` Testes - `chore:` Manutenção 4. **Quando Fazer Commit:** - Após completar uma feature - Após fixar um bug - Após adicionar testes - **Após rodar `composer fix` com sucesso** ## Workflow Git ```bash # 1. Faça mudanças no código # 2. Execute verificações de qualidade composer fix composer test # 3. Stage apenas arquivos relacionados git add app/Http/Controllers/Owner/StaffController.php git add resources/js/pages/owner/staff/ # 4. Commit com mensagem descritiva git commit -m "feat: Add StaffController with CRUD operations" # 5. Atualize documentação em commit separado git add IMPLEMENTATION.md git commit -m "docs: Mark Staff Management as complete" ``` ## Exemplos de Bons Commits ```bash # ✅ GOOD - atômico, focado git commit -m "feat: Add Staff Management CRUD Implemented complete staff management system: - StaffController with index, create, store, edit, update, destroy - React pages: index, create, edit, businesses - StaffForm reusable component - Translations in EN, ES, PT-BR - Plan limit enforcement" # ✅ GOOD - documentação separada git commit -m "docs: Update implementation progress for Staff Management" ``` ## Exemplos de Commits Ruins ```bash # ❌ BAD - muito grande, múltiplas features git commit -m "Added everything" # ❌ BAD - mensagem vaga git commit -m "Fixed stuff" # ❌ BAD - misturando features git commit -m "Added staff management and fixed menu bug" ``` ## Estrutura de Mensagem de Commit ### Formato Completo ``` ():