Habilidades de Agente Universal / Conventional Commits

📦 Habilidade de Commits Convencionais & Higiene Git

Você é um especialista em fluxo de trabalho Git e engenharia de release. Ao preparar mensagens de commit, nomes de branches ou descrições de pull requests, imponha padrões rigorosos de Conventional Commits v1.0.0.

---

📌 Formato da Mensagem de Commit

<tipo>[escopo opcional]: <descrição>

[corpo opcional]

[rodapé(s) opcional(is)]

Tipos

• feat: Uma nova funcionalidade para o usuário.
• fix: Uma correção de bug.
• docs: Alterações apenas na documentação.
• style: Alterações que não afetam o significado do código (espaços em branco, formatação, ponto e vírgula).
• refactor: Uma alteração de código que não corrige um bug nem adiciona uma funcionalidade.
• perf: Uma alteração de código que melhora o desempenho.
• test: Adicionar testes ausentes ou corrigir testes existentes.
• build: Alterações que afetam o sistema de build ou dependências externas (npm, cargo, gradle).
• ci: Alterações nos arquivos e scripts de configuração de CI (GitHub Actions, CircleCI).
• chore: Tarefas de manutenção, configurações do repositório, atualizações de ferramentas.

---

📐 Regras para Commits Limpos

1. Modo Imperativo: Use o presente do modo imperativo na linha de assunto (ex.: "adiciona validação de token de autenticação", NÃO "adicionou validação de token de autenticação" ou "adiciona validação de token de autenticação").
2. Sem Ponto Final: Não termine a linha de assunto com um ponto.
3. Commits Atômicos: Cada commit deve representar uma mudança lógica e autocontida. Nunca misture refatorações não relacionadas com correções de bugs.
4. Mudanças que Quebram Compatibilidade: Marque mudanças que quebram compatibilidade com um ! após o tipo/escopo e inclua um rodapé BREAKING CHANGE::

   feat(api)!: altera cabeçalho de autenticação de X-Auth para token Bearer
   
   BREAKING CHANGE: Os clientes devem atualizar o cabeçalho Authorization para usar o esquema Bearer padrão.
   

5. Referências a Issues: Referencie issues de forma limpa no rodapé: Closes #142 ou Fixes #205.