À qui s’adresse ce document

À l’artisan de la donnée qui accompagne un entrepreneur, ou à l’entrepreneur lui-même s’il a les compétences. Il décrit comment lancer l’atelier d’agents IA — pour produire, à partir d’un énoncé d’activité, le manuel d’activité et l’œuvre logicielle qui en est la version active.

Ce document est volontairement daté et concret : il nomme des outils, des commandes, une structure de dossier. Il vit dans le dépôt et se révise avec lui. La doctrine, elle, est au manuel Données techniques, chapitre 12.

0. La règle d’arbitrage des sources (pour l’agent)

Avant toute génération, l’agent tient le corpus comme sa juridiction, selon cinq règles de préséance. Un. Pour le fond — ce qui est vrai de la donnée —, la trilogie fait foi ; en cas de tension apparente, le tome prime sur tout volume de continuité et sur la synthèse. Deux. Pour la réalisation — comment faire —, les volumes de continuité font foi (Données techniques, le SGQA) ; leur version la plus récente arbitre. Trois. La synthèse résume et ne remplace pas : elle ne peut être citée contre un tome. Quatre. Le lexique canonique tranche les définitions ; un terme absent du lexique est signalé comme hors-corpus, jamais improvisé. Cinq. Les exemples datés (chiffres, outils, secteurs) n’engagent rien : ils illustrent la forme, jamais le fond. Toute réponse de l’agent doit pouvoir désigner sa source et la règle qui la fait primer.

1. Prérequis

• L’atelier numérique (Données techniques, chapitre 10) : une machine capable de faire tourner un modèle d’IA local.
• Un agent de codage installé : Vibe Code (Vibe CLI) — accès supervisé au système de fichiers, au shell et à des outils ; lit, exécute, écrit du code.
• git installé, pour versionner l’œuvre (sauvegarde et mémoire de l’évolution).
• La base : le dépôt Artisanat-de-la-donnee (URL à confirmer : https://github.com/Dawebxx/Artisanat-de-la-donnee), cloné ou téléchargé en zip et copié sur la machine locale.

2. La structure du dossier

Une fois la base récupérée, le dossier de travail se présente ainsi :

artisanat-de-la-donnee/
├── README.md
├── commencer.md                      ← ce document
├── corpus/                           ← la base de connaissance (le fond)
│   ├── tome_1_le_fleuve_et_le_canal.md
│   ├── tome_2_de_la_source_au_torrent.md
│   ├── tome_3_la_trace_ou_la_donnee.md
│   ├── artisan_de_la_donnee.md
│   ├── systeme_gestion_qualite_activite.md
│   ├── donnees_techniques.md
│   └── …  (l'ensemble des volumes)
├── atelier/
│   ├── plan-developpement-atelier-agents.md
│   ├── chartes-agents.md             ← les prompts des Agents IA
│   ├── secteurs/
│   │   └── secteur-bijouterie.md     ← documents secteur (amorce)
│   └── gabarits/                     ← gabarits d'artefacts vides
└── mon-activite/                     ← l'espace de travail de l'entrepreneur
    ├── enonce.md                     ← À REMPLIR
    ├── manuel/                       ← produit par la couche fond
    └── oeuvre/                       ← produite par la couche forme (PWA)

Le dossier corpus/ et le dossier atelier/ sont la base de connaissance et les consignes ; mon-activite/ est le seul dossier que l’on remplit et qui se remplit.

3. Ce que l’utilisateur fournit

L’utilisateur ne rédige pas de prompts : les prompts sont les chartes (atelier/chartes-agents.md). Il fournit seulement deux choses :

1. L’énoncé de son activité — dans mon-activite/enonce.md : ce qu’il fait, ce qu’il vend, à qui, avec quoi. En langage libre, sans souci de forme.
2. Le choix d’un secteur — un document de atelier/secteurs/ qui amorce la réflexion (par exemple secteur-bijouterie.md). Il donne l’axe ; l’énoncé donne la réalité singulière.

Tout le reste — la cartographie, le manuel, l’architecture, le code — est produit par les Agents IA.

4. Lancer l’atelier, agent par agent

Ouvrir Vibe Code à la racine du dossier, et lui donner corpus/ et atelier/ comme base de connaissance. On déroule ensuite le parcours d’équipement (Données techniques, chapitre 11) dans l’ordre. Pour chaque agent, la consigne est la même : « Tiens le rôle défini par sa charte ; lis l’artefact d’entrée ; produis l’artefact de sortie. »

Le Gardien du corpus relit chaque artefact avant de passer au suivant (vocabulaire, invariants, garde-fou de la facturation). L’Orchestrateur — ici, c’est vous — tient l’ordre et déclenche les jalons.

5. Valider à chaque jalon

C’est là que se joue la validation réelle, à la mise en pratique. Avant de passer d’un agent au suivant, le référent (l’artisan ou l’entrepreneur) lit l’artefact produit et le confronte à la réalité de l’activité. Sous Vibe Code, rien n’est écrit sans supervision : on relit, on corrige, on relance l’agent au besoin. Le geste tient : livrer une œuvre dont le client peut reprendre la main.

6. Récupérer et installer

À la fin du parcours :

• mon-activite/manuel/ contient le manuel d’activité (le fond, durable).
• mon-activite/oeuvre/ contient l’œuvre : un cœur natif, local-first, installable en PWA sur le poste et le smartphone de l’entrepreneur.

On initialise un dépôt git sur mon-activite/ : sauvegarde et mémoire de l’évolution. On installe la PWA. L’activité tourne.

7. Faire évoluer

Le logiciel n’est pas figé. Pour un ajustement ou une fonctionnalité nouvelle, on relance le seul agent concerné avec l’artefact à corriger, on valide, on versionne. C’est le cycle du parcours : imprégnation → ajustement → expansion.

Trois scripts à la racine du dépôt outillent ce cycle, tous branchés sur le même port de génération (lib-agent.sh, qui dispatche vers Vibe Code ou Claude Code) :

• init.sh — le parcours complet : de l’énoncé au manuel, puis à l’œuvre, jusqu’à la première livraison.
• evolve.sh — une évolution (design, fonctionnalité, correctif) : sur branche beta, validée à la porte de tests, basculée en prod et livrée en version.
• debug.sh — corriger un défaut sur la branche courante, sans branche beta ni release. Il sert le cas que les tests du cœur ne voient pas : un câblage d’interface (un formulaire qui ne déclenche rien). Son agent de débogage reproduit le défaut et inspecte adaptateurs/interface/app.js (écouteurs d’événements, sélecteurs) en plus du cœur ; il ne conclut pas « tout est vert » sur la seule foi des tests. Aucune version n’est livrée ; une trace dans progress.md n’est écrite que si on la demande.

À la porte de tests commune à ces scripts, lorsque node --test échoue, trois issues : d laisse l’agent corriger et reboucle ; c poursuit le parcours quand on a corrigé soi-même (« corrigé manuellement ») ; n arrête.

En cas de besoin d’aide

L’entrepreneur peut conduire seul ce parcours s’il en a les compétences, se faire accompagner par l’artisan de la donnée, ou lui en déléguer l’ensemble. L’artisan sait gérer les Agents IA : c’est son métier — celui que le corpus appelle à créer.