| name | anvil-update |
| description | Update: reinstala o toolkit anvil do zero (reset + degit), apagando órfãos de versões anteriores, e resume o que mudou. Use ao atualizar ou sincronizar a versão do anvil no projeto. |
Update
Reinstala o payload do anvil e reporta o que mudou.
O contrato
Isto é um reset, não uma sobrescrita. As skills que o anvil instalou são
apagadas e reinstaladas. Ficam intactos: .claude/rules/, .claude/settings.json,
docs/, CLAUDE.md, e qualquer skill que você tenha escrito.
Por que reset e não degit --force: o --force sobrescreve arquivo a
arquivo e nunca apaga. Uma skill que deixou de existir upstream ficaria no
disco para sempre, e os agentes continuariam encontrando e tentando usar.
Atualizar sem reset acumula o entulho de todas as versões anteriores.
Como os órfãos são calculados: pelo .claude/anvil.lock, que lista o que
esta instalação possui. É o que substitui a detecção por prefixo do mosk — um
lockfile diz a verdade, um prefixo adivinha, e adivinha errado justamente nas
skills que não seguem o padrão de nome, como as tea-*.
Instalação sem lock — de antes do lockfile, ou de um degit feito à mão — não
tem nada classificado como nosso. É a leitura segura: nada é apagado, e o
primeiro update passa a manter o lock a partir dali.
Fluxo
1. Preflight
Confirme que é repositório git. Se não for, avise que o reset é irreversível sem
git e pergunte antes de seguir.
git status --short: árvore suja, pare e peça commit ou stash. Não há como
distinguir alteração sua de resíduo de versão antiga no meio de um reset.
2. Baixar, sem tocar no projeto
TMP="$(mktemp -d)"
npx degit rogerznts/anvil/anvil "$TMP"
3. Dry-run — obrigatório
bash "$TMP/.claude/skills/anvil-update/scripts/reset-install.sh" \
--dry-run --from "$TMP" --to .
Rode a cópia recém-baixada, nunca a instalada. O script apaga o próprio
diretório onde vive. Rodar do $TMP também garante que a lógica de reset é a
nova, não a da versão velha.
A saída classifica em quatro grupos: substituídos · órfãos, serão removidos ·
não são do anvil, ficam intocados · preservados sempre.
4. Avisar e esperar
Diga numa frase o que será apagado e o que será preservado, nomeando os
órfãos. Não continue com um "talvez".
5. Executar
bash "$TMP/.claude/skills/anvil-update/scripts/reset-install.sh" --from "$TMP" --to .
6. Relatar
- órfãos removidos, por nome
- o que mudou localmente:
git status --short e git diff --stat
- o que há de novo no toolkit
- o que ficou no disco para você decidir
- se a estrutura de rules ou templates mudou, sugira rodar
/anvil-boot de novo
Nunca commite sozinho. O diff é para o usuário revisar.
7. Limpar
rm -rf "$TMP"
Regras
- Árvore suja não é resetada sem confirmação explícita.
- O dry-run vem antes de qualquer remoção, sempre.
- O
reset-install.sh roda do $TMP, nunca do projeto.
- Nada é apagado fora do conjunto que o script calcula. Skill que o usuário
escreveu não é do anvil para remover.
- O lockfile é reescrito pelo script. Não edite à mão.
