designwithai-mcp 0.1.0

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "designwithai-mcp",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "UNLICENSED",
+  "description": "Le serveur designwithai pour ton éditeur : audite ton produit, trace les corrections, et fait remonter les résultats dans ton tableau de bord.",
+  "keywords": ["mcp", "design-system", "audit", "claude", "cursor"],
+  "homepage": "https://designwithai.fr",
+  "bin": {
+    "designwithai-mcp": "dist/server.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "handbook-embeddings.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "tsx scripts/test-finding-identity.ts && tsx scripts/check-goldens.ts",
+    "start": "node dist/server.js",
+    "dev": "tsx src/server.ts",
+    "embed": "node scripts/embed.mjs",
+    "prepack": "node scripts/prepack.mjs && npm run build",
+    "postpack": "node scripts/prepack.mjs --clean"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0"
+  },
+  "peerDependencies": {
+    "@huggingface/transformers": "^4.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@huggingface/transformers": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "tsx": "^4",
+    "typescript": "^5"
+  }
+}

package/skills/EVALS.md

@@ -0,0 +1,122 @@
+# Banc d'éval des skills
+
+Ce que le Handbook prêche (Vol.2 Ch.06 : geler un dataset d'éval), les skills le
+tiennent. Chaque skill peut être **prouvé** sur un corpus, pas seulement décrit.
+C'est la barrière concurrentielle : on démontre que le skill détecte, reste dans
+son périmètre, et refuse quand l'artefact est insuffisant.
+
+## Le corpus
+
+Un fichier par skill : `skills/<skill>/evals/cases.json` — un tableau de cas.
+Chaque cas couvre un `kind` :
+
+- `conformant` — rien à trouver (teste les faux positifs) ;
+- `obvious-defect` — défauts nets (teste la détection) ;
+- `subtle-defect` — défauts fins (teste la finesse) ;
+- `out-of-scope` — les défauts sont du ressort d'un AUTRE skill (teste le périmètre) ;
+- `insufficient` — pas d'artefact exploitable (teste le refus).
+
+```json
+{
+  "id": "layout-obvious-dashboard",
+  "skill": "better-layout",
+  "kind": "obvious-defect",
+  "delivery_mode": "ai-builder",
+  "artifact": "Description, code ou URL de l'écran…",
+  "golden": {
+    "expected_findings": ["ce qu'un bon audit DOIT trouver", "…"],
+    "forbidden_findings": ["ce qu'il ne doit PAS dire (hors périmètre, invention)"],
+    "expected_verdict": "FAIL",
+    "should_refuse": false
+  }
+}
+```
+
+## Les juges serveur, au même banc
+
+Deux juges ne sont pas des skills : `analyze-url` et `analyze-figma` tournent
+dans les fonctions serveur, avec leur propre grille (`_shared/model.ts`). Ils
+n'en jugent pas moins en production, et un juge non prouvé ne devrait pas juger.
+Leur corpus vit donc au même endroit que les autres —
+`skills/analyze-url/evals/cases.json`, `skills/analyze-figma/evals/cases.json` —
+**sans `SKILL.md`**.
+
+Ce n'est pas une convention de rangement, c'est ce que le code fait déjà :
+`loadCases` et `getCase` parcourent tous les dossiers de `skills/`, tandis que
+`loadSkills` n'enregistre que ceux qui portent un `SKILL.md`. Un dossier
+corpus-seul est donc visible du banc et invisible du catalogue — le serveur
+continue d'annoncer dix skills, pas douze. Aucun outil de code n'a été touché
+pour ça.
+
+Leurs artefacts ne sont pas décrits, ils sont **figés tels que le juge les
+reçoit** : la sortie réelle de `extractSkeleton` pour les pages, celle de
+`fetchFigmaSummary` pour les maquettes. Un cas d'éval qui paraphraserait le
+matériau ne prouverait rien du juge qui tourne.
+
+## Le cycle (via le MCP)
+
+1. `list_eval_cases(skill)` — les cas disponibles (golden jamais révélée).
+2. `get_eval_case(case_id)` — l'artefact **à l'aveugle**. On applique le skill dessus.
+3. `score_review(case_id, findings, verdict, refused)` — score contre la golden.
+4. `skill_scorecard(skill)` — l'agrégat.
+
+## Les métriques
+
+- **Détection** : part des `expected_findings` retrouvés (recouvrement de tokens ≥ 0,5).
+- **Périmètre** : aucun `forbidden_findings` signalé.
+- **Faux positifs** : cas `conformant`/`out-of-scope` où le skill a inventé un
+  problème **significatif** — un finding hors golden dont la sévérité est
+  `majeur`, `critique` ou `bloquant` (sévérité absente ou inconnue : comptée comme
+  significative, le doute ne protège pas le skill). Les `mineur` et `note` ne
+  comptent pas : un audit de bout en bout produit légitimement des remarques de
+  faible sévérité sur un produit sain.
+- **Verdict** : quand la golden fixe un `expected_verdict`, il doit être rendu
+  **et** correspondre — un verdict manquant est un échec.
+- **Refus** : `should_refuse` respecté sur les cas insuffisants.
+
+Un cas **passe** si : refus correct, périmètre respecté, verdict conforme (quand
+un `expected_verdict` est fixé), détection ≥ 75 %, et — pour un cas sans défaut —
+aucun faux positif significatif.
+
+Plafond assumé du matcher : il compare des mots de contenu (mots vides écartés) et
+exige au moins deux mots partagés dès que la phrase en compte deux — donc sur une
+phrase interdite de deux mots, une violation qui n'en partage qu'un n'est pas
+attrapée. Limite connue du recouvrement lexical, à lever plus tard par une
+approche sémantique.
+
+Conséquence directe sur l'écriture des goldens : le matcher écarte les mots
+vides **et tout token de deux caractères ou moins**, chiffres compris. Une
+golden écrite « espacements 14, 15 et 16 côte à côte » ne pèse que deux mots
+utiles (`espacements`, `cote`) et passe sous le plancher de deux mots partagés :
+le constat le plus juste du monde n'y sera jamais apparié. C'est un vrai manqué
+du banc, pas une hypothèse. **Une phrase de golden porte au moins trois mots de
+contenu, et ne repose jamais sur des nombres seuls** — les nombres restent utiles
+pour la lisibilité humaine, mais ils ne comptent pas pour l'appariement.
+
+Seconde règle, apprise au même prix : **une phrase interdite s'écrit avec des
+mots que le constat juste n'emploierait pas.** Le matcher se contente de 50 % de
+recouvrement, or un cas travaille toujours dans un vocabulaire étroit —
+« autorisation » et « relevés » sur un corpus sécurité, « lien » et « suivi » sur
+un corpus navigation. Une interdite courte, faite des mots du domaine, se
+déclenche sur la bonne réponse et s'affiche en « périmètre violé » pour un juge
+irréprochable. Écris-la sur l'ACTE fautif (« recommander de fusionner… »,
+« prétendre que… », « reprocher l'absence de… »), pas sur l'objet du cas.
+
+`npm test` (côté `mcp/`) tient les deux règles : `scripts/check-goldens.ts`
+bloque une `expected_findings` non reconnaissable (elle ferait échouer un cas à
+tort) et une `forbidden_findings` que le matcher reconnaît dans une
+`expected_findings` du même cas (elle punirait une review correcte). Il signale
+une `forbidden_findings` trop courte, qui ne fait que laisser passer une
+violation.
+
+Corollaire pour les goldens : n'encode pas le verdict ou la recommandation dans
+`expected_findings` (ce ne sont pas des problèmes trouvés). Le verdict se prouve
+par `expected_verdict`, la discipline par `forbidden_findings`, l'intention par
+`note`.
+
+## Ajouter un skill au banc
+
+Crée `skills/<skill>/evals/cases.json` avec 5+ cas couvrant les `kind`. Écris la
+golden à la main, depuis le périmètre du skill — pas depuis ce que le modèle
+produit aujourd'hui (même règle que le dataset gelé du Ch.06). Les résultats
+sont stockés hors dépôt dans `.designwithai/evals/` (`DWAI_EVALS_PATH`).

package/skills/README.md

@@ -0,0 +1,59 @@
+# Skills — bibliothèque opérationnelle
+
+10 skills pour auditer, corriger et industrialiser les interfaces. Ce ne sont
+pas des prompts génériques : ce sont des **rôles spécialisés à frontières
+explicites**. Les experts analysent une dimension précise ; les orchestrateurs
+sélectionnent, coordonnent et agrègent les experts sans dupliquer leur travail.
+
+Chaque skill possède un périmètre fermé, des preuves obligatoires, un format de
+sortie stable et des critères de validation.
+
+## Socle partagé
+
+Importé par tous les skills — voir `_shared/` :
+
+- [`execution-contract.md`](_shared/execution-contract.md) — mode d'exécution, hiérarchie des preuves, règles de scope, priorisation, format de sortie, règle anti-générique.
+- [`issue-schema.md`](_shared/issue-schema.md) — le schéma commun d'un problème.
+- [`severity-model.md`](_shared/severity-model.md) — sévérités et verdict global.
+- [`delivery-modes.md`](_shared/delivery-modes.md) — la matrice des modes de delivery.
+
+## Les skills
+
+| Skill | Rôle | Ce qu'il couvre |
+|---|---|---|
+| [`better-layout`](better-layout/SKILL.md) | Design expert | Composition, spacing, hiérarchie et densité |
+| [`better-accessibility`](better-accessibility/SKILL.md) | Quality expert | Accessibilité fonctionnelle et technique |
+| [`better-writing`](better-writing/SKILL.md) | Content expert | UX writing et microcopy produit |
+| [`better-responsive`](better-responsive/SKILL.md) | Design expert | Comportements multi-viewport |
+| [`better-states`](better-states/SKILL.md) | Interaction expert | États, transitions et récupération |
+| [`better-forms`](better-forms/SKILL.md) | UX expert | Formulaires et saisie de données |
+| [`better-components`](better-components/SKILL.md) | System expert | Architecture et réutilisation des composants |
+| [`better-consistency`](better-consistency/SKILL.md) | System expert | Cohérence transversale du produit |
+| [`better-interface`](better-interface/SKILL.md) | Orchestrator | Orchestration de la revue d'interface |
+| [`review-ai-product`](review-ai-product/SKILL.md) | Product orchestrator | Audit de production-readiness d'un produit construit avec un générateur IA |
+
+## Règles d'orchestration
+
+- **Un expert ne déclenche pas automatiquement un autre expert.** Il signale la dépendance et renvoie le contexte utile.
+- **Un orchestrateur peut appeler plusieurs experts.** Il doit expliquer pourquoi chacun est activé.
+- **La même cause racine ne doit pas devenir cinq tickets.** L'orchestrateur fusionne les impacts tout en conservant les critères spécifiques.
+- **`review-ai-product` possède la priorité sur la sécurité et les données.** Les corrections UI ne passent jamais avant un risque bloquant de permission, secret ou intégrité.
+- **`better-interface` possède la priorité sur l'ordre de correction visuel.** Il traite d'abord fondations, composants et patterns, puis occurrences locales.
+
+## Modes de delivery
+
+Le champ `supports` de chaque skill (`ai-builder` / `traditional` / `hybrid`)
+correspond au `deliveryMode` du site et du serveur MCP (`traditional` = la valeur
+`classique` du reste du projet). Chaque skill a une section « Adaptation au mode
+de delivery ».
+
+## Intégration
+
+Ces `SKILL.md` sont la **forme canonique et portable**. Deux surfaces possibles,
+sans réécrire le contenu :
+
+- **Claude Code** — copier ou lier un dossier de skill sous `.claude/skills/` pour l'invoquer comme slash-command (`/better-layout`) dans ce dépôt. Le frontmatter `name` + `description` est déjà au format attendu.
+- **Serveur MCP** — exposer chaque skill comme *prompt* MCP (voir `mcp/`), pour que Claude ou un IDE les invoque avec le contexte du Handbook.
+
+Ordre recommandé (page « Organisation » du document source) : tester chaque skill
+sur un artefact différent **avant** de construire les orchestrateurs sur eux.

package/skills/_shared/delivery-modes.md

@@ -0,0 +1,12 @@
+# Matrice des modes de delivery
+
+Chaque skill adapte ses contrôles au mode de construction du produit. Les modes
+correspondent au `deliveryMode` du site et du serveur MCP (`ai-builder` /
+`classique` / `hybride` ; le frontmatter des skills note `traditional` pour
+`classique`, historique du document source).
+
+| Mode | Source de vérité probable | Risque dominant | Vérification attendue |
+|---|---|---|---|
+| **AI Builder** | Générateur IA + dépôt synchronisé + backend / BaaS | Régressions de génération, duplication, dette invisible | Comparaison avant/après, routes, données, permissions |
+| **Classique** | Figma + Design System + code + Storybook | Perte d'information entre conception et développement | Mapping design/code, tests, critères d'acceptation |
+| **Hybride** | Plusieurs sources en concurrence | Divergence et responsabilités floues | Décision explicite de source canonique par couche |

package/skills/_shared/execution-contract.md

@@ -0,0 +1,43 @@
+# Contrat commun à tous les skills
+
+À inclure dans chaque skill ou à importer comme règle partagée. Il empêche les
+audits vagues, les recommandations hors scope et les modifications dangereuses.
+
+## 1. Mode d'exécution
+
+- **Diagnostiquer par défaut.** Le skill analyse et produit des recommandations. Il ne modifie aucun fichier, écran, base de données ou environnement sans demande explicite.
+- **Proposer avant de patcher.** Quand une correction de code est demandée, le skill décrit d'abord le périmètre, les fichiers concernés, les risques et le plan de vérification.
+- **Travailler par lot cohérent.** Une correction vise un problème ou un groupe fortement lié. Éviter les refontes diffuses qui rendent les régressions impossibles à isoler.
+- **Vérifier après action.** Toute modification est suivie d'une vérification ciblée puis d'un contrôle de non-régression sur les zones adjacentes.
+
+## 2. Hiérarchie des preuves
+
+- **Preuve directe.** Le problème est visible dans une capture, reproductible dans le produit, identifiable dans le code ou démontré par un test.
+- **Preuve croisée.** Plusieurs artefacts convergent : Figma, production, Storybook, code, analytics ou retours utilisateurs.
+- **Inférence.** Le problème est probable mais non démontré. Le marquer comme hypothèse et indiquer la vérification nécessaire.
+- **Absence de preuve.** Le skill ne conclut pas. Il demande ou liste les informations manquantes dans la section Blocages.
+
+## 3. Règles de scope
+
+- **Rester dans le mandat.** Chaque skill analyse uniquement sa dimension. Il peut signaler une dépendance vers un autre skill, mais ne développe pas l'audit hors scope.
+- **Respecter l'intention produit.** Ne pas transformer la proposition de valeur, les règles métier ou la direction visuelle sans demande explicite.
+- **Préserver la source de vérité.** Identifier Figma, le code, Storybook, les tokens, le générateur IA ou la production comme source de référence. En cas de conflit, le signaler avant toute correction.
+- **Ne pas inventer.** Ne pas supposer des utilisateurs, des contraintes, des données, des états ou des objectifs absents des artefacts.
+
+## 4. Priorisation
+
+- **Bloquant.** Empêche une action essentielle, expose un risque de sécurité, détruit des données ou rend le produit inutilisable pour un groupe d'utilisateurs.
+- **Critique.** Cause fréquente d'échec, de perte de compréhension ou de non-conformité sur un parcours principal.
+- **Majeur.** Dégrade nettement l'efficacité, la cohérence, la maintenance ou la qualité perçue.
+- **Mineur.** Défaut local à faible impact, mais réel et vérifiable.
+- **Note.** Observation utile, opportunité ou dette à documenter sans action immédiate.
+
+## 5. Format de sortie
+
+- **Résumé exécutif.** Verdict en cinq lignes maximum, dimensions analysées, niveau de confiance et principaux risques.
+- **Contexte et limites.** Artefacts reçus, éléments absents, viewports, routes ou composants couverts.
+- **Problèmes priorisés.** Registre structuré conforme au schéma commun (voir `issue-schema.md`).
+- **Plan de correction.** Ordre d'action, dépendances, effort relatif et vérifications.
+- **Critères de sortie.** Conditions permettant de conclure que la revue est réussie.
+
+> **Règle anti-générique.** Chaque recommandation doit inclure une localisation, une preuve et un critère d'acceptation. « Améliorer la hiérarchie » ou « rendre plus accessible » n'est jamais une sortie acceptable sans préciser où, pourquoi et comment valider.

package/skills/_shared/issue-schema.md

@@ -0,0 +1,25 @@
+# Schéma commun d'un problème
+
+Tout problème rapporté par un skill suit ce schéma.
+
+| Champ | Exigence |
+|---|---|
+| **ID** | Identifiant stable, par exemple `LAYOUT-03`. |
+| **Sévérité** | Bloquant, critique, majeur, mineur ou note (voir `severity-model.md`). |
+| **Localisation** | Route, écran, composant, viewport, fichier ou ligne. |
+| **Preuve** | Observation concrète. Jamais une impression vague. |
+| **Impact** | Conséquence utilisateur, produit, maintenance ou risque. |
+| **Correction** | Action minimale et cohérente, pas une refonte automatique. |
+| **Critères d'acceptation** | Conditions observables permettant de valider le correctif. |
+| **Confiance** | Élevée, moyenne ou faible, selon les preuves disponibles. |
+
+Le préfixe d'ID est propre à chaque skill : `LAYOUT`, `A11Y`, `COPY`, `RESP`,
+`STATE`, `FORM`, `COMP`, `CONS`, `NAV` (better-navigation), `UI`
+(better-interface), `SEC` (review-data-security), `FIG`
+(review-figma-hygiene), `SHIP` (review-ai-product).
+
+Un préfixe ne change jamais en traversant un orchestrateur. Les constats de
+`review-data-security` remontent dans un audit complet avec leurs identifiants
+`SEC`, jamais renumérotés : le suivi de progression apparie les constats d'une
+passe à l'autre, et renuméroter ferait réapparaître les mêmes problèmes comme
+nouveaux.

package/skills/_shared/severity-model.md

@@ -0,0 +1,16 @@
+# Modèle de sévérité et verdict global
+
+## Sévérité d'un problème
+
+- **Bloquant.** Empêche une action essentielle, expose un risque de sécurité, détruit des données ou rend le produit inutilisable pour un groupe d'utilisateurs.
+- **Critique.** Cause fréquente d'échec, de perte de compréhension ou de non-conformité sur un parcours principal.
+- **Majeur.** Dégrade nettement l'efficacité, la cohérence, la maintenance ou la qualité perçue.
+- **Mineur.** Défaut local à faible impact, mais réel et vérifiable.
+- **Note.** Observation utile, opportunité ou dette à documenter sans action immédiate.
+
+## Verdict global
+
+- **PASS.** Aucun problème bloquant ou critique. Les corrections restantes n'empêchent pas l'usage prévu.
+- **PASS WITH FIXES.** Le produit peut avancer après un lot limité de corrections clairement identifiées.
+- **FAIL.** Au moins un problème bloquant ou plusieurs problèmes critiques empêchent la mise à disposition ou la validation.
+- **BLOCKED.** Les artefacts ou accès sont insuffisants pour produire un verdict fiable.

package/skills/analyze-figma/evals/cases.json

@@ -0,0 +1,140 @@
+[
+  {
+    "id": "figma-conformant-lecture-partielle",
+    "skill": "analyze-figma",
+    "kind": "conformant",
+    "delivery_mode": "classique",
+    "artifact": "Fichier : Cabinet Lauzun — produit\nDernière modification : 2026-08-11T09:24:31Z\nATTENTION : fichier volumineux — ma lecture s'est arrêtée après 6000 éléments. Ce qui suit est un ÉCHANTILLON, pas l'intégralité du fichier. Ne conclus donc jamais qu'un élément « manque » ou « n'existe pas ».\nPages : 4 — Fondations, Composants, Écrans, Archives\nCadres : 1212 (dont 1212 en auto-layout)\nCalques de texte : 26\nStyles publiés dans la bibliothèque : 68\n\nÉCRANS DE PREMIER NIVEAU (1212)\n  - Fondations › Palette\n  - Fondations › Échelle typographique\n  - Composants › Composant 0\n  - Composants › Composant 1\n  - Composants › Composant 2\n  - Composants › Composant 3\n  - Composants › Composant 4\n  - Composants › Composant 5\n  - Composants › Composant 6\n  - Composants › Composant 7\n  - Composants › Composant 8\n  - Composants › Composant 9\n  - Composants › Composant 10\n  - Composants › Composant 11\n  - Composants › Composant 12\n  - Composants › Composant 13\n  - Composants › Composant 14\n  - Composants › Composant 15\n  - Composants › Composant 16\n  - Composants › Composant 17\n  - Composants › Composant 18\n  - Composants › Composant 19\n  - Composants › Composant 20\n  - Composants › Composant 21\n  - Composants › Composant 22\n  - Composants › Composant 23\n  - Composants › Composant 24\n  - Composants › Composant 25\n  - Composants › Composant 26\n  - Composants › Composant 27\n  - Composants › Composant 28\n  - Composants › Composant 29\n  - Composants › Composant 30\n  - Composants › Composant 31\n  - Composants › Composant 32\n  - Composants › Composant 33\n  - Composants › Composant 34\n  - Composants › Composant 35\n  - Composants › Composant 36\n  - Composants › Composant 37\n  - Composants › Composant 38\n  - Composants › Composant 39\n  - Écrans › Écran 001 · Tableau de bord\n  - Écrans › Écran 002 · Liste des dossiers\n  - Écrans › Écran 003 · Détail dossier\n\nPOLICES ET GRAISSES EMPLOYÉES (3)\n  - Inter 400\n  - Inter 500\n  - Inter 600\n\nTAILLES DE TEXTE EMPLOYÉES (4) : 16, 20, 24, 32\nRAYONS D'ANGLE EMPLOYÉS (3) : 4, 8, 16\nESPACEMENTS EMPLOYÉS (4) : 8, 16, 24, 32\n\nCOULEURS DE REMPLISSAGE, LES PLUS FRÉQUENTES (3 distinctes)\n  - #ffffff — 432 usages\n  - #f7f8fa — 390 usages\n  - #111827 — 390 usages\n\nCOMPOSANTS RÉUTILISÉS (4)\n  - Bouton — 1210 instances\n  - Champ — 1210 instances\n  - Carte — 1170 instances\n  - Entête — 1170 instances\n\nCALQUES RESTÉS AU NOM PAR DÉFAUT (0)\n  (aucun)\n\nFAUX TEXTES REPÉRÉS (0)\n  (aucun)\n\nTEXTES DE LA MAQUETTE (26)\n  - Fondations › « Couleurs de la marque »\n  - Fondations › « Inter 12 / 14 / 16 / 20 / 24 / 32 / 40 »\n  - Écrans › « Dossier 1 — ouvert le 01/03/2026 »\n  - Écrans › « Dossier 2 — ouvert le 02/03/2026 »\n  - Écrans › « Dossier 3 — ouvert le 03/03/2026 »\n  - Écrans › « Dossier 4 — ouvert le 04/03/2026 »\n  - Écrans › « Dossier 5 — ouvert le 05/03/2026 »\n  - Écrans › « Dossier 6 — ouvert le 06/03/2026 »\n  - Écrans › « Dossier 7 — ouvert le 07/03/2026 »\n  - Écrans › « Dossier 8 — ouvert le 08/03/2026 »\n  - Écrans › « Dossier 9 — ouvert le 09/03/2026 »\n  - Écrans › « Dossier 10 — ouvert le 01/03/2026 »\n  - Écrans › « Dossier 11 — ouvert le 02/03/2026 »\n  - Écrans › « Dossier 12 — ouvert le 03/03/2026 »\n  - Écrans › « Dossier 13 — ouvert le 04/03/2026 »\n  - Écrans › « Dossier 14 — ouvert le 05/03/2026 »\n  - Écrans › « Dossier 15 — ouvert le 06/03/2026 »\n  - Écrans › « Dossier 16 — ouvert le 07/03/2026 »\n  - Écrans › « Dossier 17 — ouvert le 08/03/2026 »\n  - Écrans › « Dossier 18 — ouvert le 09/03/2026 »\n  - Écrans › « Dossier 19 — ouvert le 01/03/2026 »\n  - Écrans › « Dossier 20 — ouvert le 02/03/2026 »\n  - Écrans › « Dossier 21 — ouvert le 03/03/2026 »\n  - Écrans › « Dossier 22 — ouvert le 04/03/2026 »\n  - Écrans › « Dossier 23 — ouvert le 05/03/2026 »\n  - Écrans › « Dossier 24 — ouvert le 06/03/2026 »",
+    "golden": {
+      "expected_findings": [],
+      "forbidden_findings": [
+        "la maquette ne montre aucun état vide",
+        "aucun écran d'erreur n'est prévu",
+        "aucun état de chargement représenté",
+        "il manque un écran de connexion",
+        "seuls quarante-cinq écrans sont nommés",
+        "aucun faux texte repéré, donc la maquette est incomplète"
+      ],
+      "expected_verdict": "PASS",
+      "should_refuse": false,
+      "note": "LE CAS DU FICHIER TRONQUÉ. La lecture s'est arrêtée au 6000ᵉ élément et le matériau le dit en tête, en toutes lettres. Tout ce qui suit est un échantillon : 45 noms d'écrans sur 1212, 26 textes sur un fichier qui en compte davantage. Conclure d'un tel extrait qu'un état, un écran ou un texte « manque » est un raisonnement par absence doublé d'une lecture partielle — la faute que ce cas mesure. Ce qui EST observable est bon : 1212 cadres tous en auto-layout, quatre composants réutilisés plus de mille fois, trois rayons, quatre espacements, une seule police, 68 styles publiés. Un fichier tenu."
+    }
+  },
+  {
+    "id": "figma-conformant-textes-coupes",
+    "skill": "analyze-figma",
+    "kind": "conformant",
+    "delivery_mode": "classique",
+    "artifact": "Fichier : Cabinet Lauzun — textes\nDernière modification : 2026-08-12T15:02:00Z\nLecture complète du fichier.\nPages : 1 — Écrans\nCadres : 5 (dont 5 en auto-layout)\nCalques de texte : 10\nStyles publiés dans la bibliothèque : 22\n\nÉCRANS DE PREMIER NIVEAU (5)\n  - Écrans › 01 · Accueil\n  - Écrans › 02 · Conservation\n  - Écrans › 03 · Extraction\n  - Écrans › 04 · Rappel\n  - Écrans › 05 · Paramètres\n\nPOLICES ET GRAISSES EMPLOYÉES (1)\n  - Inter 400\n\nTAILLES DE TEXTE EMPLOYÉES (1) : 16\nRAYONS D'ANGLE EMPLOYÉS (1) : 8\nESPACEMENTS EMPLOYÉS (2) : 16, 24\n\nCOULEURS DE REMPLISSAGE, LES PLUS FRÉQUENTES (1 distinctes)\n  - #ffffff — 5 usages\n\nCOMPOSANTS RÉUTILISÉS (2)\n  - Bouton — 4 instances\n  - Champ — 2 instances\n\nCALQUES RESTÉS AU NOM PAR DÉFAUT (0)\n  (aucun)\n\nFAUX TEXTES REPÉRÉS (0)\n  (aucun)\n\nTEXTES DE LA MAQUETTE (10)\n  - Écrans › « Vos dossiers sont conservés cinq ans après leur clôture, puis archivés automatiquement. Vous recevez un rappel un mois avant l'archivage, et vous pouvez à tout  […coupé par ma lecture, pas par la maquette] »\n  - Écrans › « Vos dossiers »\n  - Écrans › « Vos dossiers sont conservés cinq ans après leur clôture, puis archivés automatiquement. Vous recevez un rappel un mois avant l'archivage, et vous pouvez à tout  […coupé par ma lecture, pas par la maquette] »\n  - Écrans › « Conservation des pièces »\n  - Écrans › « Demandez l'extraction de toutes les pièces d'un dossier au format PDF. Le fichier vous est envoyé par courriel dans l'heure, et reste téléchargeable pendant sep […coupé par ma lecture, pas par la maquette] »\n  - Écrans › « Extraction des pièces »\n  - Écrans › « Un mois avant l'archivage, un rappel est envoyé au responsable du dossier ainsi qu'aux membres qui l'ont consulté au cours des six derniers mois. »\n  - Écrans › « Rappel avant archivage »\n  - Écrans › « Paramètres du cabinet »\n  - Écrans › « Enregistrer les modifications »",
+    "golden": {
+      "expected_findings": [],
+      "forbidden_findings": [
+        "des textes sont tronqués dans la maquette",
+        "phrases coupées au milieu d'un mot",
+        "textes incomplets à finir",
+        "la maquette ne montre aucun état vide",
+        "aucun écran d'erreur n'est prévu"
+      ],
+      "expected_verdict": "PASS",
+      "should_refuse": false,
+      "note": "LE BUG DE TRONCATURE, corrigé pendant la première analyse réelle et gelé ici. Trois textes de la maquette portent la mention « […coupé par ma lecture, pas par la maquette] » : la coupure est NOTRE fait, la maquette est entière. Rapporter une troncature revient à reprocher au produit ce que notre lecture lui a fait — c'est exactement ce qui s'était produit avant que la marque ne soit ajoutée. Le fichier est par ailleurs sain : une police, une taille, un rayon, deux composants réutilisés, aucun calque au nom par défaut, 22 styles publiés."
+    }
+  },
+  {
+    "id": "figma-obvious-sans-systeme",
+    "skill": "analyze-figma",
+    "kind": "obvious-defect",
+    "delivery_mode": "ai-builder",
+    "artifact": "Fichier : TaskFlow app\nDernière modification : 2026-08-05T18:40:12Z\nLecture complète du fichier.\nPages : 1 — Page 1\nCadres : 46 (dont 0 en auto-layout)\nCalques de texte : 92\nStyles publiés dans la bibliothèque : 0\n\nÉCRANS DE PREMIER NIVEAU (46)\n  - Page 1 › Frame 1\n  - Page 1 › Group 2\n  - Page 1 › Rectangle 3\n  - Page 1 › Frame 4\n  - Page 1 › Group 5\n  - Page 1 › Rectangle 6\n  - Page 1 › Frame 7\n  - Page 1 › Group 8\n  - Page 1 › Rectangle 9\n  - Page 1 › Frame 10\n  - Page 1 › Group 11\n  - Page 1 › Rectangle 12\n  - Page 1 › Frame 13\n  - Page 1 › Group 14\n  - Page 1 › Rectangle 15\n  - Page 1 › Frame 16\n  - Page 1 › Group 17\n  - Page 1 › Rectangle 18\n  - Page 1 › Frame 19\n  - Page 1 › Group 20\n  - Page 1 › Rectangle 21\n  - Page 1 › Frame 22\n  - Page 1 › Group 23\n  - Page 1 › Rectangle 24\n  - Page 1 › Frame 25\n  - Page 1 › Group 26\n  - Page 1 › Rectangle 27\n  - Page 1 › Frame 28\n  - Page 1 › Group 29\n  - Page 1 › Rectangle 30\n  - Page 1 › Frame 31\n  - Page 1 › Group 32\n  - Page 1 › Rectangle 33\n  - Page 1 › Frame 34\n  - Page 1 › Group 35\n  - Page 1 › Rectangle 36\n  - Page 1 › Frame 37\n  - Page 1 › Group 38\n  - Page 1 › Rectangle 39\n  - Page 1 › Frame 40\n  - Page 1 › Group 41\n  - Page 1 › Rectangle 42\n  - Page 1 › Frame 43\n  - Page 1 › Group 44\n  - Page 1 › Rectangle 45\n\nPOLICES ET GRAISSES EMPLOYÉES (28)\n  - Inter 400\n  - Poppins 400\n  - Roboto 500\n  - Arial 400\n  - Poppins 600\n  - SF Pro Text 400\n  - Arial 700\n  - Montserrat 400\n  - Open Sans 400\n  - Montserrat 500\n  - Open Sans 600\n  - Roboto 400\n  - Inter 700\n  - Poppins 500\n  - Arial 600\n  - SF Pro Text 700\n  - Open Sans 500\n  - Inter 600\n  - Roboto 700\n  - Arial 500\n\nTAILLES DE TEXTE EMPLOYÉES (16) : 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 22, 24, 26, 28, 32, 36\nRAYONS D'ANGLE EMPLOYÉS (9) : 3, 4, 5, 6, 7, 8, 10, 12, 16\nESPACEMENTS EMPLOYÉS (14) : 5, 7, 9, 10, 11, 13, 14, 15, 16, 17, 18, 20, 22, 24\n\nCOULEURS DE REMPLISSAGE, LES PLUS FRÉQUENTES (15 distinctes)\n  - #ffffff — 7 usages\n  - #2f2f2f — 7 usages\n  - #fefefe — 6 usages\n  - #313131 — 6 usages\n  - #fdfdfd — 6 usages\n  - #3a3a3a — 6 usages\n  - #fafafa — 6 usages\n  - #666666 — 6 usages\n  - #f8f8f8 — 6 usages\n  - #676767 — 6 usages\n  - #333333 — 6 usages\n  - #6a6a6a — 6 usages\n  - #343434 — 6 usages\n  - #999999 — 6 usages\n  - #9a9a9a — 6 usages\n\nCOMPOSANTS RÉUTILISÉS (0)\n  (aucun)\n\nCALQUES RESTÉS AU NOM PAR DÉFAUT (60)\n  - Page 1 › Frame 1\n  - Page 1 › Rectangle 100\n  - Page 1 › Group 2\n  - Page 1 › Rectangle 101\n  - Page 1 › Rectangle 3\n  - Page 1 › Rectangle 102\n  - Page 1 › Frame 4\n  - Page 1 › Rectangle 103\n  - Page 1 › Group 5\n  - Page 1 › Rectangle 104\n  - Page 1 › Rectangle 6\n  - Page 1 › Rectangle 105\n  - Page 1 › Frame 7\n  - Page 1 › Rectangle 106\n  - Page 1 › Group 8\n  - Page 1 › Rectangle 107\n  - Page 1 › Rectangle 9\n  - Page 1 › Rectangle 108\n  - Page 1 › Frame 10\n  - Page 1 › Rectangle 109\n  - Page 1 › Group 11\n  - Page 1 › Rectangle 110\n  - Page 1 › Rectangle 12\n  - Page 1 › Rectangle 111\n  - Page 1 › Frame 13\n  - Page 1 › Rectangle 112\n  - Page 1 › Group 14\n  - Page 1 › Rectangle 113\n  - Page 1 › Rectangle 15\n  - Page 1 › Rectangle 114\n\nFAUX TEXTES REPÉRÉS (20)\n  - Page 1 › « Lorem ipsum dolor sit amet »\n  - Page 1 › « texte ici »\n  - Page 1 › « TODO remplir »\n  - Page 1 › « Lorem ipsum dolor sit amet »\n  - Page 1 › « texte ici »\n  - Page 1 › « TODO remplir »\n  - Page 1 › « Lorem ipsum dolor sit amet consectetur »\n  - Page 1 › « Lorem ipsum dolor sit amet consectetur »\n  - Page 1 › « Lorem ipsum dolor sit amet »\n  - Page 1 › « texte ici »\n  - Page 1 › « TODO remplir »\n  - Page 1 › « Lorem ipsum dolor sit amet »\n  - Page 1 › « texte ici »\n  - Page 1 › « TODO remplir »\n  - Page 1 › « Lorem ipsum dolor sit amet consectetur »\n  - Page 1 › « Lorem ipsum dolor sit amet consectetur »\n  - Page 1 › « Lorem ipsum dolor sit amet »\n  - Page 1 › « texte ici »\n  - Page 1 › « TODO remplir »\n  - Page 1 › « Lorem ipsum dolor sit amet »\n\nTEXTES DE LA MAQUETTE (92)\n  - Page 1 › « Créer un projet »\n  - Page 1 › « Lorem ipsum dolor sit amet »\n  - Page 1 › « Ajouter un espace »\n  - Page 1 › « texte ici »\n  - Page 1 › « Nouveau workspace »\n  - Page 1 › « TODO remplir »\n  - Page 1 › « Soumettre »\n  - Page 1 › « Créé le 12/03/2026 »\n  - Page 1 › « Erreur »\n  - Page 1 › « Modifié le 2026-02-08 »\n  - Page 1 › « Lorem ipsum dolor sit amet »\n  - Page 1 › « Ouvert le 5 janvier 2026 »\n  - Page 1 › « texte ici »\n  - Page 1 › « Mon projet »\n  - Page 1 › « TODO remplir »\n  - Page 1 › « Mon espace »\n  - Page 1 › « Créé le 12/03/2026 »\n  - Page 1 › « Voir le workspace »\n  - Page 1 › « Modifié le 2026-02-08 »\n  - Page 1 › « Lorem ipsum dolor sit amet consectetur »\n  - Page 1 › « Ouvert le 5 janvier 2026 »\n  - Page 1 › « OK »\n  - Page 1 › « Mon projet »\n  - Page 1 › « Créer un projet »\n  - Page 1 › « Mon espace »\n  - Page 1 › « Ajouter un espace »\n  - Page 1 › « Voir le workspace »\n  - Page 1 › « Nouveau workspace »\n  - Page 1 › « Lorem ipsum dolor sit amet consectetur »\n  - Page 1 › « Soumettre »\n  - Page 1 › « OK »\n  - Page 1 › « Erreur »\n  - Page 1 › « Créer un projet »\n  - Page 1 › « Lorem ipsum dolor sit amet »\n  - Page 1 › « Ajouter un espace »\n  - Page 1 › « texte ici »\n  - Page 1 › « Nouveau workspace »\n  - Page 1 › « TODO remplir »\n  - Page 1 › « Soumettre »\n  - Page 1 › « Créé le 12/03/2026 »\n  - Page 1 › « Erreur »\n  - Page 1 › « Modifié le 2026-02-08 »\n  - Page 1 › « Lorem ipsum dolor sit amet »\n  - Page 1 › « Ouvert le 5 janvier 2026 »\n  - Page 1 › « texte ici »\n  - Page 1 › « Mon projet »\n  - Page 1 › « TODO remplir »\n  - Page 1 › « Mon espace »\n  - Page 1 › « Créé le 12/03/2026 »\n  - Page 1 › « Voir le workspace »\n  - Page 1 › « Modifié le 2026-02-08 »\n  - Page 1 › « Lorem ipsum dolor sit amet consectetur »\n  - Page 1 › « Ouvert le 5 janvier 2026 »\n  - Page 1 › « OK »\n  - Page 1 › « Mon projet »\n  - Page 1 › « Créer un projet »\n  - Page 1 › « Mon espace »\n  - Page 1 › « Ajouter un espace »\n  - Page 1 › « Voir le workspace »\n  - Page 1 › « Nouveau workspace »\n  - Page 1 › « Lorem ipsum dolor sit amet consectetur »\n  - Page 1 › « Soumettre »\n  - Page 1 › « OK »\n  - Page 1 › « Erreur »\n  - Page 1 › « Créer un projet »\n  - Page 1 › « Lorem ipsum dolor sit amet »\n  - Page 1 › « Ajouter un espace »\n  - Page 1 › « texte ici »\n  - Page 1 › « Nouveau workspace »\n  - Page 1 › « TODO remplir »\n  - Page 1 › « Soumettre »\n  - Page 1 › « Créé le 12/03/2026 »\n  - Page 1 › « Erreur »\n  - Page 1 › « Modifié le 2026-02-08 »\n  - Page 1 › « Lorem ipsum dolor sit amet »\n  - Page 1 › « Ouvert le 5 janvier 2026 »\n  - Page 1 › « texte ici »\n  - Page 1 › « Mon projet »\n  - Page 1 › « TODO remplir »\n  - Page 1 › « Mon espace »\n  - Page 1 › « Créé le 12/03/2026 »\n  - Page 1 › « Voir le workspace »\n  - Page 1 › « Modifié le 2026-02-08 »\n  - Page 1 › « Lorem ipsum dolor sit amet consectetur »\n  - Page 1 › « Ouvert le 5 janvier 2026 »\n  - Page 1 › « OK »\n  - Page 1 › « Mon projet »\n  - Page 1 › « Créer un projet »\n  - Page 1 › « Mon espace »\n  - Page 1 › « Ajouter un espace »\n  - Page 1 › « Voir le workspace »\n  - Page 1 › « Nouveau workspace »",
+    "golden": {
+      "expected_findings": [
+        "les quarante-six cadres portent tous un nom par défaut, Frame, Group ou Rectangle",
+        "aucun composant réutilisé : chaque écran est redessiné à la main",
+        "vingt-huit couples police et graisse pour une seule page",
+        "seize tailles de texte, échelle non systématique",
+        "neuf rayons d'angle et quatorze espacements, valeurs voisines jamais identiques",
+        "des gris et des blancs presque identiques multipliés",
+        "faux textes Lorem ipsum et texte ici laissés dans les écrans",
+        "le même objet nommé projet, espace et workspace",
+        "trois formats de date dans les textes de la maquette",
+        "aucun style publié dans la bibliothèque"
+      ],
+      "forbidden_findings": [
+        "revoir la hiérarchie visuelle des écrans",
+        "le contraste entre le texte et le fond est insuffisant",
+        "prévoir l'export des composants en React",
+        "refondre entièrement la maquette"
+      ],
+      "expected_verdict": "FAIL",
+      "should_refuse": false,
+      "note": "Maquette sans système, lecture complète — donc tout est observable et rien n'est déduit d'une absence d'extraction. Deux constats sont critiques : les faux textes qui partiront au développement, et l'absence totale de composant réutilisé sur quarante-six écrans, qui condamne l'intégration à recommencer chaque écran. D'où le FAIL déduit. Le zéro auto-layout et le zéro style publié sont recevables en plus."
+    }
+  },
+  {
+    "id": "figma-subtle-valeurs-voisines",
+    "skill": "analyze-figma",
+    "kind": "subtle-defect",
+    "delivery_mode": "classique",
+    "artifact": "Fichier : Relevés — maquette produit\nDernière modification : 2026-08-14T11:11:00Z\nLecture complète du fichier.\nPages : 2 — Écrans, Composants\nCadres : 9 (dont 7 en auto-layout)\nCalques de texte : 18\nStyles publiés dans la bibliothèque : 24\n\nÉCRANS DE PREMIER NIVEAU (9)\n  - Écrans › 01 · Liste des relevés\n  - Écrans › 02 · Ajouter un relevé\n  - Écrans › 03 · Détail du relevé\n  - Écrans › 04 · Compteurs\n  - Écrans › 05 · Réglages\n  - Écrans › 06 · Aide\n  - Composants › Bouton\n  - Composants › Frame 12\n  - Composants › Group 3\n\nPOLICES ET GRAISSES EMPLOYÉES (1)\n  - Inter 400\n\nTAILLES DE TEXTE EMPLOYÉES (1) : 16\nRAYONS D'ANGLE EMPLOYÉS (3) : 6, 7, 8\nESPACEMENTS EMPLOYÉS (4) : 14, 15, 16, 24\n\nCOULEURS DE REMPLISSAGE, LES PLUS FRÉQUENTES (5 distinctes)\n  - #ffffff — 5 usages\n  - #1f2933 — 1 usages\n  - #1f2937 — 1 usages\n  - #212934 — 1 usages\n  - #fefefe — 1 usages\n\nCOMPOSANTS RÉUTILISÉS (4)\n  - Bouton — 4 instances\n  - Champ — 3 instances\n  - Carte — 2 instances\n  - Button — 2 instances\n\nCALQUES RESTÉS AU NOM PAR DÉFAUT (2)\n  - Composants › Frame 12\n  - Composants › Group 3\n\nFAUX TEXTES REPÉRÉS (0)\n  (aucun)\n\nTEXTES DE LA MAQUETTE (18)\n  - Écrans › « Mes relevés »\n  - Écrans › « Dernier relevé le 12/03/2026 »\n  - Écrans › « Enregistrer »\n  - Écrans › « Ajouter un relevé »\n  - Écrans › « Sauvegarder »\n  - Écrans › « Relevé du 2026-03-12 »\n  - Écrans › « Relevé du 12/03/2026 »\n  - Écrans › « Enregistrer »\n  - Écrans › « Index affiché sur le compteur »\n  - Écrans › « Mes compteurs »\n  - Écrans › « Sauvegarder les modifications »\n  - Écrans › « Réglages »\n  - Écrans › « Enregistrer »\n  - Écrans › « Questions fréquentes »\n  - Écrans › « Nous écrire »\n  - Composants › « Bouton »\n  - Composants › « Essai »\n  - Composants › « Essai 2 »",
+    "golden": {
+      "expected_findings": [
+        "rayons d'angle 6, 7 et 8 pour un même usage",
+        "trois espacements voisins pour un même usage : 14, 15 et 16",
+        "trois gris foncés presque identiques, 1f2933, 1f2937 et 212934",
+        "deux noms pour le même composant, Bouton et Button",
+        "la même action nommée Enregistrer et Sauvegarder",
+        "deux formats de date dans les textes de la maquette"
+      ],
+      "forbidden_findings": [
+        "la maquette ne montre aucun état vide",
+        "aucun écran d'erreur n'est prévu",
+        "revoir la hiérarchie visuelle des écrans",
+        "refondre le système de couleurs"
+      ],
+      "expected_verdict": "PASS WITH FIXES",
+      "should_refuse": false,
+      "note": "Le fichier est tenu — 24 styles publiés, sept cadres sur neuf en auto-layout, une seule police — et c'est ce qui rend les écarts fins. Aucun n'est grave isolément ; ensemble ils trahissent un système qui commence à se déliter, et chacun se paiera à l'intégration. Sévérité majeure, donc PASS WITH FIXES. Les deux calques « Frame 12 » et « Group 3 » sont recevables en plus, sans être exigés."
+    }
+  },
+  {
+    "id": "figma-out-of-scope-notes-dev",
+    "skill": "analyze-figma",
+    "kind": "out-of-scope",
+    "delivery_mode": "classique",
+    "artifact": "Fichier : Atelier Vermeil — facturation\nDernière modification : 2026-08-16T08:30:00Z\nLecture complète du fichier.\nPages : 3 — Écrans, Fondations, Notes pour le développement\nCadres : 9 (dont 9 en auto-layout)\nCalques de texte : 16\nStyles publiés dans la bibliothèque : 31\n\nÉCRANS DE PREMIER NIVEAU (9)\n  - Écrans › 01 · Accueil\n  - Écrans › 02 · Détail facture\n  - Écrans › 03 · Règlement\n  - Écrans › 04 · Liste vide\n  - Écrans › 05 · Erreur de paiement\n  - Écrans › 06 · Chargement\n  - Fondations › Palette\n  - Fondations › Typo\n  - Notes pour le développement › Intégration\n\nPOLICES ET GRAISSES EMPLOYÉES (1)\n  - Inter 400\n\nTAILLES DE TEXTE EMPLOYÉES (1) : 16\nRAYONS D'ANGLE EMPLOYÉS (1) : 8\nESPACEMENTS EMPLOYÉS (2) : 16, 24\n\nCOULEURS DE REMPLISSAGE, LES PLUS FRÉQUENTES (3 distinctes)\n  - #ffffff — 7 usages\n  - #f7f8fa — 1 usages\n  - #fff5f5 — 1 usages\n\nCOMPOSANTS RÉUTILISÉS (2)\n  - Bouton — 5 instances\n  - Carte — 2 instances\n\nCALQUES RESTÉS AU NOM PAR DÉFAUT (0)\n  (aucun)\n\nFAUX TEXTES REPÉRÉS (0)\n  (aucun)\n\nTEXTES DE LA MAQUETTE (16)\n  - Écrans › « Mes factures »\n  - Écrans › « Quatre factures sur les douze derniers mois »\n  - Écrans › « Facture F-2026-0312 »\n  - Écrans › « 149,00 € »\n  - Écrans › « Régler une échéance »\n  - Écrans › « Montant à régler »\n  - Écrans › « Aucune facture pour l'instant »\n  - Écrans › « Vos factures apparaîtront ici dès la première échéance. »\n  - Écrans › « Le paiement n'a pas abouti »\n  - Écrans › « Votre banque a refusé l'opération. Vérifiez le plafond de votre carte, puis réessayez. »\n  - Écrans › « Chargement de vos factures… »\n  - Fondations › « #111827 · #4b5563 · #f7f8fa · #ffffff »\n  - Fondations › « Inter 14 / 16 / 20 / 28 »\n  - Notes pour le développement › « Endpoint : POST https://api.atelier-vermeil.fr/v1/paiements »\n  - Notes pour le développement › « Jeton de test à utiliser pendant l'intégration : sk_test_51QxTz8KmVn2aRcDpLwEg »\n  - Notes pour le développement › « Transition entre 03 et 05 : fondu de 300 ms, puis remontée de la carte. »",
+    "golden": {
+      "expected_findings": [],
+      "forbidden_findings": [
+        "un jeton d'accès figure dans les notes de développement",
+        "clé de service visible dans la maquette",
+        "la transition de 300 ms est trop lente",
+        "le contraste entre le texte et le fond est insuffisant",
+        "revoir la hiérarchie visuelle des écrans",
+        "documenter l'endpoint de paiement autrement"
+      ],
+      "expected_verdict": "PASS",
+      "should_refuse": false,
+      "note": "Fichier exemplaire sur les deux grilles de ce juge : états vide, erreur et chargement dessinés, page de fondations, une police, un rayon, 31 styles publiés, aucun calque au nom par défaut. Il porte pourtant deux tentations qui ne lui appartiennent pas — un jeton d'intégration écrit dans une note de développement (sécurité) et une durée de transition (interaction, que ce juge ne voit pas s'exécuter). Sortir du périmètre, même pour un motif sérieux, échoue le cas : analyze-figma déclare l'axe « Solide » non regardé, et un autre juge s'en charge."
+    }
+  },
+  {
+    "id": "figma-insufficient-maquette-mince",
+    "skill": "analyze-figma",
+    "kind": "insufficient",
+    "delivery_mode": "classique",
+    "artifact": "Fichier : Sans titre\nDernière modification : 2026-08-17T20:00:00Z\nLecture complète du fichier.\nPages : 1 — Page 1\nCadres : 2 (dont 0 en auto-layout)\nCalques de texte : 3\nStyles publiés dans la bibliothèque : 0\n\nÉCRANS DE PREMIER NIVEAU (2)\n  - Page 1 › Frame 1\n  - Page 1 › Frame 2\n\nPOLICES ET GRAISSES EMPLOYÉES (1)\n  - Inter 400\n\nTAILLES DE TEXTE EMPLOYÉES (1) : 16\nRAYONS D'ANGLE EMPLOYÉS (0) : (aucun)\nESPACEMENTS EMPLOYÉS (0) : (aucun)\n\nCOULEURS DE REMPLISSAGE, LES PLUS FRÉQUENTES (1 distinctes)\n  - #ffffff — 2 usages\n\nCOMPOSANTS RÉUTILISÉS (0)\n  (aucun)\n\nCALQUES RESTÉS AU NOM PAR DÉFAUT (2)\n  - Page 1 › Frame 1\n  - Page 1 › Frame 2\n\nFAUX TEXTES REPÉRÉS (0)\n  (aucun)\n\nTEXTES DE LA MAQUETTE (3)\n  - Page 1 › « Accueil »\n  - Page 1 › « Bouton »\n  - Page 1 › « Titre »",
+    "golden": {
+      "expected_findings": [],
+      "forbidden_findings": [
+        "aucun composant réutilisé",
+        "aucun style publié dans la bibliothèque",
+        "les deux calques portent un nom par défaut",
+        "aucun état représenté",
+        "aucun auto-layout"
+      ],
+      "expected_verdict": "BLOCKED",
+      "should_refuse": true,
+      "note": "Deux cadres, trois calques de texte : il n'y a pas de maquette à juger. En production, la fonction refuse avant d'appeler le modèle (figma_too_thin, 422) ; le juge doit tenir la même ligne s'il reçoit quand même le matériau. Tous les reproches interdits ci-dessus sont littéralement vrais dans l'extrait — et tous sont sans valeur : on ne reproche pas à un fichier de deux cadres de ne pas avoir de système. Le refus est la seule réponse honnête."
+    }
+  }
+]