igoruehara/spec-driven/auditar

Skill: Auditar a esteira SDD

Verifica se o projeto respeita o padrão da esteira. Duas camadas: estrutural (script, determinístico) e semântica (julgamento do agente).

1. Checagem estrutural (determinística)

Rode os validadores e reporte a saída:

node scripts/audit-esteira.mjs .
node scripts/validate-mermaid.mjs .

O primeiro cobre: frontmatter presente + dialeto certo (alwaysApply nos docs; name+description nas skills), links relativos quebrados e toda specs/NNNN-*/ com spec.md. O segundo valida os blocos Mermaid (tipo, aspas, delimitadores). Exit ≠ 0 em qualquer um = falhou.

2. Checagem semântica (julgamento)

O script não pega tudo. Verifique também:

• Rastreabilidade: cada AC-N da spec aparece em tasks.md (coluna "Cobre AC") e tem teste?
• Specs órfãs: features em specs/ sem PR/implementação correspondente, ou paradas há tempo

(cruze com STATE.md).

• Docs vivas: glossário e context-map.md refletem os termos/fronteiras atuais? ADRs cobrem

as decisões difíceis de reverter já tomadas?

• DoD pendente: features marcadas prontas com SPEC_DEVIATION aberto ou AC sem teste.
• Frontmatter `alwaysApply`: o que é base está true; o resto false com description que diz quando puxar.

Saída

Liste as violações por arquivo, separando estrutural (corrigir já) de semântica (revisar). Ofereça corrigir as triviais (frontmatter, links). Não invente conformidade — relate o que achou.

Esta skill é o complemento humano/agente do gate de CI (/setup-ci roda o mesmo script).