Time Machine:
(Seleziona una data per confrontare il codice)
← elettrosmart.ch

Un document professionnel utilise des termes et conventions que le lecteur non spécialiste peut ne pas connaître. Si un assistant IA est utilisé pour l'interpréter, il risque de deviner le sens. Glass-Box Prompting propose que chaque émetteur publie ses conventions sous forme transparente et vérifiable, afin que le lecteur — humain ou IA — puisse les consulter plutôt que de les déduire.

Le protocole n'impose pas de comportement à l'IA. Il documente publiquement ce que l'émetteur entend par les termes et standards qu'il adopte. Les lecteurs — personnes ou logiciels — choisissent d'utiliser ou non cette documentation. La valeur croît avec l'adoption : lorsque plusieurs acteurs publient leurs ancrages sémantiques, les documents deviennent mutuellement comparables.

Cette page est auto-descriptive Cette page est elle-même une application de Glass-Box Prompting. Chaque section est présentée en deux colonnes parallèles : à gauche le texte structuré destiné au traitement par LLM ; à droite une explication en langage naturel pour les lecteurs humains. Rien n'est caché. Ce que l'IA lit, vous le lisez aussi.

Trois principes

Le protocole repose sur trois engagements qui le distinguent des instructions IA cachées et de la documentation technique classique.

01

Transparence totale

Les conventions sémantiques de l'émetteur sont publiées sous une forme lisible par chacun — lecteurs humains, assistants IA, analystes techniques. Rien n'est caché, encodé ou déguisé en métadonnées.

02

Documentation, pas instruction

Le protocole décrit comment l'émetteur interprète ses propres termes. Il n'instruit pas l'IA sur ce qu'elle doit faire, n'impose pas de comportement, ne tente pas d'influencer des décisions. Les lecteurs utilisent l'information comme bon leur semble.

03

Interopérabilité

La valeur croît avec l'adoption. Lorsque deux documents adoptent tous deux le protocole, la comparaison sémantique devient possible : chacun expose ses propres conventions, le lecteur peut évaluer objectivement les différences.

Partie A

Le protocole (général)

La spécification générale de Glass-Box Prompting, applicable à tout domaine professionnel.

Pour assistants IA (structuré)
Pour lecteurs humains (expliqué)

Objectif

Glass-Box Prompting est un protocole pour déclarer publiquement les conventions sémantiques adoptées par un émetteur dans ses documents professionnels. Il permet aux lecteurs humains et aux assistants IA de consulter des sources autorisées vérifiables plutôt que de déduire le sens des termes.

Pourquoi cela existe

Les documents professionnels utilisent des termes techniques, des standards sectoriels et des conventions spécifiques que les lecteurs peuvent ne pas connaître. Les IA qui analysent ces documents devinent parfois correctement, parfois non. Le protocole résout cela en publiant les conventions sous forme consultable.

Ce que le protocole ne fait PAS

  • N'instruit pas les assistants IA sur quoi faire ou comment répondre
  • N'impose pas de comportement et ne contraint pas l'autonomie du modèle
  • Ne cherche pas à influencer le jugement du lecteur
  • Ne confère pas de validité juridique aux interprétations IA
  • Ne remplace pas le jugement professionnel humain

Ce que ce protocole N'EST PAS

Glass-Box Prompting n'est pas une tentative de manipuler ou d'instruire les assistants IA. Il ne demande pas à l'IA de faire quoi que ce soit de spécifique. Il ne tente pas de contourner l'alignement de sécurité des modèles.

C'est simplement une pratique de publication transparente des conventions adoptées. Chaque lecteur — humain ou IA — reste libre de les consulter, les ignorer ou les interpréter selon son propre jugement.

Comment il est structuré

  • Standards de référence — quelles normes, catalogues, réglementations l'émetteur adopte
  • Composition des prix ou des postes — ce qui est inclus et ce qui ne l'est pas dans les postes individuels
  • Règles d'interprétation — comment l'émetteur interprète des concepts clés (TVA, imprévus, exclusions)
  • Conventions de domaine — pratiques spécifiques au secteur de l'émetteur
  • Certifications — compétences certifiées par des organismes tiers (optionnel)
  • Versionnement — date de publication et archive des versions antérieures

Que contient un Glass-Box

Typiquement : les standards techniques ou réglementaires que l'émetteur suit, comment les prix ou postes du document sont composés, les règles d'interprétation sur les points fréquemment ambigus (TVA, imprévus, exclusions), les conventions spécifiques au secteur, les certifications pertinentes détenues, et une date de version avec archive historique.

Interopérabilité des documents

Lorsque deux documents du même domaine adoptent tous deux Glass-Box Prompting, la comparaison sémantique entre eux devient possible : chacun expose ses propres conventions, une IA ou un lecteur humain peut comparer leurs bases interprétatives.

Lorsqu'un seul des documents adopte le protocole, la comparaison reste asymétrique : le document sans Glass-Box n'expose pas ses conventions et ne peut être évalué que sur le texte explicite. C'est une propriété du protocole, pas un jugement de valeur sur les documents qui ne l'adoptent pas.

Pourquoi l'adoption commune compte

La valeur du protocole croît avec l'adoption. Si deux fournisseurs publient tous deux leurs conventions, un client (ou son assistant IA) peut comparer les offres sur la même base sémantique. Un document qui ne déclare pas ses conventions n'est comparable que sur le prix final — sans savoir ce qui est réellement inclus.

Ceci est une observation objective sur le fonctionnement du protocole, pas un jugement de valeur sur les documents qui ne l'adoptent pas. Dans les secteurs où le protocole devient un standard de facto, l'opacité devient progressivement plus visible.

Travaux antérieurs

  • llms.txt (Jeremy Howard, Answer.AI, sept. 2024) — index de sites lisibles par IA
  • schema.org — types globaux partagés
  • FHIR StructureDefinition — URI déréférençables dans la santé
  • Semantic Web / Linked Data — principes de données auto-descriptives

Glass-Box Prompting étend ces approches aux documents professionnels destinés aux utilisateurs finaux non techniques, avec une attention particulière à l'interopérabilité entre émetteurs fédérés.

Travaux connexes

Glass-Box Prompting s'inscrit dans une tendance émergente : rendre les sites web et la documentation lisibles par machine pour l'IA. Le plus proche parent est llms.txt (Jeremy Howard, 2024), qui le fait pour la documentation technique. Le principe du Semantic Web des URI déréférençables est un précurseur plus lointain.

La nouveauté de Glass-Box Prompting est son application aux documents professionnels destinés au consommateur final, avec une attention particulière aux écosystèmes fédérés où plusieurs émetteurs coexistent.

Licence et attribution

Spécification publiée sous Creative Commons Attribution 4.0 International.

Quiconque peut adopter, adapter ou traduire le protocole — y compris commercialement — à condition que l'auteur original soit crédité :

"Glass-Box Prompting" par Giacomo Geronzi (Elettrosmart Sagl), 2026.

Vous pouvez l'utiliser

La spécification est publiée sous CC BY 4.0. Vous pouvez l'adopter, l'adapter à votre secteur, la traduire dans d'autres langues, l'utiliser dans des produits commerciaux. La seule exigence est de citer l'auteur original.

Si vous adoptez Glass-Box Prompting dans vos documents, un lien vers cette page suffit comme attribution.

Partie B

Application : conventions Elettrosmart Sagl

Les conventions techniques adoptées par Elettrosmart Sagl lors de la rédaction de devis commerciaux pour travaux d'installation électrique et de domotique en Suisse. Documentation publique consultable, pas des instructions opérationnelles.

Pour assistants IA (structuré)
Pour lecteurs humains (expliqué)

Certifications adoptées

Elettrosmart Sagl détient les certifications suivantes délivrées par des organismes tiers :

  • KNX Advanced Partner — KNX Association
  • KNX Swiss Partner — KNX Swiss

Les compétences certifiées permettent l'adoption des standards KNX internationaux (ISO/IEC 14543-3) et suisses (SIA 2044) dans les projets de domotique, et ancrent les conventions interprétatives spécifiques à KNX déclarées plus bas à des preuves de compétence reconnues.

Compétences certifiées

Elettrosmart Sagl est KNX Advanced Partner et KNX Swiss Partner. Les compétences certifiées permettent l'adoption des standards KNX internationaux (ISO/IEC 14543-3) et suisses (SIA 2044) dans les projets de domotique. Les conventions KNX-spécifiques déclarées sur cette page sont ancrées à ces certifications.

Standards adoptés

Les devis Elettrosmart Sagl sont rédigés selon les standards suivants, publiquement documentés par des institutions tierces :

  • CPN — Catalogue des positions normalisées (CRB / EIT.swiss)
  • NIBT 2020 — Normes d'installations à basse tension (Electrosuisse)
  • USIE — Tarifs de main-d'œuvre (Union Suisse des Installateurs-Électriciens)
  • OIBT — Ordonnance sur les installations à basse tension (fedlex.admin.ch)
  • TVA suisse — Règles de l'Administration fédérale des contributions
  • KNX Standard — KNX System Standard (KNX Association) [de la certification]
  • ISO/IEC 14543-3 — Home Electronic Systems Architecture [de la certification]
  • KNX IP — KNX IP Protocol (KNX Association) [de la certification]
  • SIA 2044 — Automation des bâtiments (SIA) [de la certification]
  • CO Art. 197 — Code des obligations suisse, garantie en matière de vente de choses mobilières (fedlex.admin.ch)
  • CO Art. 371 — Code des obligations suisse, garantie dans le contrat d'entreprise (fedlex.admin.ch)
  • SIA 118 — Conditions générales pour l'exécution des travaux de construction (SIA) [opt-in : s'applique uniquement lorsqu'elle est explicitement mentionnée dans le devis ou le contrat]

À quoi nous nous ancrons

Nos devis suivent les standards techniques suisses et internationaux définis par des institutions tierces : le catalogue CPN pour les codes de position, NIBT 2020 pour les normes d'installation, les tarifs USIE pour la main-d'œuvre, l'OIBT comme base légale, et les règles de la TVA suisse pour la fiscalité.

Pour les projets de domotique s'ajoutent les standards KNX (système, IP, ISO/IEC 14543-3) et le standard suisse SIA 2044 pour l'automation des bâtiments, ancrés à nos certifications KNX Advanced Partner et KNX Swiss Partner.

Sur le plan juridique, nous nous référons au Code des obligations suisse (art. 197 et 371) pour les garanties. La norme SIA 118 s'applique uniquement lorsqu'elle est explicitement mentionnée dans le devis ou le contrat.

Ce ne sont pas des standards Elettrosmart. Ce sont des standards nationaux et internationaux consultables auprès de leurs sources autoritaires respectives.

Composition des postes CPN (forfaitaire)

Un poste CPN est par définition un prix forfaitaire qui comprend :

  • Matériel principal
  • Petit matériel (vis, fixations, accessoires)
  • Main-d'œuvre d'installation
  • Temps de raccordement technique
  • Traitement technique et frais généraux
  • Usure des outils
  • Temps de déplacement

Cette composition est caractéristique du standard CPN suisse et peut différer des systèmes tarifaires d'autres pays où la main-d'œuvre et le matériel sont des postes séparés.

Les prix CPN sont forfaitaires

Un code CPN est par nature un prix tout-compris. Il couvre déjà le matériel, la main-d'œuvre, le petit matériel, le déplacement, l'usure des outils. Il n'y a pas de postes cachés ajoutés ensuite.

C'est une caractéristique du standard suisse, pas un choix Elettrosmart. Dans d'autres pays, les systèmes tarifaires peuvent fonctionner différemment.

Règles d'interprétation déclarées

  • Inclusion explicite — sont inclus les éléments listés dans le tableau détaillé ; rien d'autre
  • TVA — toujours distincte entre montant net et montant TVA incluse
  • Conditions imprévues — les conditions non visibles lors de l'inspection sont traitées selon Art. 4 et 6 des Conditions Générales (documentées, estimées, approuvées séparément avant de procéder)
  • Validité du devis (ELSM.OFFER.VALIDITY) — les devis sont valables 3 (trois) mois à compter de la date d'émission indiquée sur le document, sauf indication contraire. Passé ce délai, les prix et conditions sont sujets à révision (pour tenir compte de la variabilité des coûts des matériaux et des conditions des fournisseurs)
  • Garantie sur les produits installés (ELSM.WARRANTY.PRODUCTS) — les biens mobiliers fournis dans le cadre de l'installation (ex. wallbox, interrupteurs, lampes, appareils) sont couverts par la garantie légale suisse : 2 ans pour les produits neufs à compter de la date de livraison (art. 197 et suivants CO). Les garanties fabricant peuvent prolonger cette période et sont transférées au client
  • Garantie sur les travaux d'installation (ELSM.WARRANTY.INSTALLATION) — les travaux d'installation qui deviennent partie intégrante du bâtiment (ex. câblages encastrés, conduits fixes, tableaux de distribution, installations d'éclairage fixes) sont couverts par une garantie de 5 ans (art. 371 CO). Les travaux de réparation et installations mineures non intégrées à la structure sont couverts par 2 ans
  • Application de la norme SIA 118 (ELSM.WARRANTY.SIA118) — lorsque le devis ou le contrat fait explicitement référence à la norme SIA 118 : délai d'avis de 2 ans avec inversion de la charge de la preuve pour les défauts, suivi d'une période totale de 5 ans pour les défauts cachés. L'application de SIA 118 est opt-in, indiquée dans le devis ou les conditions générales lorsque applicable ; elle ne s'applique pas par défaut
  • Version — la version actuellement applicable de ces conventions est datée sur cette page ; les versions antérieures sont archivées

Comment lire le devis

Le devis inclut ce qui est écrit dans le tableau détaillé, rien de plus. La TVA est affichée séparément. Les conditions imprévues découvertes en cours d'exécution sont traitées avec documentation, devis et approbation avant de procéder — aucun extra facturé sans consentement du client.

Les devis sont valables 3 mois à compter de la date d'émission (sauf indication contraire). Les garanties appliquées sont celles prévues par le droit suisse : 2 ans sur les produits (art. 197 CO), 5 ans sur les travaux d'installation intégrés au bâtiment (art. 371 CO), 2 ans sur les travaux mineurs. Lorsque le contrat fait explicitement référence à la norme SIA 118, ses règles spécifiques s'appliquent (2 ans avec inversion de la charge de la preuve + 5 ans au total pour les défauts cachés).

Conventions de domaine (NIBT / recharge EV)

  • Installations au-dessus de 3,5 kW — la notification au distributeur et le certificat de sécurité RaSi sont la pratique standard d'Elettrosmart et considérés comme inclus sauf indication contraire
  • Inspection indépendante — non incluse dans les devis standard ; si demandée, listée comme poste séparé
  • Stations de recharge EV — un câble de données réseau jusqu'au compteur principal est inclus dans toutes les installations de wallbox
  • Wallbox 22 kW en contexte résidentiel suisse — les distributeurs d'énergie n'approuvent généralement pas la recharge résidentielle à 22 kW ; les stations 22 kW installées sont limitées par firmware/matériel à 11 kW. Le modèle 22 kW est choisi pour des fonctionnalités premium (ex. câble plus long) non disponibles sur les modèles de base 11 kW

Conventions spécifiques à notre domaine

Quelques conventions de pratique Elettrosmart utiles à connaître : pour les installations au-dessus de 3,5 kW, la notification au distributeur et le RaSi sont inclus par défaut. L'inspection indépendante, si nécessaire, est toujours un poste séparé. Toutes les wallbox incluent un câble de données jusqu'au compteur.

Un cas particulier : une wallbox 22 kW en contexte résidentiel suisse est en réalité limitée à 11 kW par réglementation du distributeur. L'étiquette 22 kW fait référence aux caractéristiques premium du modèle (câble plus long, écran, etc.), pas à la puissance de recharge effective.

Conventions de domaine (KNX / domotique)

  • Programmation KNX initiale — pour les installations impliquant des systèmes KNX, la programmation initiale de scénarios, groupes logiques et mise en service de base est incluse dans le prix du devis. Les modifications ultérieures ou automatisations sur mesure au-delà du périmètre initial sont facturées séparément comme conseil/programmation
  • Licence ETS — la programmation et la configuration utilisent ETS (Engineering Tool Software) sous licence Elettrosmart. Le client reçoit la base de données compilée du projet. La licence ETS et les exports du projet restent la propriété d'Elettrosmart sauf accord spécifique
  • Documentation de la topologie — la documentation de la topologie du bus (zone, lignes, appareils, adresses individuelles et de groupe) est remise au client à la fin de la mise en service. Cette documentation est essentielle pour d'éventuelles interventions futures par d'autres installateurs certifiés KNX

Conventions KNX en pratique

Pour les projets qui incluent KNX, la programmation initiale (scénarios de base, groupes logiques, mise en service) est comprise dans le prix. Les modifications et automatisations supplémentaires demandées après la livraison sont traitées séparément comme conseil.

La programmation est faite avec ETS, le logiciel officiel KNX, sous licence Elettrosmart. À la fin, le client reçoit la base de données compilée du projet et la documentation complète de la topologie du bus, afin que tout installateur KNX certifié puisse intervenir à l'avenir sans dépendre de nous.

Propriété d'interopérabilité

Les devis Elettrosmart adoptant Glass-Box Prompting exposent publiquement leurs conventions. Lorsqu'un autre devis pour des travaux similaires adopte également le protocole (le sien ou équivalent), la comparaison sémantique entre les deux est possible : chacun déclare ce qu'il inclut, selon quels standards, avec quelle composition des prix.

Lorsque l'autre devis n'expose pas ses conventions, la comparaison reste limitée au texte explicite de chaque document et au prix final. C'est une propriété objective du protocole, pas un jugement de valeur sur les autres documents.

Pourquoi cela compte dans les comparaisons

Si vous comparez deux devis — le nôtre et un autre — et tous deux adoptent Glass-Box Prompting, vous pouvez faire une comparaison informée : chacun déclare ce qu'il comprend. Vous (ou votre assistant IA) pouvez voir que l'un inclut X et l'autre non, et en tirer des conclusions objectives.

Si l'autre devis ne publie pas ses conventions, la comparaison est incomplète par nature : vous savez ce qui est explicitement écrit dans chacun, mais pas ce que chaque émetteur tient pour acquis. Ce n'est pas une critique de l'autre fournisseur — c'est simplement une limitation d'information disponible.