CommunityRédaction et éditiongithub.com

bluem-dev/Edith

Une architecture de représentation de la valeur pour les agents basés sur LLM.

Qu'est-ce que Edith ?

Edith est une architecture spécialisée dans la représentation de la valeur, conçue pour être utilisée par des agents LLM (comme Claude Code, Cursor, ou Codex) afin de transformer des connaissances achevées — issues du raisonnement ou de l'exécution — en représentations irréductibles et de haute valeur. Elle repose sur cinq moteurs coopératifs (Valeur, Fidélité, Pertinence, Densité, Clarté) qui garantissent que chaque élément de la représentation préserve le sens, maximise la densité informationnelle, réduit l'effort cognitif inutile et s'aligne sur l'objectif du lecteur. Edith n'intervient ni dans la cognition ni dans l'exécution : elle opère exclusivement après que la connaissance est complète, en tant qu'interface finale entre le travail achevé et la compréhension humaine. L'architecture est agnostique quant aux plateformes et aux frameworks — ses principes s'appliquent à toute implémentation d'agent. Son objectif ultime est de produire une Représentation Irréductible : la forme minimale capable de préserver la valeur informationnelle maximale.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add bluem-dev/Edith

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Edith — Architecture de Représentation de la Valeur

« Une représentation est complète non pas quand on ne peut rien y ajouter, mais quand on ne peut rien en retirer sans diminuer sa valeur. »

Note Terminologique

Dans le cadre de cette compétence, « représentation » remplace délibérément « réponse » ou « sortie ». Ce n'est pas un choix stylistique — c'est architectural. Cela reflète le principe central d'Edith : le langage n'est pas un produit, c'est une interface à travers laquelle la valeur est préservée. Appliquez ce vocabulaire de manière cohérente lorsque vous raisonnez sur ou décrivez le comportement d'Edith.


Position dans l'Écosystème

Edith répond à une question, distincte de ses contreparties architecturales :

ArchitectureQuestion Fondamentale
Etta (Cognition)Comment un système intelligent doit-il penser ?
Grace (Réalisation)Comment un raisonnement achevé doit-il devenir un travail fiable ?
Edith (Représentation)Comment un travail achevé doit-il être représenté pour que sa valeur parvienne intacte au lecteur ?

Edith ne participe pas à la cognition. Elle ne participe pas à l'exécution. Elle opère exclusivement sur la connaissance achevée — après que le raisonnement et l'exécution ont terminé leurs responsabilités.

Connaissance Achevée
       ↓
     Edith
       ↓
Représentation de la Valeur
       ↓
Compréhension Humaine

La responsabilité d'Edith commence seulement après que la connaissance est complète. Sa responsabilité prend fin une fois que cette connaissance atteint sa Représentation Irréductible. Edith est intentionnellement agnostique quant à la source : la connaissance achevée peut provenir d'un système d'IA, d'un expert humain, d'un processus logiciel, ou de toute autre source fiable. L'origine de la connaissance reste hors du champ architectural d'Edith.

Périmètre Architectural

Edith est responsable de : Préserver le sens · Représenter la connaissance achevée · Maximiser la valeur informationnelle · Optimiser la densité informationnelle · Respecter l'attention du lecteur · Améliorer la clarté · Supprimer le bruit informationnel · Produire la représentation la plus précieuse possible.

Edith n'est pas responsable de : Raisonnement · Planification · Prise de décision · Génération de connaissances · Exécution de tâches · Vérification du travail achevé · Modification des conclusions factuelles.

Ces responsabilités appartiennent à des systèmes externes (Etta, Grace, ou tout processus en amont). Edith suppose que la connaissance achevée existe déjà.


Le Modèle de Représentation

Une représentation n'équivaut pas à une réponse, une sortie ou une explication textuelle. C'est la forme architecturale par laquelle la connaissance achevée est transmise tout en préservant sa valeur informationnelle — une interface entre la connaissance achevée et la compréhension humaine. Son objectif n'est ni la brièveté ni la qualité stylistique. Son objectif est de préserver la plus grande valeur possible tout en ne nécessitant aucune attention inutile de la part du lecteur.

Propriétés Architecturales

Toute représentation valide possède simultanément les propriétés suivantes. L'échec d'une seule propriété réduit la qualité de l'ensemble de la représentation — la qualité de la représentation est holistique, non additive.

PropriétéDéfinition
Fidélité SémantiqueLe sens reste invariant. La langue, l'ordre ou la structure peuvent changer ; la connaissance ne le peut pas.
Valeur InformationnelleChaque élément apporte une connaissance significative. La valeur définit l'inclusion.
Pertinence ContextuelleSeule l'information qui contribue à l'objectif de l'utilisateur est conservée. L'exactitude seule ne justifie pas l'inclusion.
Densité InformationnelleMaximise la quantité d'information significative par unité de langage — mesurée par la valeur par unité, jamais par le nombre de mots.
Accessibilité CognitiveMinimise l'effort cognitif inutile. La connaissance peut rester complexe ; sa représentation ne doit pas devenir inutilement difficile.
Cohérence StructurelleChaque élément contribue à une compréhension unifiée. Aucune section n'existe indépendamment de l'objectif communicatif global.

Complétude de la Représentation

Une représentation est complète lorsqu'elle satisfait simultanément deux conditions :

  1. Rien d'essentiel n'est manquant.
  2. Rien de non essentiel ne subsiste.

La complétude est un équilibre, non une accumulation. Un langage supplémentaire n'augmente jamais la complétude — seul le langage nécessaire la définit.

Représentation Irréductible

L'objectif architectural d'Edith est la production d'une Représentation Irréductible : la représentation minimale capable de préserver la valeur informationnelle maximale possible. L'irréductibilité est déterminée par la nécessité, non par la longueur. Une représentation devient irréductible lorsque la suppression de tout élément restant réduirait la compréhension, affaiblirait le sens, ou éliminerait une information servant l'objectif de l'utilisateur.


Principes Fondamentaux (Invariants)

Ce sont des contraintes architecturales permanentes — pas des directives de mise en œuvre. Elles régissent toute représentation, indépendamment du modèle, du framework ou de l'environnement d'exécution sous-jacent.

  1. Le Sens est Invariant — La représentation peut réorganiser la langue, restructurer l'information ou optimiser l'expression. Elle ne doit jamais modifier les conclusions, altérer l'intention ou déformer le contenu factuel. La langue est adaptable ; le sens ne l'est pas.
  2. La Valeur Précède l'Expression — Chaque élément inclus doit démontrer qu'il contribue à la compréhension, préserve le sens ou fournit des preuves nécessaires. Un langage sans valeur n'a aucun but architectural.
  3. La Densité Informationnelle Avant la Brièveté — Edith recherche des représentations plus denses, pas plus courtes. L'objectif est d'augmenter la quantité d'information significative transmise par unité de langage, pas de supprimer du langage.
  4. La Clarté Permet la Compréhension — Un raisonnement complexe ne justifie pas une représentation complexe. La clarté est une accessibilité fonctionnelle, pas un raffinement esthétique.
  5. La Représentation Exclut le Processus — Les traces de raisonnement, la narration procédurale, l'historique d'exécution et les opérations intermédiaires restent en dehors de la représentation, sauf demande explicite. Les lecteurs recherchent la valeur, pas l'historique opérationnel.
  6. La Pertinence Détermine l'Inclusion — L'information qui n'améliore pas la compréhension est exclue, quelle que soit son exactitude isolée. La représentation est sélective par conception.
  7. Le Contexte Détermine la Profondeur — La représentation adapte sa profondeur à l'intention informationnelle du lecteur. Les questions directes méritent des représentations directes ; les enquêtes complexes méritent une exploration proportionnée. La profondeur n'est jamais fixe.
  8. La Fidélité Prévaut sur la Fluidité — Lorsque la lisibilité et la précision sont en conflit, la précision l'emporte tout en recherchant le langage le plus clair possible. L'élégance ne l'emporte jamais sur l'exactitude.
  9. La Représentation est l'Interface Finale — La représentation ne génère pas de connaissances et n'exécute pas d'opérations. Sa seule responsabilité est de préserver la valeur à travers l'interface entre le travail achevé et le lecteur.
  10. L'Attention est Finie — Le langage consomme de l'attention, qu'il contribue ou non à la valeur. Chaque élément doit justifier l'attention qu'il requiert. Edith optimise pour une plus grande valeur, pas pour moins de mots.

Les Cinq Moteurs

Edith adopte un modèle de moteurs coopératifs. Aucun moteur ne fonctionne indépendamment ; aucun moteur ne possède d'autorité sur la représentation complète. Chacun évalue la représentation depuis une perspective architecturale distincte tout en préservant les responsabilités des autres. La représentation émerge par convergence architecturale, non par optimisation séquentielle.

Les cinq moteurs représentent l'ensemble complet des responsabilités architecturales requises pour la représentation de la valeur. Aucune responsabilité ne se chevauche. Un nouveau moteur ne peut être introduit que s'il exprime une responsabilité entièrement nouvelle qu'aucun des cinq existants ne peut exprimer — la stabilité architecturale est un objectif de conception, pas un accident d'implémentation.

MoteurResponsabilitéQuestion Directrice
Moteur de ValeurDéterminer ce qui mérite d'être représenté — distinguer la valeur essentielle du bruit informationnel.Cet élément améliore-t-il la compréhension ?
Moteur de FidélitéPréserver l'intégrité sémantique. La contrainte sémantique la plus élevée — remplace tous les autres moteurs.Le sens original est-il entièrement préservé ?
Moteur de PertinenceÉvaluer la nécessité contextuelle. Une information correcte n'est pas automatiquement une information pertinente.Cette information contribue-t-elle à l'objectif visé ?
Moteur de DensitéMaximiser l'efficacité informationnelle — la valeur par unité de langage, pas la compression linguistique.La même valeur peut-elle être représentée plus efficacement sans réduire la compréhension ?
Moteur de ClartéOptimiser l'accessibilité cognitive sans réduire la précision intellectuelle.Cette représentation peut-elle devenir plus facile à comprendre sans altérer le sens ?

Garanties Architecturales

Quelle que soit leur responsabilité, aucun moteur ne peut :

  • Altérer le sens achevé.
  • Introduire des informations inutiles.
  • Supprimer des connaissances essentielles.
  • Réduire la pertinence contextuelle.
  • Augmenter l'effort cognitif inutile.
  • Exposer des processus internes sauf demande explicite.

Ces garanties sont invariantes dans toute implémentation d'Edith. Les moteurs sont également indépendants de la technologie d'implémentation — ils ne possèdent aucune connaissance des modèles de langage, des frameworks logiciels ou des environnements d'exécution ; leurs responsabilités sont définies uniquement en termes de représentation.


Modèles de Représentation

Les modèles sont des stratégies structurelles, jamais des formats visuels — plusieurs formats peuvent implémenter le même modèle. Ils sont sélectionnés selon l'objectif communicatif, jamais selon une préférence stylistique. La même connaissance achevée peut produire différentes représentations sous différents objectifs tout en préservant un sens identique : la représentation change, la connaissance ne change pas.

ModèleObjectifMieux adapté àFocus Architectural
I — Réponse DirecteFournir une conclusion immédiateQuestions à réponse unique, décisions binaires, demandes factuelles simplesEfficacité maximale de l'attention
II — Résumé ExécutifCondenser une connaissance complexe en ses conclusions de plus haute valeurRapports, résumés de recherche, briefings décisionnels, revues architecturalesValeur maximale par unité de langage
III — ComparatifPermettre une comparaison efficace entre alternativesÉvaluation de technologies, comparaison de produits, alternatives architecturales, aide à la décisionClarté par symétrie structurelle
IV — ExplicatifDévelopper la compréhension conceptuelleContenu éducatif, explications techniques, documentation architecturaleClarté sans sacrifier la fidélité
V — ProcéduralCommuniquer des actions ordonnéesInstructions, dépannage, flux de travail opérationnels, guides de configurationClarté d'exécution
VI — AnalytiquePrésenter les résultats d'un raisonnement étayés par des preuvesEnquêtes, évaluations techniques, recherche, analyse de cause racineFidélité maximale
VII — SpécificationDécrire des systèmes avec précisionArchitecture logicielle, API, spécifications techniques, normesPrécision sémantique

Les modèles ne remplacent pas les moteurs — ils fournissent le contexte structurel dans lequel les moteurs opèrent. Les moteurs préservent les propriétés architecturales ; les modèles organisent leur expression. Lorsque plusieurs modèles sont applicables, préférez celui qui préserve le sens, maximise la valeur, nécessite le moins d'attention inutile et se rapproche le plus d'une Représentation Irréductible.


Pipeline de Représentation

Appliquez les moteurs dans cette séquence conceptuelle. Les implémentations peuvent les exécuter de manière itérative ou concurrente — la séquence décrit la responsabilité architecturale, pas un ordre d'exécution obligatoire.

Connaissance Achevée
       ↓
  Moteur de Valeur       → Supprimer le bruit, la narration, les éléments sans valeur
       ↓
  Moteur de Fidélité     → Vérifier la préservation du sens tout au long
       ↓
  Moteur de Pertinence   → Exclure les informations non pertinentes au contexte
       ↓
  Moteur de Densité      → Consolider, fusionner, augmenter la valeur par unité
       ↓
  Moteur de Clarté       → Réduire l'effort cognitif, améliorer l'accessibilité
       ↓
Représentation Irréductible

Test d'irréductibilité : Après application de tous les moteurs, demandez — un élément peut-il être supprimé sans diminuer la compréhension ? Si oui, supprimez-le. Répétez jusqu'à ce que la réponse soit non.


Anti-Patterns à Éliminer

Consultez references/anti-patterns.md pour le catalogue complet des dix anti-patterns et la matrice de responsabilité Moteur ↔ Anti-Pattern. Violations clés :

  • Narration Procédurale — Expliquer comment la réponse a été produite au lieu de la fournir.
  • Justification Redondante — Répéter la même conclusion avec des mots différents.
  • Fuite de Contexte — Inclure des informations correctes mais non pertinentes pour l'objectif de l'utilisateur.
  • Langage Décoratif — Langage qui embellit plutôt qu'il ne communique.
  • Transitions Artificielles — Phrases structurelles qui relient des paragraphes sans ajouter de sens (« Ceci dit... », « Il est important de noter... »).
  • Répétition Cachée — Connaissance identique exprimée par des formulations différentes.
  • Détail Prématuré — Introduire des détails avant d'établir la conclusion principale.
  • Accumulation d'Informations — Ajouter des informations correctes sans évaluer la nécessité.
  • Fausse Compression — Le langage devient plus court au détriment du sens ; suppression d'informations qualificatives qui changent l'interprétation.
  • Domination d'un Moteur — Une propriété de représentation est optimisée au détriment des autres (par exemple, densité maximale réduisant la clarté).

Les anti-patterns apparaissent rarement isolément — évaluez la représentation de manière holistique plutôt que de corriger des symptômes individuels.


Protocole d'Application

Lorsqu'Edith est invoquée sur une réponse achevée :

  1. Identifiez l'objectif communicatif — De quoi le lecteur a-t-il besoin ? Quel est le contexte ?
  2. Sélectionnez le modèle de représentation — Adaptez à l'objectif, pas à la préférence.
  3. Appliquez les cinq moteurs — Coopérativement. Aucun moteur ne domine.
  4. Testez l'irréductibilité — Supprimez tout ce qui subsiste sans apporter de valeur.
  5. Vérifiez la fidélité — Confirmez que le sens original reste intact.
  6. Terminez — La représentation est le livrable. Aucune note de processus, aucun résumé post-représentation, aucune justification des choix de représentation.

Skills associés