@mostajs/kind-catalog 0.1.0

package/docs/DEVTEST-PLAN.kind-catalog.json

@@ -0,0 +1,412 @@
+{
+  "plan": "mostajs-devtest/1",
+  "project": {
+    "key": "kind-catalog",
+    "name": "@mostajs/kind-catalog"
+  },
+  "_comment": "CATALOGUE DE KINDS (0.1.0). Un catalogue n'a aucun comportement à l'exécution : ces essais ne prouvent pas qu'une fiche est JUSTE — cela se prouve en l'appliquant, dans le plan de l'application. Ils tiennent ce qui rendrait le catalogue NUISIBLE : une fiche sans critère de succès donne un cadre à des réponses qu'on ne peut pas juger, avec l'autorité d'une fiche ; une fiche sans erreur connue se reprend comme une expérience et n'est qu'un titre ; une projection invalide part chez qatrax.",
+  "specs": [
+    {
+      "ref": "SPEC-KC-01",
+      "title": "Une fiche inutilisable est refusée AU MONTAGE, en nommant tout ce qui manque",
+      "priority": "critical",
+      "status": "verified"
+    },
+    {
+      "ref": "SPEC-KC-03",
+      "title": "La projection produit un plan mostajs-devtest/1 que le parseur OFFICIEL accepte",
+      "priority": "critical",
+      "status": "verified"
+    },
+    {
+      "ref": "SPEC-KC-04",
+      "title": "Instancier EXIGE de nommer ce qui est affiné, et le trace",
+      "priority": "critical",
+      "status": "verified"
+    },
+    {
+      "ref": "SPEC-KC-05",
+      "title": "Le corpus est cohérent : références uniques, verdicts connus, domaines déclarés",
+      "priority": "critical",
+      "status": "verified"
+    },
+    {
+      "ref": "SPEC-KC-06",
+      "title": "Le module N'EXÉCUTE RIEN et NE STOCKE RIEN",
+      "priority": "critical",
+      "status": "verified"
+    },
+    {
+      "ref": "SPEC-KC-07",
+      "title": "Le corpus livré est valide, sourcé et lisible",
+      "priority": "critical",
+      "status": "verified"
+    }
+  ],
+  "realisations": [
+    {
+      "ref": "REL-KC-01",
+      "specRef": "SPEC-KC-01",
+      "kind": "feature",
+      "title": "Une fiche inutilisable est refusée AU MONTAGE, en nommant tout ce qui manque",
+      "artifact": "src/",
+      "progress": 100,
+      "status": "done"
+    },
+    {
+      "ref": "REL-KC-03",
+      "specRef": "SPEC-KC-03",
+      "kind": "feature",
+      "title": "La projection produit un plan mostajs-devtest/1 que le parseur OFFICIEL accepte",
+      "artifact": "src/",
+      "progress": 100,
+      "status": "done"
+    },
+    {
+      "ref": "REL-KC-04",
+      "specRef": "SPEC-KC-04",
+      "kind": "feature",
+      "title": "Instancier EXIGE de nommer ce qui est affiné, et le trace",
+      "artifact": "src/",
+      "progress": 100,
+      "status": "done"
+    },
+    {
+      "ref": "REL-KC-05",
+      "specRef": "SPEC-KC-05",
+      "kind": "feature",
+      "title": "Le corpus est cohérent : références uniques, verdicts connus, domaines déclarés",
+      "artifact": "src/",
+      "progress": 100,
+      "status": "done"
+    },
+    {
+      "ref": "REL-KC-06",
+      "specRef": "SPEC-KC-06",
+      "kind": "feature",
+      "title": "Le module N'EXÉCUTE RIEN et NE STOCKE RIEN",
+      "artifact": "src/",
+      "progress": 100,
+      "status": "done"
+    },
+    {
+      "ref": "REL-KC-07",
+      "specRef": "SPEC-KC-07",
+      "kind": "feature",
+      "title": "Le corpus livré est valide, sourcé et lisible",
+      "artifact": "src/",
+      "progress": 100,
+      "status": "done"
+    }
+  ],
+  "tests": [
+    {
+      "ref": "T-KC-1",
+      "specRef": "SPEC-KC-01",
+      "title": "T-KC-1 — une fiche sans `succes` est refusée",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-1",
+      "steps": [
+        {
+          "action": "définir sans critère de succès",
+          "expected": "refus nommant `succes` — sans critère écrit, tout résultat paraît bon, avec l'autorité d'une fiche"
+        }
+      ]
+    },
+    {
+      "ref": "T-KC-2",
+      "specRef": "SPEC-KC-01",
+      "title": "T-KC-2 — une fiche sans `erreurs` est refusée",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-2",
+      "steps": [
+        {
+          "action": "définir sans erreur connue",
+          "expected": "refus — une fiche qui n'apprend rien n'a pas de raison d'être reprise"
+        }
+      ]
+    },
+    {
+      "ref": "T-KC-3",
+      "specRef": "SPEC-KC-01",
+      "title": "T-KC-3 — le refus liste TOUT ce qui manque, d’un coup",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-3",
+      "steps": [
+        {
+          "action": "valider une fiche vide",
+          "expected": "tous les manques en un message — corriger un manque pour en découvrir un autre fait abandonner"
+        }
+      ]
+    },
+    {
+      "ref": "T-KC-4",
+      "specRef": "SPEC-KC-01",
+      "title": "T-KC-4 — une erreur sans `consequence` est refusée",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-4",
+      "steps": [
+        {
+          "action": "erreur réduite à un titre",
+          "expected": "refus nommant l'index et le champ"
+        }
+      ]
+    },
+    {
+      "ref": "T-KC-4b",
+      "specRef": "SPEC-KC-01",
+      "title": "T-KC-4b — le VERDICT ne se décerne pas : `eprouve` exige un fait",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-4b",
+      "steps": [
+        {
+          "action": "verdict éprouvé sur une simple référence",
+          "expected": "refus ; une origine `incident` ou `terrain` l'autorise, une fiche `propose` entre librement"
+        }
+      ]
+    },
+    {
+      "ref": "T-KC-5",
+      "specRef": "SPEC-KC-03",
+      "title": "T-KC-5 — la projection est acceptée par `parseDevtestPlan` de @mostajs/qa-engine",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-5",
+      "steps": [
+        {
+          "action": "projeter le corpus et le soumettre au parseur officiel",
+          "expected": "`ok: true` — le seul juge qui compte est celui de qatrax"
+        }
+      ]
+    },
+    {
+      "ref": "T-KC-6",
+      "specRef": "SPEC-KC-03",
+      "title": "T-KC-6 — chaque épreuve de la fiche devient un essai relié à son exigence",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-6",
+      "steps": [
+        {
+          "action": "projeter une fiche à deux épreuves",
+          "expected": "deux essais reliés, et l'exigence porte les erreurs connues avec leur conséquence"
+        }
+      ]
+    },
+    {
+      "ref": "T-KC-7",
+      "specRef": "SPEC-KC-03",
+      "title": "T-KC-7 — le préfixe d’application ISOLE les références",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-7",
+      "steps": [
+        {
+          "action": "projeter la même fiche pour deux applications",
+          "expected": "aucune collision — sinon leurs plans se marcheraient dessus dans le même qatrax"
+        }
+      ]
+    },
+    {
+      "ref": "T-KC-7b",
+      "specRef": "SPEC-KC-03",
+      "title": "T-KC-7b — une fiche seulement `propose` n’apparaît pas comme VÉRIFIÉE",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-7b",
+      "steps": [
+        {
+          "action": "projeter une fiche proposée",
+          "expected": "statut `draft` — sinon le suivi annonce une exigence tenue qui ne l'est pas"
+        }
+      ]
+    },
+    {
+      "ref": "T-KC-8",
+      "specRef": "SPEC-KC-04",
+      "title": "T-KC-8 — instancier SANS rien affiner est permis, et se voit",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-8",
+      "steps": [
+        {
+          "action": "instancier tel quel",
+          "expected": "aucun affinage, et la version de la fiche est portée"
+        }
+      ]
+    },
+    {
+      "ref": "T-KC-9",
+      "specRef": "SPEC-KC-04",
+      "title": "T-KC-9 — un affinage sans motif, ou hors des champs affinables, est REFUSÉ",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-9",
+      "steps": [
+        {
+          "action": "affiner sans motif, puis un champ non affinable",
+          "expected": "refus des deux — sinon « réutiliser » se dégrade en « recopier »"
+        }
+      ]
+    },
+    {
+      "ref": "T-KC-9b",
+      "specRef": "SPEC-KC-04",
+      "title": "T-KC-9b — un affinage qui CASSE la fiche est refusé",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-9b",
+      "steps": [
+        {
+          "action": "vider les erreurs par affinage",
+          "expected": "refus — on n'affine pas jusqu'à vider l'exigence"
+        }
+      ]
+    },
+    {
+      "ref": "T-KC-9c",
+      "specRef": "SPEC-KC-04",
+      "title": "T-KC-9c — l’index inverse dit QUI emploie une fiche, et ce que chacun a affiné",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-9c",
+      "steps": [
+        {
+          "action": "deux instances dont une affinée",
+          "expected": "les deux applications et l'affinage sont rendus"
+        }
+      ]
+    },
+    {
+      "ref": "T-KC-10",
+      "specRef": "SPEC-KC-05",
+      "title": "T-KC-10 — deux fiches ne peuvent pas partager une `ref`",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-10",
+      "steps": [
+        {
+          "action": "corpus avec doublon",
+          "expected": "reproche nommant la référence"
+        }
+      ]
+    },
+    {
+      "ref": "T-KC-11",
+      "specRef": "SPEC-KC-05",
+      "title": "T-KC-11 — un verdict inconnu est refusé ; `ecarte` exige son MOTIF et RESTE au catalogue",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-11",
+      "steps": [
+        {
+          "action": "verdict fantaisiste, puis écarté sans motif, puis avec",
+          "expected": "refus, refus, puis conservation — une fiche écartée qui disparaît sera réinventée"
+        }
+      ]
+    },
+    {
+      "ref": "T-KC-11b",
+      "specRef": "SPEC-KC-05",
+      "title": "T-KC-11b — un domaine non déclaré est refusé",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-11b",
+      "steps": [
+        {
+          "action": "domaine hors liste",
+          "expected": "refus — un domaine non déclaré échappe à la revue et fragmente le corpus en synonymes"
+        }
+      ]
+    },
+    {
+      "ref": "T-KC-12",
+      "specRef": "SPEC-KC-06",
+      "title": "T-KC-12 — le module n’écrit RIEN et n’appelle AUCUN solveur",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-12",
+      "steps": [
+        {
+          "action": "exercer toute la surface avec un dépôt piégé, puis relire les sources",
+          "expected": "aucune touche, aucune I/O hors du chargement du corpus"
+        }
+      ]
+    },
+    {
+      "ref": "T-CORP-1",
+      "specRef": "SPEC-KC-07",
+      "title": "T-CORP-1 — chaque fiche du corpus passe la validation",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-CORP-1",
+      "steps": [
+        {
+          "action": "auditer le corpus",
+          "expected": "aucun reproche"
+        }
+      ]
+    },
+    {
+      "ref": "T-CORP-2",
+      "specRef": "SPEC-KC-07",
+      "title": "T-CORP-2 — toute fiche ÉPROUVÉE porte un fait, pas une idée",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-CORP-2",
+      "steps": [
+        {
+          "action": "relire les origines des fiches éprouvées",
+          "expected": "au moins un `incident` ou `terrain` — ATT&CK ne consigne que l'observé"
+        }
+      ]
+    },
+    {
+      "ref": "T-CORP-3",
+      "specRef": "SPEC-KC-07",
+      "title": "T-CORP-3 — le corpus entier se projette en un plan valide",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-CORP-3",
+      "steps": [
+        {
+          "action": "projeter tout le corpus",
+          "expected": "plan accepté par le parseur officiel"
+        }
+      ]
+    },
+    {
+      "ref": "T-CORP-4",
+      "specRef": "SPEC-KC-07",
+      "title": "T-CORP-4 — le corpus couvre les domaines annoncés, et son état est LISIBLE",
+      "type": "automated",
+      "priority": "critical",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-CORP-4",
+      "steps": [
+        {
+          "action": "statistiques du corpus",
+          "expected": "chaque domaine annoncé est peuplé ; le taux éprouvé est rendu, ni 0 ni 100 %"
+        }
+      ]
+    },
+    {
+      "ref": "T-CORP-5",
+      "specRef": "SPEC-KC-07",
+      "type": "automated",
+      "priority": "critical",
+      "title": "T-CORP-5 — une fiche rencontrée dans PLUSIEURS projets porte plusieurs origines",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-CORP-5",
+      "steps": [
+        {
+          "action": "relire les origines de KIND-PERIMETRE-01",
+          "expected": "au moins trois incidents, issus de projets DISTINCTS — une exigence rencontrée dans trois projets indépendants n'est plus une opinion d'auteur, c'est un fait du métier"
+        }
+      ]
+    }
+  ]
+}

package/docs/ETUDE-ETAT-ART-KIND-CATALOG-02092026.md

@@ -0,0 +1,207 @@
+# État de l'art — catalogues d'exigences réutilisables
+
+**Livrable #1** (DEVRULES §9) · **Auteur** : Dr Hamid MADANI <drmdh@msn.com> · **Date** : 2026-09-02
+**Sujet** : `@mostajs/kind-catalog`
+
+> ⚠️ **Sources à vérifier avant publication.** Cette étude est écrite hors ligne : les références
+> sont données par titre, auteur et année, sans URL ni numéro de page. Le livrable #9 (publication)
+> exige leur vérification. Aucune n'est citée pour un chiffre précis.
+
+---
+
+## 1 · Vertical — par système : comment le monde catalogue une exigence
+
+### 1.1 · Les patrons d'exigences
+
+**Stephen Withall, *Software Requirement Patterns*** (Microsoft Press, 2007) est l'ancêtre direct
+de ce que nous construisons : un **catalogue de patrons d'exigence** réutilisables, chacun avec un
+gabarit, des exemples, et des « considérations » — c'est-à-dire les pièges. Le livre organise ses
+patrons par domaine (données, performances, accès…).
+
+**Ce qu'il apporte** : la preuve qu'une exigence se catalogue et se réemploie.
+**Ce qui lui manque pour nous** : le catalogue est un **livre** — il ne se projette dans aucun
+outil, ne s'instancie pas, et rien ne trace qui l'a repris.
+
+### 1.2 · La syntaxe contrainte — EARS
+
+**EARS** (*Easy Approach to Requirements Syntax*, Mavin et al., Rolls-Royce, 2009) impose cinq
+formes de phrase (ubiquitaire, événementielle, d'état, optionnelle, indésirable). Adopté largement
+en aéronautique et automobile.
+
+**Ce qu'il apporte** : une exigence ambiguë est un défaut, et la forme réduit l'ambiguïté.
+**Ce qui lui manque** : EARS contraint l'**énoncé** et rien d'autre — ni épreuve, ni mode de
+défaillance, ni réemploi.
+
+### 1.3 · Les normes de spécification
+
+**ISO/IEC/IEEE 29148** (ingénierie des exigences) fixe le contenu d'une spécification et les
+attributs d'une exigence (identifiant, priorité, vérifiabilité, traçabilité).
+**ISO/IEC/IEEE 29119** fait de même pour la documentation de test.
+
+**Ce qu'elles apportent** : l'attribut **vérifiabilité** — une exigence non vérifiable n'en est pas
+une. C'est exactement notre champ `test`.
+**Ce qui leur manque** : elles normalisent la **forme d'un document**, pas un **corpus partagé**.
+
+### 1.4 · Les catalogues d'erreurs connues — le modèle le plus proche
+
+| catalogue | ce qu'il range | ce qu'il prouve |
+|---|---|---|
+| **CWE** (MITRE) | des **faiblesses** logicielles, chacune avec conséquence et détection | un catalogue de façons de se tromper est réutilisable **mondialement** |
+| **CAPEC** (MITRE) | des schémas d'attaque | la même chose, côté attaquant |
+| **ATT&CK** (MITRE) | tactiques et techniques observées | un catalogue **vit** s'il est nourri par des faits, pas par des suppositions |
+| **OWASP Top 10** | les dix risques les plus répandus | un catalogue **court** est plus lu qu'un catalogue exhaustif |
+
+**C'est le modèle du champ `erreurs`** — et il enseigne trois choses : chaque entrée porte sa
+**conséquence** (pas seulement son nom), le catalogue est **nourri par des incidents réels**, et
+la brièveté fait la lecture.
+
+### 1.5 · Les décisions d'architecture — ADR
+
+**Michael Nygard, *Documenting Architecture Decisions*** (2011) : un fichier court par décision —
+contexte, décision, conséquences — **versionné avec le code**.
+
+**Ce qu'il apporte** : la démonstration que le bon support d'un document qui se **relit** est un
+**fichier versionné**, pas une base de données. C'est l'argument central de notre §3 (stockage).
+
+### 1.6 · Les catalogues de problèmes de recherche opérationnelle
+
+**OR-Library** (Beasley), **MIPLIB**, **DIMACS**, **TSPLIB** : des jeux d'épreuve catalogués
+auxquels tout nouveau solveur se confronte.
+
+**Ce qu'ils apportent** : un catalogue **d'épreuves** est ce qui rend deux implémentations
+comparables. Sans lui, chaque équipe déclare que son solveur est bon sur ses propres données.
+
+---
+
+## 2 · Horizontal — par usage : la même logique dans d'autres métiers
+
+| métier | l'objet catalogué | l'enseignement pour nous |
+|---|---|---|
+| **Sécurité applicative** | CWE, OWASP | les erreurs se cataloguent, avec leur conséquence |
+| **Aéronautique** (ARP4761) | modes de défaillance | on **part** d'une liste connue, on ne la réinvente pas |
+| **Médical** (ISO 14971) | risques et mesures de maîtrise | la maîtrise est tracée jusqu'à l'épreuve |
+| **Agronomie** | itinéraires techniques par culture et par terroir | **réutiliser ou affiner** : la fiche nationale est adaptée localement, et l'écart est ce qui fait progresser la fiche |
+| **Électronique** | *design rules* et *application notes* du fondeur | des contraintes réutilisables, avec leurs pièges, **par technologie** |
+| **BTP** | DTU, CCTG/CCTP, Eurocodes | une clause type que chaque marché reprend et **amende par dérogation écrite** |
+| **Alimentaire** | **HACCP** : dangers, points critiques, limites, surveillance, actions correctives | le catalogue de dangers **le plus proche de notre champ `erreurs`** — chaque danger porte sa conséquence et sa mesure |
+| **Élevage** | plans de rationnement, protocoles de prophylaxie, schémas d'allotement | des fiches nationales **adaptées au troupeau**, avec l'écart relevé — comme l'itinéraire agronomique |
+| **Apiculture** | guides de bonnes pratiques, calendriers de miellées par région | le catalogue y est **le savoir de l'ancien** : quelques observations par an, transmises comme règles — c'est le cas où le catalogue vaut PLUS que la donnée |
+| **IA / apprentissage** | Case-Based Reasoning (Aamodt & Plaza, 1994) | la mémoire par cas : retrouver, réutiliser, **réviser**, retenir — le cycle **exactement** demandé |
+| **Sélection d'algorithme** | Rice (1976), portfolios type SATzilla | choisir le moteur d'après la **signature** du problème, pas d'après l'habitude |
+
+---
+
+## 3 · Ce qui n'existe nulle part
+
+Chacun de ces corpus catalogue **une seule** des faces :
+
+- Withall catalogue l'**exigence**, sans son épreuve ni ses erreurs ;
+- CWE catalogue les **erreurs**, sans l'exigence qui les rendrait inutiles ;
+- OR-Library catalogue les **épreuves**, sans le métier qui les motive ;
+- ADR catalogue les **décisions**, sans réemploi entre projets ;
+- CBR catalogue les **cas résolus**, sans dire si la question méritait d'être posée.
+
+**Aucun ne porte les cinq ensemble, et aucun ne se projette dans l'outil de suivi du projet.**
+
+C'est l'écart que `kind-catalog` occupe : une fiche qui tient l'**énoncé**, ses **besoins**, son
+**épreuve**, ses **critères de succès** et ses **erreurs connues**, et qui se **projette** en
+`mostajs-devtest/1` pour que qatrax la lise sans rien apprendre de nouveau.
+
+---
+
+## 3.bis · COMMENT ILS S'Y PRENNENT, concrètement
+
+L'important n'est pas qui catalogue, mais **par quel mécanisme** — c'est là que se prennent les
+décisions que nous devons prendre aussi.
+
+### a) La forme de l'entrée : un GABARIT À TROUS, jamais du texte libre
+
+| corpus | les cases de l'entrée |
+|---|---|
+| **CWE** | identifiant · description · **conséquences** · exemples de code · détection · mitigations · relations (parent/enfant) |
+| **Withall** | identifiant · description · **considérations** (les pièges) · gabarit d'énoncé · exemples · exigences liées |
+| **ADR** | contexte · décision · statut · **conséquences** |
+| **Model cards** | usage prévu · **usages hors périmètre** · métriques · **limites** |
+
+| **HACCP** (alimentaire) | danger · **gravité et probabilité** · point critique · **limite critique** · surveillance · **action corrective** · vérification |
+
+**Le point commun** : toutes réservent une case aux **conséquences** ou aux **limites**. Aucune ne
+se contente de décrire ce qui marche. HACCP va plus loin encore — il exige, pour chaque danger,
+**ce qu'on fait quand la limite est franchie** : c'est un catalogue d'erreurs **actionnable**. C'est ce qui justifie que `erreurs` soit **exigé** chez nous,
+et que chaque erreur porte sa conséquence.
+
+### b) L'identité : un identifiant STABLE et opaque, jamais un titre
+
+`CWE-79`, `T1059` (ATT&CK), `A01:2021` (OWASP). Le titre change, l'identifiant non — c'est ce qui
+permet à mille projets de citer la même chose pendant dix ans. D'où notre `ref: 'KIND-…'`, stable
+et distincte de l'énoncé.
+
+### c) Les relations : un GRAPHE, pas une liste plate
+
+CWE relie ses entrées (`ChildOf`, `CanPrecede`) ; ATT&CK relie techniques et sous-techniques ;
+Withall relie ses patrons. **Ce que cela évite** : la duplication. Une entrée trop proche d'une
+autre devient un enfant, au lieu d'un doublon qui divergera.
+
+> Nous ne le faisons **pas en 0.1.0** — un graphe sur cinq fiches est une complication sans
+> bénéfice. Le champ `origine` en tient lieu, et la question se rouvre au-delà de quinze fiches.
+
+### d) L'alimentation : par INCIDENTS, jamais par idées
+
+ATT&CK ne consigne que des techniques **observées** ; CWE naît de vulnérabilités **réelles** ;
+OR-Library de problèmes **posés**. Un catalogue nourri d'idées grossit vite et ne sert jamais.
+
+**C'est la règle la plus importante que nous reprenons** : les cinq fiches de la 0.1.0 sont toutes
+tirées d'un défaut **trouvé en recette**, avec la date et le fichier.
+
+### e) La brièveté : le corpus court est lu, l'exhaustif est consulté par personne
+
+CWE compte plus de mille entrées — et ce que les équipes lisent, c'est **l'OWASP Top 10**. Les
+grands catalogues finissent par produire des **vues courtes** (Top 10, Top 25) parce que
+l'exhaustivité tue la lecture.
+
+### f) La projection dans l'outillage : le catalogue n'est utile que branché
+
+C'est là que la plupart s'arrêtent — et c'est notre écart. CWE est branché aux scanners ; Withall
+ne l'est à rien, et c'est pourquoi son catalogue est resté un livre. **Une fiche qui ne descend pas
+dans le plan de test du projet ne sera pas appliquée**, quelle que soit sa qualité.
+
+### g) Le réemploi : instancier avec ÉCART TRACÉ
+
+- **Agronomie** : l'itinéraire technique national est **adapté** au terroir, et l'écart est relevé
+  — c'est l'écart qui fait progresser la fiche l'année suivante.
+- **Bâtiment** : le DTU est repris par le marché, qui **amende** par clause dérogatoire — la
+  dérogation est écrite, jamais implicite.
+- **CBR** (Aamodt & Plaza) : retrouver → réutiliser → **réviser** → retenir. La révision est une
+  **étape du cycle**, pas un accident.
+
+**Les trois disent la même chose** : ce qui fait vivre un catalogue, ce n'est pas la réutilisation
+à l'identique — c'est **l'écart tracé**. D'où `instantiate(…, { affine })` et `diffInstance()`.
+
+---
+
+## 4 · Veille — ce qui bouge
+
+- Les **agents de codage** popularisent les *skills* et les *rules files* : des fiches de consigne
+  réutilisables, versionnées, chargées à la demande. C'est la même intuition que celle formulée
+  le 02/09/2026 — *« à l'image des skills déjà implémentés »* — et l'écosystème en porte déjà une
+  implémentation, `@mostajs/skill-library`.
+- Les **cartes de modèle** (*model cards*) et **fiches de données** (*datasheets for datasets*)
+  imposent depuis 2018-2019 de documenter usage prévu, limites et modes de défaillance. La forme
+  demandée pour un `kind` en est proche parente.
+
+## 5 · Conclusion — ce que nous reprenons, ce que nous refusons
+
+| nous reprenons | de qui | pourquoi |
+|---|---|---|
+| le **patron** d'exigence réutilisable | Withall | c'est la brique |
+| la **conséquence** attachée à chaque erreur | CWE/OWASP | un avertissement sans conséquence ne se retient pas |
+| la **vérifiabilité** obligatoire | ISO 29148 | une exigence sans épreuve n'en est pas une |
+| le **fichier versionné** comme support | ADR | un document qui se relit ne va pas en base |
+| le cycle **réutiliser / réviser** | CBR | c'est le geste demandé |
+
+| nous refusons | pourquoi |
+|---|---|
+| une **syntaxe contrainte** à la EARS | elle contraindrait l'énoncé sans rien apporter à l'épreuve ni aux erreurs — et elle rebuterait l'écriture, donc le catalogue resterait vide |
+| un **format propre** au catalogue | qatrax devrait l'apprendre ; le jour où les deux divergent, le catalogue aurait raison contre les faits |
+| une **base de données** pour les fiches | elles se relisent et se discutent : leur historique est celui d'un fichier |
+| un catalogue **exhaustif** d'emblée | OWASP l'enseigne : un catalogue court est lu, un catalogue exhaustif est consulté par personne |