Sync Global

Traz a instalação global (~/.claude/) para o estado atual do clone do ARK.

É o único caminho de atualização do kit: desde o ADR 0003 a Instalação global é o modelo de reuso do ARK, e o .claude/ de um projeto guarda apenas o que descreve aquele projeto — nada que este comando precise atualizar.

Não recebe argumentos.

Quando roda de fato

Só duas situações precisam deste comando:

Se nada disso aconteceu, o comando é um no-op barato: diga isso e pare.

Passos

1. Localizar o clone

$ARK_HOME é o caminho absoluto da pasta .claude/ do clone, gravado no bloco env de ~/.claude/settings.json pelo instalador.

echo "$ARK_HOME"

Vazio significa que a instalação global nunca foi feita nesta máquina. Não adivinhe o caminho e não prossiga: aponte a seção Instalação global do README e pare.

2. Puxar o clone

git -C "$ARK_HOME/.." status --porcelain
git -C "$ARK_HOME/.." pull --ff-only

Com a árvore suja, não faça stash nem commit: mostre o que está pendente e pergunte se é para seguir sem puxar (os links locais continuam válidos — só não vem novidade do remoto). Se o --ff-only recusar, o clone divergiu: reporte e pare, isso é decisão de quem escreveu os commits.

3. Refazer os links

Escolha pelo sistema, não por preferência. No Windows use powershell; só troque por pwsh se o PowerShell 7 estiver instalado:

powershell -File "$env:ARK_HOME\scripts\install-global.ps1"

bash "$ARK_HOME/scripts/install-global.sh"

Rode primeiro com -DryRun / --dry-run se o passo 2 trouxe commits: assim o diff aparece antes de qualquer escrita. Sem commits novos, vá direto.

O instalador é idempotente e conservador. Pasta real de mesmo nome em ~/.claude/skills é comparada com a do clone: idêntica, vira link sem perguntar; diferente, é pulada com aviso. Só links que apontam para dentro do clone são podados. Um PULADO: no output não é erro do sync: é uma skill de outra origem ocupando o nome, e quem resolve é o usuário.

4. Fechar

Reporte em uma linha: quantos links entraram, quantos órfãos saíram, e o nome de cada skill nova ou removida — não o output cru do script.

Termine avisando que skill nova só aparece na próxima sessão: o Claude Code lê ~/.claude/skills na inicialização. Skill já linkada e apenas editada vale na hora, sem reiniciar.

Limites

• Não escreve dentro de nenhum projeto. Quem cria e migra o .claude/ de um repositório é a skill adopt-repo.
• Não faz commit nem push no clone do ARK. Se você alterou uma skill e quer publicar, isso é /commit + /open-pr de dentro do clone.
• Não mexe nas rules de projeto nem em settings.local.json de lugar nenhum.