designwithai-mcp 0.10.0 → 0.12.0

package/README.md

@@ -119,6 +119,9 @@ règles, anti-patterns, prompts, checklists, scorecards), en lecture.
 | `save_framing` | Écrit un dossier de cadrage dans le projet, au format que `framing_criteria` relit | refuse la FORME, jamais le contenu ; le **verdict** ne s'y pose qu'après passage devant le juge |
 | `list_framings` | Les cadrages du projet et leur verdict — ou son absence, dite telle quelle | `judged_only` ne rend que ceux qui ont passé leur juge |
 | `submit_annotations` | Reçoit un lot d'éléments POINTÉS dans une app qui tourne (route, sélecteur, note) | normaliseur tolérant ; ce qui n'est pas compris est GARDÉ, ce qui n'est pas rangeable est NOMMÉ |
+| `craft_report` | Mesure les règles de l'art : espacements, tailles, couleurs, rayons, bascules, cibles | **déterministe, zéro modèle** ; dit toujours contre quoi il a mesuré |
+| `list_craft_rules` | Le référentiel : chaque règle, sa mesure, sa tolérance, ses exceptions, sa source | une règle non calculable n'y entre pas |
+| `declare_source_of_truth` *(étendu)* | Déclare aussi le SYSTÈME : base d'espacement, ratio typo, bascules, plancher de cible | ce qui est déclaré fait foi — la convention ne passe jamais devant |
 | `framing_criteria` *(étendu)* | Les critères d'acceptation à vérifier, **projet d'abord**, compte ensuite | la source lue est nommée ; un dossier jamais jugé le dit |
 
 **Recherche sémantique** (optionnelle, sans clé) : `npm run embed` pré-calcule des embeddings locaux (modèle multilingue, ONNX) → `handbook-embeddings.json`. Présent, `search_handbook` devient hybride (mots-clés + sens) ; absent, il retombe sur les mots-clés seuls. À relancer après chaque régénération de `handbook.json`.
@@ -196,6 +199,30 @@ ni nouveaux.
 Les lots vivent dans `.designwithai/annotations/` (`DWAI_ANNOTATIONS_PATH`).
 Un constat sans ancre suit exactement le chemin d'avant.
 
+### Les règles de l'art, mesurées et non récitées
+
+Les conventions du métier — base 8, échelles à ratio, plages de bascule — entrent
+dans le produit **codifiées**, pas en dogme dans un prompt. Chaque règle est un
+objet (`craft-rules.ts`) : un identifiant stable, la fonction qui la calcule
+(`craft-measures.ts`, pur et sans modèle), sa tolérance, ses exceptions, et le
+chapitre du manuel qui la fonde — vérifié contre le manuel par un test.
+
+**Une règle qu'aucune fonction ne peut calculer n'entre pas dans le
+référentiel.** Elle reste dans le `SKILL.md` du juge concerné, où elle a
+toujours vécu.
+
+Et la préséance, qui empêche le référentiel de devenir un dogme :
+
+1. **le système DÉCLARÉ fait foi.** Une base de 5 pixels déclarée et tenue n'est
+   pas un défaut de grille ;
+2. à défaut, **la cohérence interne** mesurée sur le code ;
+3. à défaut de tout, **la convention** — annoncée comme telle dans la phrase.
+
+Un rapport dit toujours contre quoi il a mesuré. `better-layout`,
+`better-responsive`, `better-interface` et `better-consistency` appellent
+`craft_report` en premier : ils interprètent et priorisent des chiffres, ils ne
+les refont pas à l'œil.
+
 **Prompts** — les 10 skills de `skills/` exposés comme prompts MCP (`/better-layout`,
 `/better-interface`, `/review-ai-product`…). Chaque prompt est *self-contained* :
 socle commun + corps du skill + invocation renseignée par les arguments