auditlisted
Install: claude install-skill Kairos-commu/socle
# /audit — cohérence doc ↔ code
**Ne rien modifier.** Ce skill produit un rapport. Si une correction est ensuite demandée,
c'est une tâche séparée — mélanger les deux fait perdre la vue d'ensemble à mi-chemin.
## Périmètre
Tous les `.md` du dépôt hors `node_modules`, plus les `SKILL.md`. Le manifeste
`.claude/check.json` peut déclarer `audit.exclude` pour en écarter.
**Un journal d'incidents est un cas à part.** C'est un document historique daté : un chemin
ou un nom de fonction qui y est cité peut légitimement avoir disparu, et un ancien nom y est
délibérément conservé pour les événements antérieurs à un renommage. N'y signaler une
divergence que si elle casse la **lecture du post-mortem lui-même** — jamais « ce fichier
n'existe plus aujourd'hui », c'est attendu. Le déclarer dans `audit.historical`.
## Vérifications
1. **Chemins de fichiers cités** — pour chacun, vérifier qu'il existe. Lister les obsolètes.
2. **Noms de fonctions, classes, constantes cités** — pour chacun, grepper les sources.
Lister ceux qui n'existent plus ou ont été renommés. C'est ici que se voient les
renommages appliqués au code mais pas à la doc.
3. **Pièges / gotchas documentés** — pour chaque piège numéroté, vérifier que le motif décrit
existe encore sous cette forme. Un piège qui référence du code supprimé mérite d'être
**signalé, pas nécessairement supprimé** : la leçon peut survivre au code.
4. **Commandes documentées** — chaque commande citée existe-t-elle dans `package.json