Audit de Contexte Agent : Quand Votre Propre Gouvernance Devient le Problème — et Comment la Réparer sans Rien Perdre

wc -l AGENT.adoc AGENT_MODUS_OPERANDI.adoc PROMPT_REPRISE.adoc \
  .agents/INDEX.adoc .agents/SESSIONS_HISTORY.adoc \
  .agents/archives/COMPLETED_TASKS_ARCHIVE_2026-04.adoc

  287 AGENT.adoc
  627 AGENT_MODUS_OPERANDI.adoc
   51 PROMPT_REPRISE.adoc
  218 .agents/INDEX.adoc
   18 .agents/SESSIONS_HISTORY.adoc
  213 .agents/archives/COMPLETED_TASKS_ARCHIVE_2026-04.adoc
 1414 total

@startuml
skinparam backgroundColor #FEFEFE

title Contexte EAGER — 1414 lignes

rectangle "AGENT_MODUS_OPERANDI\n**627 lignes (44%)**" as MOD #FFCDD2
rectangle "AGENT.adoc\n287 lignes (20%)" as AG #BBDEFB
rectangle "INDEX.adoc\n218 lignes (15%)" as IDX #C8E6C9
rectangle "COMPLETED_TASKS\n213 lignes (15%)" as ARC #FFF9C4
rectangle "PROMPT_REPRISE\n51 lignes (4%)" as PRO #E1BEE7
rectangle "SESSIONS_HISTORY\n18 lignes (1%)" as HIS #FFE0B2

note bottom of MOD
  Le fichier qui documente
  la méthode est devenu
  le plus gros poste de dépense
end note

@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center

title Audit de AGENT_MODUS_OPERANDI.adoc — 627 lignes

left to right direction

rectangle "🟡 **Doublons**\n167 lignes (27%)" as DUP #FFF9C4 {
  card "P3 — Règles absolues\n(34 lignes)" as D1
  card "P4 — Cycle de vie\n(133 lignes)" as D2
  card "P9 — Références\n(30 lignes)" as D3
}

rectangle "🔴 **Jamais consulté**\n215 lignes (34%)" as JAM #FFCDD2 {
  card "P5 — Métriques\n(49 lignes)" as J1
  card "P6 — Détection\n(72 lignes)" as J2
  card "P7 — Amélioration\n(39 lignes)" as J3
  card "P8 — Bootstrap\n(13 lignes)" as J4
  card "Annexes — Glossaire\n(42 lignes)" as J5
}

rectangle "🟢 **Connaissance unique**\n161 lignes (26%)" as UNI #C8E6C9 {
  card "P1 — Vue d'ensemble\n(64 lignes)" as U1
  card "P2 — Structure fichiers\n(97 lignes)" as U2
}

note bottom of UNI
  C'est ÇA qu'il faut garder en EAGER.
  Le reste → cold storage.
end note

@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center

title Split Encyclopédique — AGENT_MODUS_OPERANDI

left to right direction

rectangle "**AGENT_MODUS_OPERANDI.adoc**\n627 lignes\n(avant split)" as BEFORE #FFCDD2 {
}

rectangle " " as ARROW1
rectangle " " as ARROW2

rectangle "**LAZY_EAGER_ESSENTIALS.adoc**\n**~50 lignes — EAGER**" as ESS #C8E6C9 {
  card "P1 condensée\n(15 lignes)" as E1
  card "P2 condensée\n(35 lignes)" as E2
}

rectangle "**.agents/encyclopedies/**\n**LAZY_EAGER_ENCYCLOPEDIE.adoc**\n627 lignes — COLD" as ENC #BBDEFB {
  card "P1 à Annexes\n(intégral, intact)" as C1
}

BEFORE -[#4CAF50]-> ESS : "Extraction de\nla connaissance critique"
BEFORE -[#2196F3]-> ENC : "Préservation intégrale\nde l'ingénierie"

note bottom of ESS
  Chargé automatiquement
  en début de session
  → L'agent comprend le vocabulaire
end note

note bottom of ENC
  Jamais chargé automatiquement
  Consultable par l'humain
  Matériau brut pour distillation future
end note

@enduml

= Stratégie LAZY/EAGER — Principes Essentiels

[abstract]
Ce fichier définit la stratégie de gestion du contexte agent.
Chargé automatiquement (EAGER) en début de session.

== Principes

|===
| EAGER | LAZY
| Tableau de bord | Manuel du propriétaire
| Chargé automatiquement | Chargé sur demande
| <= 100 lignes, <= 10k tokens | Illimité, détaillé
| Règles absolues, mission courante | Archives, historique, références
|===

== Politique de Chargement

|===
| Fichier | Type | Quand charger
| PROMPT_REPRISE.adoc | EAGER | Début session (auto)
| *_ESSENTIALS.adoc | EAGER | Début session si EPIC active
| .agents/INDEX.adoc | EAGER | Début session (auto)
| *_REFERENCE.adoc | LAZY | Sur besoin (détails architecture)
| .agents/sessions/N-*.adoc | LAZY | Sur demande (détails session)
| .agents/encyclopedies/*.adoc | COLD | Jamais auto (humain seulement)
|===

== Comment l'Agent Sait Quoi Charger

Début session → PROMPT_REPRISE + INDEX + ESSENTIALS actifs.
Besoin de détails → charger les *_REFERENCE et sessions/ en LAZY.
Connaissance froide → encyclopedies/, jamais automatique.

 287 AGENT.adoc
 627 AGENT_MODUS_OPERANDI.adoc
  51 PROMPT_REPRISE.adoc
 218 .agents/INDEX.adoc
  18 .agents/SESSIONS_HISTORY.adoc
 213 .agents/archives/COMPLETED_TASKS_ARCHIVE_2026-04.adoc
1414 total

 287 AGENT.adoc
  50 LAZY_EAGER_ESSENTIALS.adoc       ← remplace 627 lignes
  51 PROMPT_REPRISE.adoc
 218 .agents/INDEX.adoc
  18 .agents/SESSIONS_HISTORY.adoc
 213 .agents/archives/COMPLETED_TASKS_ARCHIVE_2026-04.adoc
 837 total                              ← -41%

@startuml
skinparam backgroundColor #FEFEFE

title Contexte EAGER après split encyclopédique — 837 lignes (-41%)

rectangle "AGENT.adoc\n287 lignes (34%)" as AG #BBDEFB
rectangle "INDEX.adoc\n218 lignes (26%)" as IDX #C8E6C9
rectangle "COMPLETED_TASKS\n213 lignes (25%)" as ARC #FFF9C4
rectangle "PROMPT_REPRISE\n51 lignes (6%)" as PRO #E1BEE7
rectangle "ESSENTIALS\n50 lignes (6%)" as ESS #A5D6A7
rectangle "SESSIONS_HISTORY\n18 lignes (2%)" as HIS #FFE0B2

note bottom of ESS
  De 627 → 50 lignes
  577 lignes d'ingénierie
  préservées en cold storage

  Rien de perdu. Tout de relocalisé.
end note

@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center
skinparam wrapWidth 220

title Trilogie de la Gouvernance Agent

left to right direction

package "📖 **Article 0108**\nStratégie Eager/Lazy" as A1 #E8F5E9 {
  card "Mémoire agent\nentre sessions" as M1
  card "Fichiers EAGER\n(auto-chargés)" as M2
  card "Fichiers LAZY\n(sur demande)" as M3
  card "Procédure 6 étapes" as M4
}

package "🧊 **Article 0110**\nMécanisme Hot/Warm/Cold" as A2 #FFF9C4 {
  card "Vieillissement\ndu contexte" as V1
  card "Sliding window\n10 sessions" as V2
  card "Vague froide\nidentique" as V3
  card "Capteur à\ndeux déclencheurs" as V4
}

package "🔍 **Article 0111**\nAudit + Solution Encyclopédique" as A3 #BBDEFB {
  card "Audit des fichiers\nEAGER" as E1
  card "Identification\ndu gaspillage" as E2
  card "Split\nESSENTIALS/encyclopédie" as E3
  card "Préservation\nde l'ingénierie" as E4
}

A1 --> A2 : "La mémoire grandit\n→ il faut un mécanisme\nde vieillissement"
A2 --> A3 : "Le vieillissement ne suffit pas\n→ il faut auditer ce qui\nmérite d'être en EAGER"

note bottom of A3
  ✅ Les trois couches sont en place
  sur 6 projets actifs
end note

@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center

title Procédure d'Audit du Contexte Agent — 5 Étapes

start

:1. **Mesurer**\n`wc -l *.adoc .agents/*.adoc`;

if (Total > 1000 lignes ?) then (oui)
  :⚠️ Contexte trop lourd;
else (non)
  :✅ Contexte OK;
  stop
endif

:2. **Identifier le suspect**\nLe fichier > 20% du total;

:3. **Auditer section par section**\nPour chaque section :\n• Déjà ailleurs ? → doublon\n• Jamais servi ? → mort\n• Information unique ? → critique;

:4. **Classifier**\n🟡 Doublons → à retirer de l'EAGER\n🔴 Jamais utilisé → cold storage\n🟢 Connaissance unique → à garder;

:5. **Splitter**\n🟢 → ESSENTIALS (~50 lignes, EAGER)\n🟡🔴 → encyclopedies/ (cold storage);

:✅ Contexte optimisé\nsans perte d'ingénierie;

stop

@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam nodeBackgroundColor #E3F2FD

title Défense en Profondeur contre la Saturation du Contexte

node "**Contexte Agent**\n~800 lignes\nsain" as CTX #C8E6C9

node "Couche 1\n**EAGER / LAZY**" as C1 #BBDEFB
node "Couche 2\n**HOT / WARM / COLD**" as C2 #BBDEFB
node "Couche 3\n**ESSENTIALS / ENCYCLOPÉDIE**" as C3 #BBDEFB

CTX --> C1 : "Structure par\n**disponibilité**"
CTX --> C2 : "Structure par\n**fraîcheur**"
CTX --> C3 : "Structure par\n**densité**"

note bottom of C3
  Les trois couches sont nécessaires.
  Aucune n'est suffisante seule.
end note

@enduml