Gerencia fluxo Git com commits atômicos seguindo Conventional Commits. Use quando precisar organizar commits, gerenciar branches, ou seguir padrões de versionamento Git.
From laravel-toolkitnpx claudepluginhub aronpc/ai --plugin laravel-toolkitThis skill is limited to using the following tools:
Executes pre-written implementation plans: critically reviews, follows bite-sized steps exactly, runs verifications, tracks progress with checkpoints, uses git worktrees, stops on blockers.
Guides idea refinement into designs: explores context, asks questions one-by-one, proposes approaches, presents sections for approval, writes/review specs before coding.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
Gerencia fluxo Git com commits atômicos seguindo Conventional Commits.
| 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 |
Use esta skill sempre que:
NUNCA commit como "Claude" ou "AI Assistant" - commits são SEMPRE no nome do desenvolvedor.
NUNCA incluir o seguinte em mensagens de commit:
🤖 Generated with [Claude Code](https://claude.com/claude-code)Co-Authored-By: Claude <noreply@anthropic.com>Commits devem parecer como foram escritos por um desenvolvedor humano.
Um commit = Uma mudança lógica
Formato de Mensagem:
<type>: <descrição curta>
<descrição detalhada se necessária>
- Ponto de mudanças
- Outra mudança
Tipos de Commit:
feat: Nova featurefix: Bug fixrefactor: Refatoração de códigodocs: Documentaçãotest: Testeschore: ManutençãoQuando Fazer Commit:
composer fix com sucesso# 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"
# ✅ 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"
# ❌ 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"
<type>(<escopo>): <assunto>
<body>
<footer>
feat: Nova featurefix: Bug fixdocs: Mudanças na documentaçãostyle: Formatação, missing semi colons, etc (sem mudança de código)refactor: Refatoração de códigotest: Adicionando testes faltando ou corrigindo testes existenteschore: Atualização de tarefas de build, configuração, etc.O escopo deve indicar a área do código afetada:
controller: Para controllersmodel: Para modelsmigration: Para migrationsfilament: Para resources/pages Filamenti18n: Para traduçõestests: Para testes| Branch | Propósito | Estabilidade |
|---|---|---|
main | Produção | ✅ Sempre estável |
develop | Desenvolvimento | ⚠️ Pode ser instável |
feature/* | Features | 🔨 Em desenvolvimento |
# Crie branch de feature a partir de develop
git checkout develop
git pull origin develop
git checkout -b feature/staff-management
# Trabalhe na feature
# ... faça mudanças ...
# Commit com mensagens apropriadas
git add .
git commit -m "feat: add staff controller"
# Push para origin
git push origin feature/staff-management
# Crie pull request para develop
# ✅ GOOD - Squash and merge (develop -> main)
git checkout main
git merge develop --squash
git commit -m "release: v1.8.0"
git push origin main
# ✅ GOOD - Rebase feature branch antes de merge
git checkout feature/staff-management
git rebase develop
git push origin feature/staff-management --force
# Após push de feature branch
gh pr create \
--title "feat: Add Staff Management" \
--body "Implementa gestão completa de funcionários:
## Changes
- StaffController com operações CRUD
- Páginas React para list, create, edit
- StaffForm component reutilizável
- Traduções EN, ES, PT-BR
- Validação de limites de plano
## Testing
- [x] Testes unitários para Actions
- [x] Testes de feature para endpoints HTTP
- [x] Testes de Policies
## Checklist
- [x] Sem N+1 queries
- [x] Traduções completas
- [x] Documentação atualizada" \
--base develop
# List PRs
gh pr list
# Ver diff do PR
gh pr diff 123
# Adicionar revisor
gh pr edit 123 --add-reviewer @username
# Aprovar PR
gh pr review 123 --approve
# Remove arquivos do último commit mas mantenha mudanças
git reset HEAD~1 path/to/file.php
# Commit correto
git commit -m "fix: correct commit message"
git commit --amend -m "feat: corrected commit message"
# Reverter commit mas manter histórico
git revert <commit-hash>
# Reverter merge
git revert -m 1 <merge-commit-hash>
# ATENÇÃO: Perde mudanças locais
git fetch origin
git reset --hard origin/main
composer fix e composer test antes de commitarAntes de fazer commit:
composer fix executado com sucessocomposer test passandodocumentation-updates)Integração com documentation-updates:
Após implementar features, atualize a documentação em commits separados:
# Commit de código primeiro
git add app/ resources/
git commit -m "feat: Add Staff Management CRUD"
# Commit de documentação separadamente
git add IMPLEMENTATION.md CHECKPOINT.md
git commit -m "docs: Update implementation progress - Staff Management complete"
Veja documentation-updates para:
sprint-management)