Git Hooks

Automatize gestão de tarefas com Git hooks. Auto-atualize tarefas em commits, inicie timers em checkout e valide nomenclatura de branches.

Automatize seu workflow com Git hooks.

Referência Rápida

gitscrum hooks install           # Setup interativo
gitscrum hooks list              # Mostrar hooks instalados
gitscrum hooks remove            # Remover hooks
gitscrum hooks test              # Testar execução

Instalação

gitscrum hooks install

? Instalar hook commit-msg?
  Adiciona ID de tarefa a mensagens de commit
  ❯ Sim

✓ Hooks instalados: commit-msg, post-checkout, pre-push

Hooks Disponíveis

commit-msg

# Branch: feature/GS-123-auth-flow
$ git commit -m "adicionar refresh de token"

# Mensagem vira: [GS-123] adicionar refresh de token

post-checkout

hooks:
  post_checkout:
    enabled: true
    switch_timer: true
    show_task: true

pre-push

hooks:
  pre_push:
    enabled: true
    update_status: true

Configuração

# .gitscrum.yml
hooks:
  commit_msg:
    enabled: true
    format: "[{id}] "
    skip_if_present: true
    exclude_branches:
      - main
      - develop

Gerenciar Hooks

gitscrum hooks list
gitscrum hooks remove commit-msg
gitscrum hooks remove --all

Desabilitar Temporariamente

git commit --no-verify -m "fix de emergência"

Ou:

export GITSCRUM_HOOKS_DISABLED=1

Integração com Husky

{
  "husky": {
    "hooks": {
      "commit-msg": "gitscrum hooks run commit-msg"
    }
  }
}

Melhores Práticas

Comece mínimo — Instale apenas hooks necessários
Teste primeiro — Use gitscrum hooks test
Documente para equipe — Adicione setup ao README