guarding-doc-integritylisted

# Guarding Doc Integrity ## Visão geral Governança de fontes de verdade: **um assunto tem um arquivo dono; valor concreto só existe no dono + espelhos sancionados; todo o resto do repo linka.** O mapa dono→espelhos vive num manifesto `deps.toml` versionado no repo, e um validador roda como gate determinístico em duas camadas: **hook pré-commit versionado (opt-in, instalado no bootstrap)** e **gate de sessão** (o comando manual abaixo, para quem não instalou o hook). A integridade não pode depender da diligência de uma sessão — greps ad-hoc não são garantia; o script é. ## Quando usar - O repo tem `deps.toml` e a mudança toca qualquer `.md`. - Um valor de regra de negócio mudou e está (ou pode estar) duplicado em vários arquivos. - O usuário pede rastreamento de integridade documental / consolidação de fontes de verdade. Quando NÃO usar: repo sem docs canônicos, ou mudança que não toca arquivo mapeado. ## Fluxos ### 1. Bootstrap (repo ainda sem deps.toml) 1. Levante valores duplicados: `grep -rnE '[0-9]+ ?(km|h|%)|R\$ ?[0-9.]+' --include='*.md' .` + leitura de CLAUDE.md/PRD/README. 2. Proponha ao usuário: dono de cada assunto, espelhos sancionados (máx. 2–3 por dono), valores a rastrear. 3. Crie `deps.toml` na raiz a partir de `templates/deps.toml` (desta skill). 4. Rode o validador e corrija as violações do estado atual (duplicata fora dos sancionados vira **link** para o dono) até PASS. Esse é o baseline do repo. 5. **Ofereça o hook pré-commit** (opt-in — recusa segu