SkillProgramaçãoExecução

Uso de Git Worktrees

Cria um espaço de trabalho isolado para desenvolver uma feature sem poluir a branch atual. Use ao iniciar trabalho que exige isolamento ou antes de executar um plano de implementação.

Ações
PerfilDev
ProfundidadeMédia
IdiomaInglês (skill original)
Objetivo

Em uma frase.

Garantir que o trabalho aconteça em um workspace isolado, priorizando as ferramentas nativas de worktree da plataforma (como `EnterWorktree`, um comando `/worktree` ou uma flag `--worktree`) e recorrendo ao `git worktree add` manual apenas quando nenhuma ferramenta nativa existir. O princípio central é: primeiro detectar se já há isolamento, depois usar ferramentas nativas e só então cair no git, nunca brigando com o harness.

Aplicação

Quando
faz sentido.

Usar
  • Ao iniciar o desenvolvimento de uma feature que não deve poluir a branch atual
  • Antes de executar um plano de implementação
  • Ao coordenar várias features em paralelo que não devem compartilhar o estado do workspace
Não usar
  • Quando você já está dentro de uma worktree vinculada (o Passo 0 detecta isso e pula a criação)
  • Em um hotfix de commit único na branch atual, onde o isolamento é exagero
  • Dentro de um submódulo git tratado como repositório normal
Prompt

Instruções
para a IA.

### Passo 0 — Detectar isolamento existente

Antes de criar qualquer coisa, verifique se você já está em um workspace isolado comparando o git-dir com o git-common-dir. Se forem diferentes, você está em uma worktree vinculada. Atenção ao guard de submódulo: a mesma diferença ocorre dentro de submódulos, então confirme que você não está em um com git rev-parse --show-superproject-working-tree. Se já estiver isolado, pule direto para o setup do projeto.

### Passo 1 — Ferramentas nativas, depois fallback

Se houver uma ferramenta nativa de worktree, use-a: ela cuida de diretório, criação de branch e limpeza automaticamente. Usar git worktree add quando existe ferramenta nativa cria estado fantasma que o harness não gerencia. Só caia no git worktree add manual quando não houver nativa, escolhendo o diretório por prioridade (declarado pelo usuário, .worktrees local, global, ou padrão) e garantindo que esteja no gitignore.

### Passos 3 e 4 — Setup e baseline

Detecte e rode a instalação de dependências do projeto (npm, cargo, pip, etc.) e verifique uma baseline de testes limpa antes de declarar o ambiente pronto. Nunca inicie a implementação na main/master sem consentimento explícito do usuário.
Constelação

Onde
ela vive.

Execução

Como usar
com IA.

  1. 01Copie a skill (botão "Copiar skill para IA", no topo): o texto copiado já é a skill completa, não um resumo.
  2. 02Abra o Claude ou Claude Code e cole — a IA recebe todas as instruções e fica pronta para a tarefa.
  3. 03Prefere usar como arquivo reutilizável? Baixe o .zip e coloque o SKILL.md em .claude/skills/ (Claude Code) ou anexe o arquivo no Claude (claude.ai).