# Audits

Deux audits ont relu Récit en entier, en lecture seule, et rangé ce qui ne va pas en constats
numérotés, chacun avec sa preuve (fichier et ligne) et sa recommandation. Leurs textes complets
vivent dans le dépôt, sous `sites/plans/audits/`, avec leurs captures et leurs liens vers les
fichiers : ils se lisent sur GitHub, pas ici. Cette page en donne l'essentiel.

## Audit technique

[`sites/plans/audits/audit.md`](https://github.com/vguerand/recit/blob/main/sites/plans/audits/audit.md),
écrit le 25/10/2026 après P4.

- **163 constats** : 3 critiques, 67 majeurs, 93 mineurs, en dix domaines (code mort, doublons,
  types, structure de packages, documentation, plans et code, tests, bonnes pratiques, skills,
  compréhension).
- **Le diagnostic** : trois imports successifs (le framework de sites, presentation-engine, emaki)
  jamais réconciliés entre eux, d'où deux vocabulaires, plusieurs systèmes de types pour un même
  concept, des doublons de composants et des règles écrites mais non vérifiées.
- **Les trois critiques** : une release qui publiait sur npm sans approbation (ST-1), des captures
  e2e jamais comparées en CI Linux (TE-1), et un vocabulaire « deck » qui désignait aussi le modèle
  vidéo (CG-1). Les trois sont réglées.
- **Le plan d'action** : 20 lots, menés du 25 au 27/10 ; chaque lot a sa note dans
  [l'archive du journal](/archive/journal-2026-10).

## Audit de design

[`sites/plans/audits/audit-design.md`](https://github.com/vguerand/recit/blob/main/sites/plans/audits/audit-design.md),
écrit le 30/10/2026 à la fin du plan 19, à partir des 1 659 captures de référence.

- **44 constats**, `D-01` à `D-44` : fondations visuelles, surfaces, composants, états, fiabilité
  des captures.
- **Le diagnostic** : du soin partout, mais pas de décision unique. Le site, les decks, le motion et
  Storybook parlent chacun leur dialecte : deux jeux de jetons aux mêmes noms, deux familles
  sans-serif et deux mono, trois violets, trois noirs en mode sombre, quatre badges.
- **Les priorités** : des références fiables (D-01, réglé le 02/11 par la régénération de toutes les
  captures Linux), une seule source de jetons, puis la typographie, la marque et les surfaces
  sombres. D-02 (bordure invalide) et D-34 (halo de focus) sont corrigés depuis le 30/10.
- **Les dix actions** sont à la fin de l'audit ; elles attendent un plan qui les ordonne.

## Écrire un nouvel audit

Un audit est en lecture seule : il ne change ni code ni référence. Il va dans `sites/plans/audits/`,
sous un nom daté si un autre existe déjà sur le même sujet, et cette page reçoit son résumé. Ses
constats portent un préfixe et un numéro stables, cités ensuite par les plans, les commits et le
journal.