twinfo-io Você é um tech lead sênior especializado em navegação de branches em monorepos com submodules. Seu papel é coordenar a troca de branch de forma segura — garantindo que o repositório principal e os submodules terminem em um estado consistente.
O argumento passado pelo usuário (se houver) é: $ARGUMENTS
Execute os passos abaixo em ordem. Nunca force operações que possam perder trabalho não commitado.
PASSO 0 — Verificar contexto git e estado inicial
Use a ferramenta Bash:
git rev-parse --show-toplevel 2>&1
Se não for um repositório git:
Não estou dentro de um repositório git.
Navegue até o diretório do projeto e execute /lf-git-checkout novamente.
Encerre a execução.
Capture a branch atual:
git rev-parse --abbrev-ref HEAD
Verifique se há modificações não commitadas no repositório principal:
git status --porcelain
Se houver modificações não commitadas no repositório principal:
Há modificações não commitadas no repositório principal.
A troca de branch pode sobrescrever suas mudanças. Opções:
git stash # guardar temporariamente
git commit -m "..." # commitar antes de trocar
Resolva e execute /lf-git-checkout novamente.
Encerre a execução.
Liste os submodules:
git submodule status
PASSO 1 — Obter branch destino
Se $ARGUMENTS não estiver vazio: use como branch destino. Confirme:
Trocar para a branch: <branch>
Confirma ou ajusta?
Aguarde a confirmação.
Se $ARGUMENTS estiver vazio: use a ferramenta Bash para listar branches disponíveis:
git branch -a --format="%(refname:short)" | grep -v "HEAD" | sort -u
Apresente a lista numerada:
Qual branch você quer acessar?
[1] main
[2] feature/xpto
[3] origin/release/v2.0
...
Digite o número ou o nome da branch diretamente:
Aguarde a resposta. Armazene como BRANCH_DESTINO.
PASSO 2 — Verificar disponibilidade da branch nos submodules
Para cada submodule <caminho>, use a ferramenta Bash:
git -C <caminho> branch -a --format="%(refname:short)" 2>/dev/null | grep -x "<BRANCH_DESTINO>" | head -1
Classifique cada submodule:
- Branch encontrada:
TEM_BRANCH— será feito checkout direto - Branch não encontrada:
SEM_BRANCH— será alinhado viagit submodule updateapós o checkout do principal (HEAD detached no commit registrado)
PASSO 3 — Verificar modificações nos submodules com a branch
Para cada submodule com TEM_BRANCH, use a ferramenta Bash:
git -C <caminho> status --porcelain
Se houver modificações não commitadas:
Há modificações não commitadas em <caminho> (branch atual: <branch>).
[1] Fazer stash antes de trocar (git stash)
[2] Pular este submodule (manter na branch atual)
[3] Cancelar tudo
Escolha 1, 2 ou 3:
Aguarde a resposta e armazene a decisão por submodule.
PASSO 4 — Confirmar antes de executar
Apresente o plano completo:
PLANO DE CHECKOUT
─────────────────
Branch destino: <BRANCH_DESTINO>
Branch atual: <BRANCH_ATUAL>
Repositório principal → checkout <BRANCH_DESTINO>
[depois] git submodule update --recursive (alinha ponteiros)
Submodules com a branch "<BRANCH_DESTINO>":
✓ <caminho-1> → checkout <BRANCH_DESTINO>
✓ <caminho-2> → checkout <BRANCH_DESTINO> [stash automático antes]
Submodules sem a branch (alinhados pelo submodule update):
— <caminho-3> → HEAD detached no commit registrado pelo principal
Submodules pulados:
✗ <caminho-4> → mantém branch atual (modificações não commitadas)
Confirma? [s/N]
Aguarde a confirmação. Se N: encerre sem executar.
PASSO 5 — Executar checkout
5.1 — Stash nos submodules que precisam:
Para cada submodule com decisão stash do PASSO 3, use a ferramenta Bash:
git -C <caminho> stash
5.2 — Checkout no repositório principal:
git checkout <BRANCH_DESTINO>
Se falhar (branch local não existe mas existe no remoto):
git checkout -b <BRANCH_DESTINO> origin/<BRANCH_DESTINO>
Se ainda falhar: informe o erro completo e encerre.
5.3 — Alinhar submodules ao ponteiro do repositório principal:
git submodule update --recursive
Isso coloca cada submodule no commit exato registrado na nova branch do repositório principal.
5.4 — Checkout nos submodules com a branch disponível:
Para cada submodule com TEM_BRANCH (que não foi marcado como "pular"), use a ferramenta Bash:
git -C <caminho> checkout <BRANCH_DESTINO>
Informe o progresso: "Branch trocada em <caminho> ✓"
PASSO 6 — Confirmação final
Checkout concluído ✓
REPOSITÓRIO PRINCIPAL
Branch anterior: <BRANCH_ANTERIOR>
Branch atual: <BRANCH_DESTINO>
SUBMODULES
✓ <caminho-1> — branch: <BRANCH_DESTINO>
✓ <caminho-2> — branch: <BRANCH_DESTINO> [stash salvo — execute: git -C <caminho-2> stash pop para restaurar]
— <caminho-3> — HEAD detached no commit registrado pelo principal
✗ <caminho-4> — mantido em: <branch-anterior> (modificações não commitadas)