---

name: auto-branch description: | Automacao de criacao de branches baseado em tipo de trabalho. Integra com SpecKit para criar branches automaticamente ao iniciar features. Use quando: iniciar novo trabalho, criar feature, corrigir bug. allowed-tools:

• Bash
• Read
• Write user-invocable: true

---

Auto-Branch Skill

Proposito

Esta skill automatiza a criacao de branches seguindo convencoes de nomenclatura.

Padroes de Branch

Uso

Via Hook

O hook .claude/hooks/auto-branch.sh e chamado automaticamente:

Copy.claude/hooks/auto-branch.sh feature "exportacao de duplicatas"
# Cria: feature/exportacao-de-duplicatas

Via Comando

Copy/auto-branch feature "nome da feature"
/auto-branch fix "descricao do bug"

Integracao com SDLC

Level 0 (Quick Flow)

Quando detectado bug fix ou hotfix:

Copytrigger: "fix: " ou "hotfix: " no inicio da descricao
action: auto-branch.sh fix "{descricao}"

Level 1 (Feature)

Quando detectada nova feature:

Copytrigger: "feat: " ou "feature: " no inicio da descricao
action: auto-branch.sh feature "{descricao}"

Level 2+ (SDLC Completo)

Quando iniciado SDLC completo:

Copytrigger: /sdlc-start com nivel >= 2
action: auto-branch.sh feature "{project-id}"

Integracao com SpecKit

Ao executar /spec-create, a branch e criada automaticamente:

Copyspec_create_flow:
  1. Detectar nome da spec
  2. Executar: auto-branch.sh feature "{spec-name}"
  3. Criar arquivo da spec
  4. Registrar no manifest do projeto

Validacoes

• Nome normalizado (lowercase, sem espacos)
• Limite de 50 caracteres
• Sem caracteres especiais
• Branch nao existe (ou faz checkout se existir)

Script

O script principal esta em .claude/hooks/auto-branch.sh.

Exemplo de Uso

Copy# Criar branch de feature
.claude/hooks/auto-branch.sh feature "Exportacao de Duplicatas em PDF"
# Resultado: feature/exportacao-de-duplicatas-em-pdf

# Criar branch de fix
.claude/hooks/auto-branch.sh fix "Timeout na conexao com CERC"
# Resultado: fix/timeout-na-conexao-com-cerc

# Criar branch de release
.claude/hooks/auto-branch.sh release "1.2.0"
# Resultado: release/v1.2.0

Configuracao no settings.json

Para habilitar criacao automatica de branches, adicione ao settings.json:

Copy{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Write(*.spec.md)",
      "hooks": [{
        "type": "command",
        "command": ".claude/hooks/auto-branch.sh feature $(basename $TOOL_INPUT_FILE_PATH .spec.md)"
      }]
    }]
  }
}

Troubleshooting

Branch ja existe

Se a branch ja existir, o script faz checkout automaticamente.

Mudancas nao commitadas

O script avisa se houver mudancas nao commitadas, mas nao bloqueia a operacao.

Nome muito longo

Nomes sao truncados em 50 caracteres para evitar problemas.