using-git-worktreeslisted
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á