auditar-specs
Skill0 starsChanged 3 days agoMITView on GitHub
Audita a distância entre o que as specs dizem e o que o código faz — dependências fora da stack, fases marcadas erradas, requisitos não implementados e comportamento sem respaldo em spec. Só relata, não corrige. Use quando o usuário disser "as specs estão em dia?", "auditar as specs", "o que saiu do combinado", "revisar a constituição" ou invocar /auditar-specs.
In this repository15 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- adrSkill
- changelogSkill
- configurarSkill
- constituicaoSkill
- diagnosticoSkill
- implementar-faseSkill
- iniciar-conversaSkill
- iniciar-sddSkill
- licaoSkill
- replanejar-roadmapSkill
- sessao-gerenteSkill
- spec-de-faseSkill
- validar-faseSkill
The file
Files
Auditar specs contra o código
Lê: specs/ inteiro e o código que cada spec descreve. É a skill que mais lê: comece pelos
manifestos e pelas specs, e abra o código só para conferir um ponto concreto.
Escreve: nada. O resultado é um relatório na conversa; corrigir é decisão do usuário.
Decide: o que é desvio do código e o que é spec desatualizada. São defeitos diferentes, com
donos diferentes, e confundi-los faz corrigir o lado errado.
Spec envelhece em silêncio. Esta auditoria torna o desvio visível antes que ele custe caro.
O que verificar
1. Stack
Compare specs/tech-stack.md com o manifesto de dependências real (package.json,
pyproject.toml, go.mod, …).
- Dependência instalada e não declarada: como entrou?
- Versão divergente da registrada
- Comando de teste ou lint documentado que não existe mais
- Tecnologia listada em "o que não usamos" e presente no código
2. Roadmap
- Fase marcada
[x]cujos entregáveis não estão no código - Fase
[ ]já implementada, marcada errada - Funcionalidade em produção que nunca passou por fase alguma
3. Specs de fase
- Requisito de
requirements.mdsem implementação correspondente - Item de
validation.mdque hoje falharia - "Fora de escopo" que foi implementado assim mesmo
- Perguntas em aberto que continuam abertas depois do merge
4. Missão
- Funcionalidade que não serve a nenhuma persona nem a nenhum critério de sucesso
- Não-objetivo violado
- Termo de domínio usado no código com sentido diferente do glossário
5. Lições e regras
python3 .claude/regua.py --conferir: o índice das lições bate comdocs/licoes/- Lição que manda uma ação obrigatória sem a regra correspondente no
AGENTS.md
Relatório
Uma tabela, ordenada por custo de deixar como está:
| Desvio | Onde | Evidência | Correção sugerida |
| dependência não declarada | package.json:24 | zod 3.23.8 | declarar em tech-stack.md ou remover |
Para cada desvio, diga de que lado corrigir: spec desatualizada (o código está certo, o documento envelheceu) ou código fora do combinado (o documento está certo, alguém desviou). São correções opostas: não misture.
Restrições
- Não altere nenhum arquivo nesta skill; proponha e espere
- Evidência sempre com arquivo e linha, lidos no commit atual (diga qual)
- Não confunda desvio com dívida já registrada em ADR: cite o ADR e siga
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

