Compétence d'analyse de données
Analyse de données structurée natif IA : un workflow 0+9 universel + des packs de domaine enfichables. Ce fichier est le point d'entrée (détection de domaine + règles clés + pointeurs) ; les détails sont chargés à la demande depuis references/ et le pack de domaine sélectionné. Cette compétence reste agnostique en termes de domaine – toute connaissance spécifique à un domaine se trouve dans domains/<nom>/, aucun nom de domaine spécifique n'apparaît dans ce fichier.
Comment ça fonctionne — workflow 0+9
La détection de domaine de l'étape 0 se trouve dans ce fichier ; les procédures des étapes 1 à 9, ce qui est chargé à chaque étape, et ce qui est produit, sont entièrement décrits dans references/9-step-framework.md (contenant la table de chargement par étape unique et faisant autorité). Au début de toute analyse, chargez d'abord ce fichier.
| Étape | Description succincte |
|---|---|
| 0 Détection de domaine | Lire le résolveur → acheminer vers le pack de domaine (ou générique) |
| 1 Profilage | L'agent rédige le profilage : colonne → rôle de champ, détermination de période/snapshot, calcul des écarts de données |
| 2 Analyse des signaux | Rédiger l'analyse des signaux (anomalies / variations significatives / écarts des indices par rapport à la référence) |
| 3 Clarification | Ne demander que si des ambiguïtés ou des limites de données bloquent la demande (présenter alors les écarts à l'utilisateur) |
| 4 Cadrage | Utiliser framework.md du domaine pour construire un arbre de décision MECE |
| 5 Hypothèses | Hypothèses réfutables, rattachées à un levier du domaine |
| 6 Vérification | Écrire et exécuter la vérification en pandas → verdicts.json |
| 7 Décomposition | Écrire et exécuter la décomposition → drivers.json |
| 8 Synthèse | Sortie en pyramide + extension des insights du domaine ; par défaut, deux livrables parallèles : insight_deck.html (deck HTML) + insight_report.md (miroir 1:1), soumis au deck_audit, la troisième porte (les analyses rapides/suivi peuvent être exemptées du deck) |
| 9 Suivi | Répondre aux questions suivantes en étendant l'arbre de décision |
Entièrement basé sur des instructions, sans scripts préétablis : les codes des étapes 1/2/6/7 sont écrits et exécutés dynamiquement par l'agent – mais avant d'écrire, l'agent lit les données réelles + les
data-spec/glossary/computation-referencedu domaine sélectionné pour comprendre les champs et les périodes de ces données, puis génère le code selon les instructions. Les noms de champs ou les termes de période ne sont pas présumés (LY/TY/MAT n'est pas universel). Le mappage des rôles de champs est une décision sémantique de l'IA (liredata-spec §1.0).
Étape 0 — Détection de domaine (décision d'entrée)
- Lire
references/resolver.md(mécanisme de score agnostique) et énumérer tous lesdomains/<slug>/triggers.md(blocs de déclenchement propres à chaque domaine). - Noter chaque domaine en fonction du « vocabulaire utilisateur / colonnes de données (après l'étape 1) / fichier d'indication du projet
./.data-analysis-domain». - Acheminement : ≥2 signaux pointant vers le même domaine → routage silencieux ; ambiguïté → laisser l'utilisateur choisir selon
clarification-protocol.md; aucune correspondance → mode générique et en informer. - Lire le
domains/<slug>/README.mdcorrespondant ; les autres emplacements sont chargés à l'étape correspondante selon la table de chargement 9 étapes. - Enregistrer
outputs/analysis_state.json::domain_selected; pour les tours suivants, réutiliser sans re-vérification.
Règles critiques (non négociables ; détails dans references/anti-hallucination.md)
- Le LLM ne calcule jamais de chiffres. Agrégations / parts / indices / décompositions → toujours écrire et exécuter du pandas par l'agent ; la sortie ne contient aucun nombre dérivé du LLM.
- Chaque chiffre doit faire référence à un
verdict_id, retraçable jusqu'àoutputs/verdicts.json. - D'abord détecter, puis clarifier. Avant d'avoir terminé les étapes 0 à 2, ne pas demander « que voulez-vous analyser ? » ; par défaut, l'analyse est lancée directement, ajustable après coup.
- Persistance de l'état. À chaque tour, lire avant et mettre à jour
outputs/analysis_state.jsonavant de répondre. - Couverture : aucun silence sur les nœuds feuilles. Chaque feuille réalisable en données dans l'arbre de décision (étape 4) doit être soit répondue, soit explicitement ignorée (avec raison) à l'étape 6 ; « pas assez de temps » n'est pas une raison valable. Le critique de l'étape 8 vérifie la couverture. Détails dans
references/9-step-framework.mdÉtape 6 porte de couverture. - Livraison par défaut = deck + rapport, pas une conversation en ligne. Toute demande d'analyse de données structurée exécute par défaut le workflow 0+9 complet et produit à l'étape 8
outputs/insight_deck.html+outputs/insight_report.md(écrits sur disque, soumis audeck_audit) – c'est le livrable par défaut, pas une « option bonus ». Afficher quelques tableaux / extraits de texte dans la conversation ≠ analyse complète (cela signifie que l'étape 8 n'a pas été atteinte). Une question d'analyse ciblée/spécifique (par exemple, « regarder la distribution de X », « qui a gagné sur telle période ») n'est pas une « requête légère » – elle exécute également le processus complet et produit le deck. Seules deux exemptions : ① étape 9 suivi (questions de suivi sur une analyse déjà terminée) ; ② l'utilisateur demande explicitement une réponse rapide/courte/orale. En cas d'exemption, la réponse doit explicitement indiquer « ce tour suit le mode léger, sans production de deck ». Détails dansreferences/9-step-framework.mdÉtape 8 +references/insight-templates.md.
Packs de domaine
Un pack = un ensemble d'emplacements .md nommés de manière générique : triggers (bloc de déclenchement de l'étape 0 de détection de domaine) · glossary · data-spec · framework · computation-reference · insight-extensions · context-notes · clarification-extensions · business-rules.md.
Protocole des emplacements, qui les remplit, trois types de contenu, flux de maintenance → references/domain-pack-protocol.md (unique et faisant autorité). Générer/maintenir un pack → compétence domain-pack-builder.
Ajouter un nouveau domaine
Créer domains/<nouveau>/ et remplir tous les emplacements (y compris triggers.md avec le bloc de déclenchement). Cette compétence et les autres fichiers génériques ne sont pas modifiés – le mécanisme de résolveur énumère automatiquement les triggers.md du nouveau pack.
v0.9 (2026-06-09 symétrisation de la porte du deck) : Le deck HTML passe d'une « valeur par défaut enfouie dans le fichier d'emplacement de l'étape 8 » à une condition de sortie matérielle au niveau du framework – l'étape 8 unifie partout ses colonnes de production, ses sorties, son critique et sa condition de sortie pour indiquer « par défaut, deux livrables parallèles : insight_deck.html + insight_report.md (miroir 1:1), soumis au deck_audit.py, la troisième porte (au même niveau que data_integrity + coverage) » ; les requêtes rapides/étape 9 suivi peuvent être exemptées du deck mais doivent être explicitement mentionnées. Correctif pour un point de fuite observé en pratique : les questions ciblées ne produisaient qu'un rapport .md et considéraient l'étape 8 comme terminée, le deck était silencieusement absent (cause racine : les deux emplacements insight-templates.md+insight-extensions.md n'étaient pas chargés, d'où l'ajout dans la section Outputs d'un rappel « charger d'abord les deux emplacements »). Maintien de l'agnosticisme de la couche générique (deck/audit sont des concepts génériques ; la charte design, les mots interdits, les fichiers de taille, les logos sont tous lus depuis le domaine à l'exécution).
v0.8 (2026-05-30 durcissement de la robustesse) : Ajout de la porte de couverture (règle critique 5, les feuilles ne peuvent être silencieusement jetées) ; vérification de l'intégrité des données à l'étape 2 (sommes des parts / lignes d'agrégation intégrées) ; règle impérative de granularité de décomposition à l'étape 7 ; méthode pour apprivoiser les en-têtes multi-niveaux ; unification des sorties de scripts dans outputs/scripts/ + conventions de nommage + réutilisation de l'empreinte du schéma (ré-envoi de données de même schéma ne réécrit pas les loaders) ; étape 8 oblige à écrire insight_report.md sur disque. Nettoyage des traces résiduelles spécifiques à un domaine dans la couche générique (retour à l'agnosticisme). v0.7 : entièrement basé sur des instructions (suppression des scripts préétablis). v0.6 : normalisation du créateur de compétence.