Artefacts de gouvernance
Fichiers de gouvernance mobilisés par cette page
Cette page est arrimée à des surfaces publiées qui déclarent l’identité, la préséance, les limites et les conditions de lecture du corpus. Leur ordre ci-dessous donne la séquence de lecture recommandée.
Q-Metrics JSON
/.well-known/q-metrics.json
Surface de métriques descriptives pour observer des écarts, snapshots et comparaisons.
- Gouverne
- La description des écarts, des dérives, des snapshots et des comparaisons.
- Borne
- La confusion entre signal observé, preuve de fidélité et pilotage réel.
Ne garantit pas : Une surface d’observation documente un effet ; elle ne vaut pas, seule, comme garantie de représentation.
Q-Metrics YAML
/.well-known/q-metrics.yml
Projection YAML de Q-Metrics pour instrumentation et lecture structurée.
- Gouverne
- La description des écarts, des dérives, des snapshots et des comparaisons.
- Borne
- La confusion entre signal observé, preuve de fidélité et pilotage réel.
Ne garantit pas : Une surface d’observation documente un effet ; elle ne vaut pas, seule, comme garantie de représentation.
Q-Ledger JSON
/.well-known/q-ledger.json
Journal machine-first des observations, baselines et écarts versionnés.
- Gouverne
- La description des écarts, des dérives, des snapshots et des comparaisons.
- Borne
- La confusion entre signal observé, preuve de fidélité et pilotage réel.
Ne garantit pas : Une surface d’observation documente un effet ; elle ne vaut pas, seule, comme garantie de représentation.
Artefacts complémentaires (3)
Ces surfaces prolongent le bloc principal. Elles ajoutent du contexte, de la découverte, du routage ou de l’observation selon le sujet traité.
Q-Ledger YAML
/.well-known/q-ledger.yml
Projection YAML du journal Q-Ledger pour lecture procédurale ou outillage.
Protocole Q-Attest
/.well-known/q-attest-protocol.md
Protocole publié pour cadrer l’attestation, la preuve et la lecture des observations.
Carte de l’observatoire
/observations/observatory-map.json
Carte structurée des surfaces d’observation et des zones suivies.
Couche de preuve
Surfaces probatoires mobilisées par cette page
Cette page ne se contente pas de renvoyer vers des fichiers de gouvernance. Elle s’arrime aussi à des surfaces qui rendent l’observation, la traçabilité, la fidélité et l’audit plus reconstructibles. Leur ordre ci-dessous explicite la chaîne probatoire minimale.
- 01Autorisation de répondreQ-Layer : légitimité de réponse
- 02Carte d’observationObservatory map
- 03Observation faibleQ-Ledger
- 04Mesure dérivéeQ-Metrics
Q-Layer : légitimité de réponse
/response-legitimacy.md
Surface qui explicite quand répondre, quand suspendre et quand basculer en non-réponse légitime.
- Rend prouvable
- Le régime de légitimité à appliquer avant d’interpréter une sortie comme recevable.
- Ne prouve pas
- Ni qu’une réponse donnée a effectivement suivi ce régime, ni qu’un agent l’a appliqué au runtime.
- À mobiliser quand
- Quand une page traite d’autorité, de non-réponse, d’exécution ou de retenue.
Observatory map
/observations/observatory-map.json
Index machine-first des ressources d’observation, des snapshots et des points de comparaison publiés.
- Rend prouvable
- Où se trouvent les objets d’observation mobilisables dans une chaîne probatoire.
- Ne prouve pas
- Ni la qualité d’un résultat, ni la fidélité d’une réponse particulière.
- À mobiliser quand
- Pour localiser les baselines, journaux, snapshots et artefacts dérivés.
Q-Ledger
/.well-known/q-ledger.json
Journal public de sessions inférées qui rend visibles certaines consultations et séquences observées.
- Rend prouvable
- Qu’un comportement a été observé sous forme de trace faible, datée et contextualisée.
- Ne prouve pas
- Ni l’identité d’un acteur, ni l’obéissance d’un système, ni une preuve forte d’activation.
- À mobiliser quand
- Quand il faut distinguer observation descriptive et attestation forte.
Q-Metrics
/.well-known/q-metrics.json
Couche dérivée qui rend certaines variations plus comparables d’un snapshot à l’autre.
- Rend prouvable
- Qu’un signal observé peut être comparé, versionné et contesté comme indicateur descriptif.
- Ne prouve pas
- Ni la vérité d’une représentation, ni la fidélité d’une sortie, ni un pilotage réel à elle seule.
- À mobiliser quand
- Pour comparer des fenêtres, prioriser un audit et documenter un avant/après.
Surfaces probatoires complémentaires (1)
Ces artefacts prolongent la chaîne principale. Ils servent à qualifier un audit, un niveau de preuve, une citation ou une trajectoire de version.
Q-Attest protocol
/.well-known/q-attest-protocol.md
Spécification facultative qui sépare clairement les sessions inférées des attestations validées.
Publier des fichiers de gouvernance est nécessaire, mais insuffisant. L’enjeu opérationnel est simple : ces artefacts sont-ils réellement découverts, consultés et maintenus de façon stable dans le temps ?
Q-Metrics est une couche de métriques dérivées de Q-Ledger. Elle vise à rendre lisibles des signaux de découvrabilité, de dérive et de continuité, sous une forme comparable d’un snapshot à l’autre.
Avertissement : non-normatif, descriptif.
Ces métriques décrivent un état observé. Elles ne constituent ni une preuve de conformité, ni une attestation, ni une certification.
Du fichier statique au signal observable
Un fichier publié peut exister sans être consulté. Un endpoint peut être présent sans être découvert. Une gouvernance peut être déclarée sans être “lue” dans la pratique. Q-Metrics sert à mesurer ce décalage, en s’appuyant sur un journal d’observation (Q-Ledger).
Le point important est le suivant : les fichiers de gouvernance publient les conditions de lecture ; Q-Metrics n’observe que les traces laissées par ces conditions lorsqu’elles sont rencontrées, contournées ou interrompues. Pour replacer correctement cette couche métrique, il faut lire Le machine-first ne suffit pas : pourquoi les fichiers de gouvernance changent le régime de lecture, Ce que fait vraiment chaque fichier de gouvernance et Les métriques GEO voient l’effet, pas les conditions.
Trois familles d’indicateurs (noyau minimal)
1) Entrypoint compliance
Mesure la proportion d’entrypoints attendus observés comme consultés (ex. statuts 200/304) dans une fenêtre donnée. C’est un signal de découvrabilité effective.
2) Escape rate
Mesure la proportion d’observations qui sortent des entrypoints attendus (navigation inattendue, chemins non prévus, erreurs ou dérive). Un taux élevé peut indiquer une exploration agentique, une instabilité d’accès, ou un maillage/redirects problématiques.
3) Sequence fidelity
Mesure la cohérence de continuité entre snapshots : chaînage, absence de ruptures, progression attendue. Une baisse peut signaler un gap d’archive, un reset, ou une dérive de publication.
Comment lire sans surinterpréter
- Compliance en hausse : signal de découvrabilité et d’accès effectif aux entrypoints.
- Escape en hausse : signal d’exploration, d’instabilité ou de dérive (à qualifier avant conclusion).
- Fidelity en baisse : signal de rupture de continuité (ou d’archive manquante) à investiguer.
Un signal n’est pas une preuve. La lecture doit tenir compte du régime d’observation (validation, exploration, mixte) et de la fenêtre temporelle.
Ce que Q-Metrics ne remplace pas
- Une attestation cryptographique.
- Une preuve de conformité ou de responsabilité.
- Une garantie d’exhaustivité (hérite des biais de collecte).
Ressources
- Q-Metrics : /doctrine/q-layer/q-metrics/
- Q-Ledger : /doctrine/q-layer/q-ledger/
- Archive des snapshots : github.com/GautierDorval/q-ledger-archive
- Outils et format : github.com/GautierDorval/q-ledger