sincronizar-agentes · git:20261112.b26b74b · 2026-11-12 · sha256 fb28578c286a3901

sincronizar-agentes git:20261112.b26b74bA

Immutable. This exact content never changes and is served at /api/v1/blob/fb28578c286a3901.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_ehfsj4q4xs6qaqoo/fb28578c286a3901c77d4a16a15a7221244e5bd8b35408ea5669526bb83cbdaf.json

Then /plugin install sincronizar-agentes@markdownregistry-ehfsj4q4xs6qaqoo in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.

---
name: sincronizar-agentes
description: Atualiza catálogos e apontamentos dos recursos compartilhados.
---

# Sincronizar agentes

Use Node.js 24+ em qualquer sistema:

```sh
node .pbai4devs/scripts/sincronizar-agentes/SCRIPT.mjs --force
```

Também pode usar `executar-script` com o nome `sincronizar-agentes`.

Após criar, alterar, mover ou remover recursos, sincronize e use `--check`.
Os principais `SKILL.md`, `COMMAND.md`, `AGENT.md` e `RULE.md` são fontes.
O mesmo comando gera `catalog.json` com todos os tipos e os três registros
auxiliares. Os JSON derivados não são editados à mão. `--check` compara arquivos
com as fontes, detectando inclusões, alterações, remoções e links inválidos.
Os `.gitignore` de `.pbai4devs` e dos clientes também são gerados dos
[modelos](../../../templates/gitignore/TEMPLATE.md). Preserve regras próprias
fora do bloco gerenciado; `--check` identifica blocos ausentes ou divergentes.
`--force` repara conflitos gerenciados com backup local em `.agent-tests/`.
Preserve recursos nativos humanos, inclusive colisões de nomes; links humanos
são opacos e nunca devem ser atravessados. Confira `preserved` no JSON da CLI.
Não apague raízes inteiras: workflows, configurações nativas e a origem ficam
fora da limpeza. `--check` só confere, sem corrigir nem criar backups.

O manifesto `.pbai4devs/espelhos.conf` registra clientes e formatos nativos.
Respeite a seleção salva em `estado/agentdevkit.json`; não reative clientes para
reparar apontamentos. Para alterá-la, use `agents` na CLI. Pastas compartilhadas
continuam quando necessárias; arquivos próprios dos clientes são preservados
pela CLI, inclusive ao reduzir a seleção.
Use `gitignore|pasta` para pastas como `.vscode`, sem espelhar recursos nelas.
`plano` adapta os nomes à descoberta dos clientes; metadados próprios de SDK
podem vir de um YAML ao lado da fonte. Antigravity e Gemini recebem seus
apontamentos; o catálogo geral inclui comandos, tools, scripts e modelos.
Não replique tools, scripts, templates, estado, testes, docs ou guias.
Não use `--documento`; mantenha documentos fora dos espelhos.

Confira a [compatibilidade](../../../COMPATIBILIDADE.md); um link não importa
seu conteúdo. Sem Node, use o preparo automático das ferramentas.