GitScrum / Docs

Integração Git

Como GitScrum CLI se integra com Git. Detecção automática de branches, extração de IDs de tarefas e hooks para workflows automatizados.

O CLI é consciente de Git por design. Lê o contexto do seu repositório para vincular comandos às tarefas corretas.


Detecção Automática de Branch

$ git checkout feature/GS-123-auth-refactor

$ gitscrum task current
 📋 GS-123: Refatorar módulo de autenticação

Padrões Suportados

Nome da BranchTarefa Detectada
feature/GS-123-add-loginGS-123
GS-456-fix-bugGS-456

Criação de Branches

$ gitscrum task branch GS-789

✓ Criada branch: feature/GS-789-implement-oauth-flow

Configurar Formato

git:
  branch_format: "{type}/{id}-{slug}"
  default_type: feature

Git Hooks

gitscrum hooks install commit-msg

Hooks Disponíveis

HookPropósito
commit-msgAdicionar ID de tarefa aos commits
post-checkoutTrocar timer para nova branch
pre-pushAtualizar status da tarefa

Suporte para Monorepos

repo/
├── packages/
│   ├── api/
│   │   └── .gitscrum.yml  # project: api-backend
│   └── web/
│       └── .gitscrum.yml  # project: web-frontend

O CLI usa o .gitscrum.yml mais próximo.


Variáveis de Ambiente

VariávelPropósito
GITSCRUM_PROJECTSobrescrever projeto
GITSCRUM_BRANCHSobrescrever branch
GITSCRUMTASKIDSobrescrever ID de tarefa