Criar Branch

Crie um branch git com o prefixo de tipo correto e um nome descritivo seguindo as convenções do Sentry.

Quando Usar

• Você precisa criar um novo branch git que siga a convenção de nomenclatura do repositório.
• Você está começando um novo trabalho a partir do branch padrão e precisa de ajuda para classificá-lo como feat, fix, docs ou outro tipo de branch.
• Você quer que o nome do branch seja proposto a partir da descrição da tarefa ou das alterações locais atuais.

Passo 1: Obter o Prefixo do Nome de Usuário

Execute gh api user --jq .login para obter o nome de usuário do GitHub.

Se o comando falhar (por exemplo, não autenticado), peça ao usuário o prefixo preferido dele.

Passo 2: Determinar a Descrição do Branch

Se $ARGUMENTS for fornecido, use-o como a descrição do trabalho.

Se nenhum argumento for fornecido, verifique as alterações locais:

git diff
git diff --cached
git status --short

• Alterações existem: leia o conteúdo do diff para entender do que se trata o trabalho e gere uma descrição.
• Nenhuma alteração: pergunte ao usuário o que ele pretende trabalhar.

Passo 3: Classificar o Tipo

Escolha o tipo desta tabela com base na descrição:

Quando em dúvida: feat para coisas novas (incluindo novos scripts, habilidades ou ferramentas), ref para reestruturar coisas existentes, chore apenas ao atualizar/manter algo que já existe.

Passo 4: Gerar e Propor

Construa o nome do branch como <username>/<type>/<short-description>.

Regras para <short-description>:

• Kebab-case, minúsculas
• 3 a 6 palavras, conciso, mas claro
• Descreva a mudança, não os nomes dos arquivos
• Use apenas letras ASCII, dígitos e hifens — sem espaços, pontos, dois-pontos, tils ou outros caracteres proibidos pelo git

Apresente ao usuário e pergunte se ele deseja usá-lo, modificá-lo ou alterar o tipo.

Exemplos

Passo 5: Criar o Branch

Uma vez confirmado, detecte o branch atual e o branch padrão:

git branch --show-current
git remote | grep -qx origin && echo origin || git remote | head -1
git symbolic-ref refs/remotes/<remote>/HEAD 2>/dev/null | sed 's|refs/remotes/<remote>/||' | tr -d '[:space:]'

Se symbolic-ref falhar, use git branch --list main master como fallback: use aquele que existir; se ambos ou nenhum existirem, pergunte ao usuário.

Se git branch --show-current estiver vazio (HEAD destacado), mostre o commit atual (git rev-parse --short HEAD) e pergunte se deve criar o branch a partir dele ou mudar para o branch padrão primeiro.

…