← ClaudeAtlas

using-git-worktreeslisted

Use ao iniciar trabalho de feature que precisa de isolamento do workspace atual, ao executar um plano de implementação, ou quando o usuário pedir "worktree", "isolar o ambiente", "trabalhar numa branch separada sem mexer no meu checkout". Garante um workspace isolado via ferramenta nativa do harness ou, na ausência dela, via git worktree manual — com setup do projeto e baseline de testes verde antes de começar.
vellus-tech/forge-harness · ★ 0 · Code & Development · score 66
Install: claude install-skill vellus-tech/forge-harness
# Trabalho com Git Worktrees ## Visão geral Garantir que o trabalho aconteça em um **workspace isolado**. Prefira a ferramenta de worktree nativa do harness. Só recorra ao `git worktree` manual quando não houver ferramenta nativa. **Princípio central:** detecte isolamento existente primeiro. Depois use a ferramenta nativa. Depois recaia no git. Nunca brigue com o harness. > **Fonte de verdade de naming e localização:** a política do projeto está em `.forge/rules/conventions/git-worktree.md`. Esta skill é o **procedimento acionável** que a complementa (detecção de isolamento, tool nativa, setup, baseline). Em caso de divergência, a rule vence. **Anuncie ao iniciar:** "Estou usando a skill `using-git-worktrees` para preparar um workspace isolado." --- ## Passo 0 — Detectar isolamento existente **Antes de criar qualquer coisa, verifique se você já está em um workspace isolado.** ```bash GIT_DIR=$(cd "$(git rev-parse --git-dir)" 2>/dev/null && pwd -P) GIT_COMMON=$(cd "$(git rev-parse --git-common-dir)" 2>/dev/null && pwd -P) BRANCH=$(git branch --show-current) ``` **Guarda de submódulo:** `GIT_DIR != GIT_COMMON` também é verdadeiro dentro de submódulos git. Antes de concluir "já estou num worktree", confirme que não está num submódulo: ```bash # Se isto retornar um caminho, você está num submódulo, não num worktree — trate como repo normal git rev-parse --show-superproject-working-tree 2>/dev/null ``` **Se `GIT_DIR != GIT_COMMON` (e não for submódulo):** você já está