SKILL 45 · AGENT SKILL
Superpowers Using Git Worktrees
Organiza mudanças em diretórios de trabalho isolados, reduzindo conflitos entre tarefas e branches.
FONTE PRIMÁRIA
Confira o projeto original.
A captura registra a página pública consultada em 10/08/2026. Ela comprova a origem usada na curadoria, mas não substitui a leitura da versão atual, da licença e das permissões antes da instalação.
Abrir repositório original ↗
O QUE ESTA SKILL VERIFICA
O que ela coloca na mesa.
✓Confirme a branch de origem antes de criar o worktree
✓Não reutilize diretório de trabalho de outra tarefa
✓Rode a verificação inicial antes de alterar código
✓Só remova o worktree depois de integrar ou arquivar a mudança
DETALHES DA SKILL
Como esta skill funciona na prática.
Entenda a função, o melhor cenário de uso e o resultado que você deve revisar antes de incluir esta skill no seu fluxo de trabalho.
Quando ela é útil
Tarefas paralelas, correções urgentes e experiências que não devem contaminar a branch principal.
O que ela faz
Organiza mudanças em diretórios de trabalho isolados, reduzindo conflitos entre tarefas e branches.
O que você deve receber
Ambiente isolado por tarefa, com branch, estado inicial e limpeza explicitamente verificados.
Onde pode ser usada
Codex, Claude Code, Gemini CLI e agentes compatíveis
Limite importante
Esta skill orienta o agente por meio de um arquivo SKILL.md. Ela não executa comandos sozinha e o resultado ainda precisa de revisão humana.
ANÁLISE EDITORIAL
O valor está no isolamento, não no comando
Esta skill organiza a criação de um ambiente separado para uma alteração de código. O ganho editorialmente relevante não é apenas conhecer git worktree add, mas reduzir a chance de misturar arquivos, branches e dependências de tarefas diferentes. Antes de criar qualquer diretório, o procedimento verifica se o agente já está em um worktree, se está em um submódulo e qual branch está ativa. Essa ordem evita criar uma segunda camada de isolamento que o ambiente de execução não consegue administrar.
Quando a plataforma já oferece uma ferramenta nativa de worktree, a orientação é usá-la primeiro. Isso preserva a rastreabilidade do ambiente, o local escolhido pelo sistema e o processo de limpeza. O comando Git manual fica como alternativa, não como atalho automático.
Quais riscos precisam de revisão humana
Um diretório mal escolhido pode acabar dentro do próprio repositório e ser incluído por engano no controle de versão. Por isso, a skill exige conferir o .gitignore antes de criar um worktree local. Também é necessário confirmar a branch de origem, porque isolamento de arquivos não corrige uma base errada nem impede que alterações antigas sejam carregadas para a nova tarefa.
A etapa de configuração pode instalar dependências e executar comandos do projeto. Isso deve acontecer somente no repositório autorizado e depois de revisar os arquivos de configuração. Falhas no teste inicial precisam ser registradas como estado anterior à mudança; tratá-las como consequência do novo trabalho distorce o diagnóstico.
Como validar antes de adotar
- Confirme se o diretório atual já pertence a um worktree ou a um submódulo.
- Registre a branch e o commit usados como ponto de partida.
- Verifique se a pasta de worktrees está ignorada pelo Git.
- Execute o teste de base antes de alterar arquivos e guarde o resultado.
- Ao terminar, integre ou arquive a mudança antes de remover o ambiente.
O pacote hospedado pelo Bastidores da IA é uma cópia textual e verificável da skill no commit informado na ficha. Ele não cria worktrees, não instala dependências e não executa testes sozinho. O responsável pelo projeto continua decidindo onde criar o ambiente, quais comandos autorizar e quando a limpeza é segura.
CONFIGURAÇÃO
Instale só depois de ler.
Abra a fonte oficial, leia README e licença, fixe uma versão ou commit e só então siga o método indicado pelo mantenedor. Não execute comandos copiados de comentários ou vídeos sem revisão.
Claude Code: registrar catálogo
/plugin marketplace add obra/superpowers-marketplaceNo Gemini CLI, a fonte documenta uma extensão própria. No Codex, use o marketplace de plugins e confirme a origem antes de instalar.
Abra o print e o README
- Confira mantenedor e nome do repositório.
- Leia licença, requisitos e permissões.
- Escolha uma versão ou commit para aprovar.
Comece em um projeto de teste
- Use o comando acima ou o método do README.
- Prefira instalação por projeto antes da global.
- Não copie tokens, chaves ou arquivos sensíveis.
Faça um teste pequeno
- Confirme a descrição e os arquivos instalados.
- Execute uma tarefa reversível.
- Registre versão aprovada e remova o que não usar.