コンテキストエージェントの監査 : 自分のガバナンスが問題になるとき — そして何も失わずにそれを修正する方法

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
287 行 (20%)" as AG #BBDEFB
rectangle "INDEX.adoc
218行 (15%)" as IDX #C8E6C9
rectangle "COMPLETED_TASKS
213 行 (15%)" as ARC #FFF9C4
rectangle "PROMPT_REPRISE
51 行 (4%)" as PRO #E1BEE7
rectangle "SESSIONS_HISTORY\n18行(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 "�🟡 **重複**
167 行 (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 — 検出\n(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**
**~50 行 — EAGER**" as ESS #C8E6C9 {
  card "P1凝縮
(15行)" as E1
  card "P2凝縮版\n(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
287行(34%)" as AG #BBDEFB
rectangle "INDEX.adoc
218行 (26%)" as IDX #C8E6C9
rectangle "COMPLETED_TASKS
213 行 (25%)" as ARC #FFF9C4
rectangle "PROMPT_REPRISE
51 行 (6%)" as PRO #E1BEE7
rectangle "ESSENTIALS
50 行 (6%)" as ESS #A5D6A7
rectangle "SESSIONS_HISTORY
18 行 (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 "二つのトリガーを備えたセンサー" as V4
}

package "�🔍 **Article 0111**\n監査 + 百科事典ソリューション" as A3 #BBDEFB {
  card "ファイルの監査
EAGER" as E1
  card "特定
廃棄物" as E2
  card "Split
ESSENTIALS/百科事典" as E3
  card "保存
エンジニアリングの" as E4
}

A1 --> A2 : "メモリは増大する\n→ 経年劣化のメカニズムが必要"
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\n**EAGER / LAZY**" as C1 #BBDEFB
node "�層2
**ホット / ウォーム / コールド**" as C2 #BBDEFB
node "層 3
**基本 / 百科事典**" as C3 #BBDEFB

CTX --> C1 : "構造による\n**可用性**"
CTX --> C2 : "構造による\n**新鮮さ**"
CTX --> C3 : "構造による
**密度**"

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

@enduml