Mensagens de Commit do Sentry

Siga estas convenções ao criar commits para projetos do Sentry.

Quando Usar

• O usuário pede para commitar código, preparar uma mensagem de commit ou salvar alterações no git.
• Você precisa de formatação de commit no estilo Sentry com estrutura de commit convencional e referências a issues.
• A tarefa exige a aplicação de segurança de branch antes de commitar, especialmente evitando commits diretos em main ou master.

Pré-requisitos

Antes de commitar, sempre verifique a branch atual:

git branch --show-current

Leia a política do repositório antes de criar um commit. Se a branch padrão for apenas por PR, crie uma branch de tópico autorizada e use o fluxo de mantenedor nativo do repositório, mesmo quando um administrador puder ignorar as verificações do servidor. AAS requer antigravity-maintainer-batch-release e PRs de origem protegidas.

Inspecione git status --short, git diff --cached e os caminhos alterados pretendidos; preserve trabalho não relacionado em staging/sujo. Use um helper create-branch instalado apenas se disponível e apropriado, caso contrário, crie a branch de tópico através do fluxo de trabalho do repositório. Verifique a branch real antes de prosseguir. Uma solicitação de apenas a mensagem não autoriza staging, commit ou push.

Formato

<type>(<scope>): <subject>

<body>

<footer>

O cabeçalho é obrigatório. O escopo é opcional. Todas as linhas devem ter no máximo 100 caracteres.

Tipos de Commit

Regras da Linha de Assunto

• Use o tempo verbal imperativo e presente: "Adiciona funcionalidade" em vez de "Adicionou funcionalidade"
• Capitalize a primeira letra
• Sem ponto no final
• Máximo de 70 caracteres

Diretrizes do Corpo

• Explique o quê e por quê, não como
• Use o modo imperativo e o tempo presente
• Inclua a motivação para a mudança
• Contraste com o comportamento anterior quando relevante

Rodapé: Referências a Issues

Referencie issues no rodapé usando estes padrões:

Fixes GH-1234
Fixes #1234
Fixes SENTRY-1234
Refs LINEAR-ABC-123

• Fixes fecha a issue quando mesclada
• Refs vincula sem fechar

Mudanças Geradas por IA

Siga a política de atribuição do repositório e identifique o contribuidor real. O seguinte é um exemplo para Claude; não o anexe a trabalhos produzidos por um agente diferente ou invente a contribuição de uma pessoa:

Co-Authored-By: Claude <noreply@anthropic.com>

As regras de atribuição e divulgação do repositório têm precedência. Não adicione frases como "Gerado por IA", "Escrito com Claude" ou marcadores semelhantes no assunto, corpo ou em qualquer outro lugar da mensagem de commit.

Exemplos

Correção simples

fix(api): Handle null response in user endpoint

The user API could return null for deleted accounts, causing a crash
in the dashboard. Add null check before accessing user properties.

Fixes SENTRY-5678
Co-Authored-By: Claude <noreply@anthropic.com>

Funcionalidade com escopo

feat(alerts): Add Slack thread replies for alert updates

When an alert is updated or resolved, post a reply to the original
Slack thread instead of creating a new message. This keeps related
notifications grouped together.

Refs GH-1234

Refatoração

ref: Extract common validation logic to shared module

Move duplicate validation code from three endpoints into a shared
validator class. No behavior change.

Mudança que quebra compatibilidade

feat(api)!: Remove deprecated v1 endpoints

Remove all v1 API endpoints that were deprecated in version 23.1.
Clients should migrate to v2 endpoints.

BREAKING CHANGE: v1 endpoints no longer available
Fixes SENTRY-9999

Formato de Reversão

revert: feat(api): Add new endpoint

This reverts commit abc123def456.

Reason: Caused performance regression in production.

Princípios

• Cada commit deve ser uma mudança única e estável
• Os commits devem ser revisáveis independentemente
• O repositório deve estar em estado funcional após cada commit

Referências

• Mensagens de Commit do Sentry

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.

…