1Pourquoi une injection complète du Kit ?
Ce guide est pour vous, pas pour l'IA. Il décrit comment lancer un nouveau projet à partir du Kit.
Avant d'entrer dans la procédure, un point important: le Kit est un système cohérent. Ses fichiers ne sont pas des briques indépendantes que l'on peut choisir une par une — ils dépendent les uns des autres. Chaque feuille de style a un document de référence associé qui décrit son mode d'emploi. Le Registry déclare les versions actives. Le prompt technique et la structure commune définissent le contrat normatif qu'appliquent tous vos fichiers projet.
Injecter le Kit partiellement — en oubliant une Reference, en remplaçant une feuille de style sans sa déclaration au Registry, en laissant un ancien prompt en place — produit des incohérences silencieuses qui ne se manifestent qu'au moment de générer un document. Le symptôme est alors un rendu cassé, ou pire, un contenu perdu.
Règle simple: le Kit s’obtient en un seul geste, sous forme d’archive. L’IA la récupère à l’adresse déclarée au Registry; si elle ne peut pas l’atteindre, déposez le ZIP dans le fil de travail. Pas de sélection à la carte, pas de fichiers repris un à un.
2Les informations à préparer
Avant d'ouvrir une session, préparer les informations suivantes.
| Information | Exemple | Remarque |
|---|---|---|
| Un préfixe court | Arrosage | Un mot, sans caractères spéciaux. Ce préfixe apparaîtra dans tous les noms de fichiers. |
| Le nom complet du projet | Système d'arrosage | Le nom affiché sur les pages de garde des documents. |
| Votre nom | Norbert Weber | Votre nom apparaîtra dans le pied de page de chaque document. |
| La langue souhaitée | FR, EN, DE ou LU | Français, anglais, allemand ou luxembourgeois. Par défaut l'anglais pour les projets consommateurs; le Kit reste en français par exception documentée. |
3Créer le projet et injecter le Kit
Ouvrir un nouveau fil de travail et fournir l’archive du Kit, ou laisser l’IA la récupérer à son adresse de téléchargement. Elle en déploie l’arbre entier, sans exception.
Ces fichiers ne seront pas modifiés par votre projet — ils sont les mêmes pour tous les projets qui utilisent ce Kit. Ils fournissent les règles de formatage, les instructions permanentes et les références visuelles.
Les fichiers propres à votre projet — Registry, prompt projet, glossaire, Cover Sheet personnalisée, modules de données éventuels — ne viennent pas de l’archive: ils sont créés from scratch pendant l’amorçage, à partir des squelettes normatifs de Structure commune.
| Fichier Kit | Rôle |
|---|---|
| Kit - Registry.js | Source de vérité des versions actives des stylesheets et des horodatages des documents Kit. |
| Kit - Projet - Prompt - LANG (TS).docx | Instructions techniques permanentes — lues en tête de chaque session. |
| Kit - Projet - Structure commune - LANG (TS).docx | Contrat normatif des fichiers projet et squelettes des modules de données. |
| Kit - Projet - Convention de nommage (TS).docx | Règles de nommage des fichiers du projet, tag de langue compris. |
| Kit - Projet - Guide d'initialisation - LANG (TS).docx | Ce guide. |
| Kit - Projet - Guide de mise à jour - LANG (TS).docx | Procédure de mise à jour du Kit. |
| Kit - Documentation - Reading Guide - LANG (TS).docx | Guide de lecture du classeur papier. |
| Kit - Documentation - Cover Sheet (TS).docx | Référence des constantes de rendu de la page de couverture. |
| Kit - Documentation - Cover Sheet - LANG (TS).png | Page de couverture Kit générée — première page du classeur. |
| Kit - Documentation - Pipeline HTML - LANG (TS).docx | Architecture du site, périmètre de publication, règles de déploiement. |
| Kit - Documentation - Quality Control - LANG (TS).docx | Référence unique des mécanismes de contrôle qualité et des prérequis de session. |
| Kit - Documentation - Prompts de dialogue - LANG (TS).docx | Commandes de dialogue à copier-coller dans le chat. |
| Kit - Documentation - Comment documenter ses projets - LANG (TS).docx | Repères pour les décisions qui précèdent la première ligne écrite. |
| Kit - Documentation - Étendre le Kit - LANG (TS).docx | Recette d’ajout de vos propres présentations sans modifier celles du Kit. |
| Kit - Glossaire - Termes - LANG (TS).docx | Glossaire Kit — couplet avec le module de termes. |
| Kit - Glossary - Terms (TS).js | Module des termes du glossaire Kit — rend les termes en italique teal dans tous les documents. |
| Kit - Brands (TS).js | Module des marques Kit — rend les marques en petites capitales grasses. |
| Kit - Text Highlights (TS).js | Module des fragments mis en évidence — rend en italique les entités déclarées par le projet. |
| Kit - Document Titles (TS).js | Module des libellés d’affichage — nom lisible de chaque document, titres de rubriques et libellés de catégories, dans la langue du lecteur. |
| Kit - Stylesheet - General - Code (TS).js | Feuille de style générale — moteur de formatage de tous les documents. |
| Kit - Stylesheet - General - Reference (TS).docx | Document de référence de la feuille de style générale. |
| Kit - Stylesheet - Glossary - Code (TS).js | Feuille de style glossaire. |
| Kit - Stylesheet - Glossary - Reference (TS).docx | Document de référence de la feuille de style glossaire. |
| Kit - Stylesheet - YAML - Code (TS).js | Feuille de style des blocs de code et YAML. |
| Kit - Stylesheet - YAML - Reference (TS).docx | Document de référence de la feuille de style YAML. |
| Kit - Stylesheet - HTML - Code (TS).js | Feuille de style HTML miroir — produit les pages du sous-site. |
| Kit - Stylesheet - HTML - Reference (TS).docx | Document de référence de la feuille de style HTML. |
| kit_check_markup.py | Contrôle de marquage entre un fichier source et le document produit, et contrôle d’accord des largeurs d’étiquette de note entre les trois artefacts qui les déclarent. |
| kit_check_ossature.py | Contrôle d’ossature entre les variantes de langue d’un document — séquence des blocs, niveaux, dimensions des tableaux. |
| kit_extract_map.py | Carte de structure d’un document existant — première étape de toute régénération. |
| kit_gen_document.js | Reconstruction d’un document depuis sa carte de structure — artefact stable, Quality Control §3.16. |
| kit_check_fidelite.py | Contrôle de fidélité de l’extraction — aller-retour comparé à l’octet près. |
| kit_check_registry.py | Contrôle du périmètre du Registry projet — appelé avant toute génération. Une clé hors périmètre se perd à la mise à jour suivante, sans que la perte se voie. |
| kit_check_setters.py | Linter de la discipline des setters — appelé avant chaque génération. Son absence rend inapplicable une règle obligatoire. |
| kit_check_couplets.py | Contrôle de l’horodatage partagé des membres d’un couplet. Un membre absent est signalé sans faire échouer. |
| kit_validate_docx.js | Validateur des documents produits — appelé après chaque génération, avant livraison. |
| kit_validate_xlsx.py | Validateur des fichiers de tableur produits par les pipelines qui en créent. |
| kit_render_cover_sheet.py | Renderer déterministe de la page de couverture, piloté par les constantes de rendu du document Cover Sheet. |
| fonts/ | Polices Poppins du renderer de couverture, avec leur licence OFL. |
| kit_patch_helpers.py | Helpers de construction de fragments pour les patches chirurgicaux — obligatoires pour insérer une note ou un encadré dans un document existant. |
| kit_gen_glossaire_docx.js | Helper de génération du .docx du glossaire, depuis le module de termes. Pendant de kit_gen_glossaire_html.js — une source, deux rendus. |
| kit_gen_glossaire_html.js | Helper de génération de la page glossaire du site, depuis le module de termes. Obligatoire dans tout projet qui publie un glossaire. |
| package.json | Déclaration des modules npm de la chaîne et de leur version minimale — installation à neuf par npm install. |
| favicon.svg, favicon.ico, apple-touch-icon.png, index-icon.svg | Icônes du sous-site, dessinées par le site parent et portées par le projet. La passe les copie dans les ressources du site; index-icon.svg n’est attendu que si rendering.indexIcon le déclare; son dessin se centre dans sa zone d’affichage et l’occupe entièrement, le stylesheet ne centrant que la boîte. |
4Lancer la première session
Une fois l’arbre du Kit en place, coller le texte ci-dessous en premier message.
Ce texte est un facilitateur: il impose la lecture de toutes les sources de vérité dans le bon ordre, un rapport de lecture explicite, la confirmation de votre configuration, et l'attente de votre feu vert avant la création du moindre fichier. Le résultat est cohérent parce qu'aucune étape ne peut être sautée.
AMORÇAGE D'UN NOUVEAU PROJET — INJECTION KIT COMPLÈTE ============================== CONFIGURATION DU PROJET : ------------------------------ Préfixe projet : [VOTRE PRÉFIXE] Nom complet : [NOM DU PROJET] Mon nom : [VOTRE NOM] Langue : [FR / EN / DE / LU] LECTURE OBLIGATOIRE — ORDRE STRICT : ------------------------------ Avant toute création de fichier projet, lire dans cet ordre : 1. Kit - Projet - Prompt (TS).docx — instructions techniques permanentes. 2. Kit - Stylesheet - General - Code.js + Reference.docx — moteur de formatage de tous les documents. 3. Kit - Stylesheet - Glossary - Code.js + Reference.docx — feuille de style du glossaire projet. 4. Kit - Stylesheet - YAML - Code.js + Reference.docx — blocs de code et YAML dans la documentation. 5. Kit - Stylesheet - HTML - Code.js + Reference.docx — feuille de style HTML miroir. 6. Kit - Projet - Structure commune (TS).docx — contrat normatif des fichiers projet et squelettes. 7. Kit - Projet - Convention de nommage (TS).docx — règles de nommage. 8. Kit - Documentation - Quality Control (TS).docx — chaîne de validation obligatoire et prérequis de session. 9. Kit - Projet - Guide d'initialisation (TS).docx — ce guide. RAPPORT DE LECTURE — RÉPONDRE AVANT DE CONTINUER : ------------------------------ Pour chaque document de la liste ci-dessus : − lu intégralement : oui / non − version ou horodatage relevé Puis confirmer : − les quatre informations de configuration − la liste des modules de données optionnels souhaités (marques, noms de variables, entités domotiques, Reading Guide, Cover Sheet projet) et leur valeur CONDITIONS D'ARRÊT : ------------------------------ Si l'une de ces conditions est réunie, arrêt complet et signalement explicite avant toute création : − un fichier Kit est absent de l’arbre de travail − un numéro de version déclaré dans le Registry ne correspond pas à la version réelle du fichier − deux fichiers d'un même couplet ont des horodatages différents − une information de configuration est manquante ou ambiguë APRÈS RAPPORT ET CONFIRMATIONS — ATTENDRE LE GO : ------------------------------ Ne créer aucun fichier projet avant d'avoir reçu un « go » explicite dans le chat. Annoncer d'abord le plan complet : ordre des fichiers à produire, contenu prévu, livraison séquentielle selon Kit - Projet - Prompt §9.
Après le rapport de lecture et la confirmation de vos modules optionnels, répondre simplement “go” dans le chat pour déclencher la création des fichiers projet.
5Ce qui se passe ensuite
Tout le travail technique est pris en charge. Vous n'avez rien à décider de technique au-delà des quatre informations du §2 et des modules optionnels confirmés à l'étape 2.
| # | Ce qui est fait | Ce que vous faites |
|---|---|---|
| 1 | Lit tous les fichiers Kit dans l'ordre et confirme sa compréhension: préfixe, nom, langue. | Vérifier que la configuration a bien été interprétée. |
| 2 | Demande quels modules optionnels activer et si vous souhaitez le Reading Guide et la Cover Sheet projet. | Répondre selon votre besoin. Sans avis, les défauts documentent un projet standard. |
| 3 | Crée les fichiers projet from scratch depuis les squelettes de Structure commune: Registry projet, prompt projet, glossaire, Cover Sheet personnalisée, modules activés. Si la Cover Sheet est demandée, vous êtes interrogé en interactif sur les valeurs propres au projet — les deux lignes de l'en-tête, la liste des rubriques, les documents de chaque rubrique. | Attendre. |
| 4 | Livre les fichiers un par un selon le protocole de livraison séquentielle. | Télécharger chaque fichier livré. |
| 5 | Confirme que le projet est prêt et liste les fichiers à conserver dans l’arbre. | Ranger les nouveaux fichiers dans l’arbre du projet. |
6Travailler au quotidien
6.1Début de session
Chaque conversation est indépendante — rien n'est retenu de la session précédente. Ce sont les fichiers du projet qui assurent la continuité. Au début de chaque session, l'IA vérifie que tout est en ordre avant de commencer.
Si un fichier manque à l’arbre, elle vous le signalera. Fournissez-le et poursuivez.
6.2Fin de session
Pour terminer une session, dire simplement:
Et maintenant pour la fin de session, s'il vous plaît.
Vous recevrez automatiquement un résumé de session, un inventaire des fichiers et, si nécessaire, un prompt projet mis à jour. L’inventaire dit ce que doit contenir l’archive de votre projet.
6.3Les fichiers à jour
La règle la plus importante: après chaque séance, ranger dans l’archive de votre projet les fichiers mis à jour qui vous ont été livrés. Sans cette étape, le fil suivant repart d’un arbre ancien.
Selon les flags activés dans votre Registry, tous les fichiers du tableau ci-dessous ne sont pas forcément présents dans votre projet. Ne conserver que ceux qui existent effectivement.
| Fichier | Quand le remplacer |
|---|---|
| Registry projet | Dès qu'un horodatage de document ou un flag change. |
| Prompt projet mis à jour | Dès qu'une nouvelle convention a été décidée en session. |
| Inventaire des fichiers | Après chaque fin de session. |
| Module de termes du glossaire | Dès que de nouveaux termes ont été ajoutés. |
| Module de marques | Dès qu'un nouveau nom de marque a été identifié — si le flag correspondant est actif. |
| Module de variables | Dès qu'un nouveau nom de variable a été identifié — si le flag correspondant est actif. |
| Module d'entités domotiques | Dès qu'une nouvelle entité a été identifiée — si le flag correspondant est actif. |
| Documents de contenu | Après chaque session où ils ont été modifiés. |
7Page de garde dans vos documents
Chaque document généré par ce Kit commence par une page de garde portant le titre, le sous-titre et la date. L'en-tête et le pied de page sont automatiquement supprimés sur cette première page pour un rendu propre — ils apparaissent uniquement à partir de la page 2.
Ce comportement est géré automatiquement par le Kit, sans intervention de votre part.