에이전트 컨텍스트 감사: 당신의 자체 거버넌스가 문제가 될 때 — 그리고 아무것도 잃지 않고 이를 복구하는 방법

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 컨텍스트 EAGER — 1414줄
rectangle "AGENT_MODUS_OPERANDI
**627줄 (44%)**" as MOD #FFCDD2
rectangle "AGENT.adoc\n287 줄 (20%)" as AG #BBDEFB
rectangle "INDEX.adoc
218줄 (15%)" as IDX #C8E6C9
rectangle "COMPLETED_TASKS\n213 줄 (15%)" as ARC #FFF9C4
rectangle "PROMPT_재개
51줄 (4%)" as PRO #E1BEE7
rectangle "SESSIONS_HISTORY
18 줄 (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 AGENT_MODUS_OPERANDI.adoc 감사 — 627 줄
left to right direction

rectangle "🟡 **중복**\n167줄 (27%)" as DUP #FFF9C4 {
  card "P3 — 절대 규칙
(34 줄)" as D1
  card "P4 — 생명 주기
(133 줄)" as D2
  card "P9―참고문헌
(30줄)" as D3
}

rectangle "🔴 **절대 확인되지 않음**
215줄 (34%)" as JAM #FFCDD2 {
  card "P5 — 메트릭
(49 줄)" as J1
  card "P6 — 탐지
(72줄)" as J2
  card "P7 — 개선
(39줄)" as J3
  card "P8 — Bootstrap
(13줄)" as J4
  card "부록 — 용어집
(42 줄)" as J5
}

rectangle "🟢 **유일한 지식**
161줄 (26%)" as UNI #C8E6C9 {
  card "P1 — 개요
(64줄)" as U1
  card "P2 — 파일 구조
(97 줄)" 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 분할된 백과사전 — AGENT_MODUS_OPERANDI
left to right direction

rectangle "**AGENT_MODUS_OPERANDI.adoc**
627줄
(분할 전)" as BEFORE #FFCDD2 {
}

rectangle " " as ARROW1
rectangle " " as ARROW2

rectangle "**LAZY_EAGER_ESSENTIALS.adoc**\n**~50줄 — EAGER**" as ESS #C8E6C9 {
  card "P1 압축된
(15줄)" as E1
  card "P2 압축된
(35줄)" as E2
}

rectangle ".agents/encyclopedies/**
**LAZY_EAGER_ENCYCLOPEDIE.adoc**
627줄 — COLD" as ENC #BBDEFB {
  card "P1부터 부록까지
(완전하고 손상되지 않은)" as C1
}

BEFORE -[#4CAF50]-> ESS : "추출의
비판적 지식"
BEFORE -[#2196F3]-> ENC : "완전한 보존
공학의"

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 백과사전 분할 이후 EAGER 컨텍스트 — 837줄 (-41%)
rectangle "AGENT.adoc\n287줄 (34%)" as AG #BBDEFB
rectangle "INDEX.adoc
218 줄 (26%)" as IDX #C8E6C9
rectangle "COMPLETED_TASKS\n213 줄 (25%)" as ARC #FFF9C4
rectangle "PROMPT_REPRISE
51줄 (6%)" as PRO #E1BEE7
rectangle "필수
50줄 (6%)" as ESS #A5D6A7
rectangle "SESSIONS_HISTORY\n18 줄 (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 에이전트 거버넌스 삼부작
left to right direction

package "📖 **Article 0108**
전략 Eager/Lazy" as A1 #E8F5E9 {
  card "메모리 에이전트
세션 간" as M1
  card "EAGER 파일
(자동 로드됨)" as M2
  card "LAZY 파일
(요청 시)" as M3
  card "6단계 절차" as M4
}

package "🧊 **Article 0110**
핫/웜/콜드 메커니즘" as A2 #FFF9C4 {
  card "노화
컨텍스트의" as V1
  card "슬라이딩 윈도우
10 세션" as V2
  card "차가운 파도
동일한" as V3
  card "센서와\n두 개의 트리거" as V4
}

package "🔍 **Article 0111**
감사 + 백과사전 솔루션" as A3 #BBDEFB {
  card "파일 감사
EAGER" as E1
  card "식별
폐기물" as E2
  card "Split
필수/백과사전" as E3
  card "엔지니어링
보존" as E4
}

A1 --> A2 : "메모리가 커집니다 → 노화 메커니즘이 필요합니다"
A2 --> A3 : "노화만으로는 부족합니다
→ 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 에이전트 컨텍스트 감사 절차 — 5단계
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 컨텍스트 포화에 대한 깊이 있는 방어
node "**컨텍스트 에이전트**
~800 줄
건전한" as CTX #C8E6C9

node "층 1
**EAGER / LAZY**" as C1 #BBDEFB
node "레이어 2
**더운 / 따뜻한 / 추운**" as C2 #BBDEFB
node "3층
**필수 / 백과사전**" as C3 #BBDEFB

CTX --> C1 : "구조별\n**가용성**"
CTX --> C2 : "구조는
**신선함**"
CTX --> C3 : "구조에 따른\n**밀도**"

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

@enduml