sincronizar-agentes · diff
git:20261112.b26b74b to git:20261113.0f09c58
1 added, 1 removed. Audit A to A.
What this update changes in the checks
No check changed: every fixed check gives the same answer before and after this update.
A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.
---
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
+ Respeite a seleção salva em `state/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.