Audit agenta konteksta : Kada vaša sopstvena upravljanje postane problem — i kako ga popraviti bez gubitka čegokoliv
Објављено 27 April 2026
- Сцена: сесиона 051, нешто не у реду
- Аудит: размотрисати 627 линија
- strah od gubljenja inženjerstva
- Решење: энциклопедијски split
- Sadržaj fajla ESSENTIALS
- Rezultat: -50% EAGER konteksta
- Zašto se direktorijum zove `encyclopedies/
- Logični nastavak serije
- Šta bih učinio drugačije
- Упутство за аудит вашег власног контекста
- Живо управљање
- Линкови
Prošli ste nedelje da izgradite bezgrešno upravljanje agentom. Eager/Lazy, procedura završetka sesije, rotativni backupi. Sistem radi. A onda jedan dan, agent postaje spor. Odgovori su razbačeni. Merenje: 1414 redova učitano automatski. I najgore je da krivac nije kod, ni backlog, ni arhiva sesija. Krivac je fajl koji dokumentuje vašu metodu.
- tik
-
[]
Сцена: сесиона 051, нешто не у реду
-
april 2026., 16:00. Ja sam u toku sesije na`magic-stick`, moj projekat izrade ISO Linux live. Agent Opencode je automatski učio moje fajlove Eager kao uvek —
AGENT.adoc,PROMPT_REPRISE.adoc,.agents/INDEX.adoc. Све је нормално.
Osim što su odgovori blagi. Agentu treba dve sekunde više za razmišljanje. Zaboravlja detalj koji je imao pred očima tri poruke ranije. Nije ni krak, ni greška — to je sporo pogoršanje, vrsta koju ne primetiš odmah.
Већ сам то већ преживео на сессии 048, кад сам открио да су датотеке управљања тежиле 5200 сабраних линије. Тогда сам концептуализовао механизам Hot/Warm/Cold са померајим прозором од 10 сесија, његовим идентичным хладним valовима, ињом сензором са два trigгера. Проблем је био решен. У теорији.
Aldo, mi smo na sesiji 051. Rotacija backup-a je bila uspešna — fajlovi EAGER su se smanjili sa 2087 na 500 linija. Ipak, kontekst ostaje teški. Nešto mi se uteklo.
Отварам терминал и упишем :
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
1414 linija. Rotacija backup-a je dobro obrisala u INDEX, SESSIONS_HISTORY i COMPLETED_TASKS — oni su čisti. Ali ima slona u sobi koje nisam video.627 linijau jednom fajlu.AGENT_MODUS_OPERANDI.adoc.
Ovaj fajl je onaj koji sam napisao na sesiji 1 da dokumentiram strategiju Eager/Lazy. To je priručnik metode. I postao je sam po sebi 44% EAGER konteksta.
@startuml skinparam backgroundColor #FEFEFE title Контекст EAGER — 1414 линија rectangle "AGENT_MODUS_OPERANDI **627 linija (44%)**" as MOD #FFCDD2 rectangle "AGENT.adoc\n287 linija (20%)" as AG #BBDEFB rectangle "INDEX.adoc 218 linija (15%)" as IDX #C8E6C9 rectangle "COMPLETED_TASKS\n213 linije (15%)" as ARC #FFF9C4 rectangle "PROMPT_REPRISE 51 linija (4%)" as PRO #E1BEE7 rectangle "SESSIONS_HISTORY 18 linija (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
Ironija je potpuna. Fajl koji je dizajniran da štedjeti kontekst postao je glavni potrošač konteksta. Je kao da je vodič za korišćenje vašeg automobila teži od motora.
Аудит: размотрисати 627 линија
Одлуčujem da uradim audit sekcija po sekcija. Ne radimo to radi brisanja — radi razumeti šta zaslužuje da bude u EAGER i šta bi moglo da živi negde drugo bez gubitka znanja.
Ovo je tačna struktura`AGENT_MODUS_OPERANDI.adoc`i što tam nalazim :
Sekcija |
Linije |
Sadržaj |
Већ присутан у… |
P1 — Преглед |
64 |
Rešen problem, osnovni principi, analoga tabla vs uputstvo |
— |
P2 — Struktura fajlova |
97 |
древо, политика загрузки, када учитати што |
— |
P3 — Apsolutna pravila |
34 |
Git zabranjen, destruktivne naredbe zabranjene, tajne zabranjene |
|
P4 — Животни циклус сесије |
133 |
Шаблон отварања, правила рада, 6 корака завршетка сесије, чек-листа |
|
P5 — Метрике и прагове |
49 |
Idealna sesija (15-30 min, 1-3 datoteke), znakovi upozorenja |
— |
P6 — Tipovi sesija |
72 |
Tabela detekcije, format predloga, izuzeci |
— |
P7 — непрестано унапређивање |
39 |
Metrike praćenja, nedeljni pregled |
— |
P8 — Checklist pokretanja |
13 |
Bootstrap novi projekat |
</think> (empty) |
P9 — Reference |
30 |
Referentne datoteke, eksterni resursi |
|
Prilogi A+B |
42 |
Речник, историја верзија |
</think> (output empty) |
Veredikt je bez odbora:
-
Potpuni duplikati(167 linija) : P3, P4, P9 — sve je već u`AGENT.adoc` ou
INDEX.adoc, češće riječ po rijeci -
Никогда није консулисано у пракси(215 linija) : P5, P6, P7, P8, Prilozi — od meta-upravljanja koji nikada nije koristilo u nijednoj sesiji
-
јединствено знање(161 linija) : P1 i P2 — LAZY/EAGER rečnik, analogija, politika učitavanja
Na 627 linija,382 је бута. Ove 382 linije se učitavaju na svakom početku sesije, potrošene od agenta, oslabaju njegovu pažnju pre nego što ja izgovorim zdravo.
@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center
title Audit AGENT_MODUS_OPERANDI.adoc — 627 linija
left to right direction
rectangle "🟡 **Duplikati**
167 linija (27%)" as DUP #FFF9C4 {
card "P3 — apsolutna pravila
(34 linija)" as D1
card "P4 — Životni ciklus
(133 linija)" as D2
card "P9 — Reference
(30 linija)" as D3
}
rectangle "🔴 **Није консулисано**\n215 линија (34%)" as JAM #FFCDD2 {
card "P5 — Metrike
(49 linija)" as J1
card "P6 — Детекција
(72 линија)" as J2
card "P7 — Unapređenje
(39 linija)" as J3
card "P8 — Bootstrap
(13 linija)" as J4
card "Прилог — Речник
(42 линија)" as J5
}
rectangle "🟢 **Jedinstveno poznanje**
161 linija (26%)" as UNI #C8E6C9 {
card "P1 — Pregled
(64 linija)" 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
Ovaj dijagram je ključ od svega. Duplikati (žuto) su čist šum — agenat ih čita dva puta, u dva različita fajla. Nikad nekonultisan (crveni) je mrtva dokumentacija — napisana s paznje, nikada neupotrebljena. Samo zeleno sadrži znanje koje agenat ne može da nađe drugde.
strah od gubljenja inženjerstva
У овом тренутку имам доказа у очама: мора да скратим.AGENT_MODUS_OPERANDI.adoc. Ali se okolebam.
Оvaj fajl, sam ga napisao rukom. Svaka sekcija je rezultat lekcije naučene u realnoj sesiji. Deo P3 je nastao od`rm -rf`случан на`bakery-plugin`Deo P4 je rezultat petnaest sesija u kojima sam zaboravio da arhiviram i gubio nit. Procedura u 6 koraka nije izišla iz knjige — nastala je iz boli.
Brisanje ovih sekcija bilo bi bacanje istorije moje sopstvene inženjerije. Lezioni koje su ih proizvele, sesije tokom kojih sam ih otkrio, greške koje više nikada ne želim da ponovim. Ovo nije tekst — ovo je kristalizovano iskustvo.
Ovo je mesto gde formulišem princip koji će voditi rešenje:
_ Никогда не бриши. Увек премести.Znanje ne mora da nestane iz projekta. Ono treba samo da se ne učitava automatski kada nije potrebno. _
Решење: энциклопедијски split
Model koji predlažem je jednostavan i inspirisan je načinom na koji je Wikipedija rasla: kada članak postane predugačak, ne se sekne — kreira se detaljniji članak i ostavlja se sažetak u glavnom članku.
за`AGENT_MODUS_OPERANDI.adoc`, то даје :
-
извлачити161 linija jedinstvenog znanja (P1 + P2) u novom fajlu`LAZY_EAGER_ESSENTIALS.adoc`— skompresovan na ~50 linija, strogo EAGER
-
Preimenuj
AGENT_MODUS_OPERANDI.adocen.agents/encyclopedies/LAZY_EAGER_ENCYCLOPEDIE.adoc— originalni fajl od 627 linija, sačuvan neporuđen, u hladnom skladiшту -
Nikad ne punitile fajl enciklopedije automatski — on je tu za čoveka, za buduću distilaciju, za agenta kojega ćemo pozvati za šest meseci sa boljim modelom
@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center
title Split enciklopedijski — AGENT_MODUS_OPERANDI
left to right direction
rectangle "**AGENT_MODUS_OPERANDI.adoc**
627 linija
(pre podjele)" as BEFORE #FFCDD2 {
}
rectangle " " as ARROW1
rectangle " " as ARROW2
rectangle "**LAZY_EAGER_ESSENTIALS.adoc**
**~50 linije — EAGER**" as ESS #C8E6C9 {
card "P1 kondenzovana
(15 linija)" as E1
card "P2 kondenzovana
(35 linija)" as E2
}
rectangle "**.agents/encyclopedies/**\n**LAZY_EAGER_ENCYCLOPEDIE.adoc**\n627 linija — COLD" as ENC #BBDEFB {
card "P1 u prilozima
(cio, neповреден)" 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
Ime`encyclopedies/`Не је беззначајно. Енциклопедија није архив — то је организована колекција знања, доступна али не преносима. Не чита се Универзалис енциклопедија у метро. Чувамо je у библиотеци, а идемо до ње када имамо конкретно питање.
Ovo je tačno uloga ovog direktorijuma: hladna referencijalna biblioteka, strukturalna i kompletna — kojeg agent ne dodiruje automatski.
Sadržaj fajla ESSENTIALS
Ово је како нови фајл zapravo изгледа.LAZY_EAGER_ESSENTIALS.adoc, izvučeno i kompaktovano iz P1 i P2 :
= 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.
Pedesaet linija. To je sve što agentu treba da razume mehaniku. Sve ostalo — istorija lekcija, detaljne analogije, korak po korak postupci, dodatci — živi u enciklopediji.
И најvažnije:Ništa nije obrisano.. 627 inženjerskih linija je uvek tu, u`.agents/encyclopedies/LAZY_EAGER_ENCYCLOPEDIE.adoc`. One su jednostavno smještene u biblioteci umesto na radnoj površini.
Rezultat: -50% EAGER konteksta
Пре раздвајања:
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 linija (34%)" as AG #BBDEFB rectangle "INDEX.adoc\n218 linija (26%)" as IDX #C8E6C9 rectangle "COMPLETED_TASKS 213 redova (25%)" as ARC #FFF9C4 rectangle "PROMPT_REPRISE 51 linija (6%)" as PRO #E1BEE7 rectangle "Osnovno 50 linija (6%)" as ESS #A5D6A7 rectangle "SESSIONS_HISTORY 18 linija (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
Najveći potrošač (AGENT_MODUS_OPERANDI, 627 linija) zamenjen je fajlom od 50 linija. Dobitak je odmah vidljiv: 577 linija konteksta oslobođene. Agent dishe.
И у`.agents/encyclopedies/`, originalni fajl od 627 linija čeka. Netaknut. Sve njegove sekcije — uključujući one koje su duplikati, uključujući one koje nikad nisu bile upotrebljene. Jer jednog dana, bolji model ili ljudski naučnik podataka želi da pređe kroz ove uglove, ove pretpostavljene redundancije, ove naučene lekcije. I tog dana, sirov materijal će biti tu.
Zašto se direktorijum zove `encyclopedies/
Izbor naziva nije kozmetički. On kodira filosofiju mehanizma.
Jedna arhiva (archives/) sadrži istorijske podatke organizovane kronološki — kao mesecni COMPLETED_TASKS. Jedno backup (backup/) je timestampovani snapshot — rezervna kopija prethodnog stanja.
Jedna enciklopedija, to je nešto drugo. To je kolekcija tematickog znanja, strukturirana po temama, iscrpna ali nelinearna. Ne čitamo enciklopediju od početka do kraja. Uražemo se u njoj da odgovorimo na konkretno pitanje.
Ово је уговор овог дела :
Dosije |
Uloga |
Pristup |
granularitet |
|
Историјски подаци (завршени задаци по месецу) |
LAZY, strukturovan |
Хронолошки |
|
Hladni snapshoti (valovi od 10 sesija) |
COLD, kompletna kopija |
хронолошки |
|
Potpuno tematsko znanje (metodologija, patterni) |
COLD, nikad auto |
Тематика |
Svaki fajl zna gde treba da živi prema ce qu’il contient, ne prema quand il a été créé.
Logični nastavak serije
Ako ste pročitali prva dva članka, ovde je kako se tri dela uklapaju:
@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center
skinparam wrapWidth 220
title Trilogija upravljanja agenta
left to right direction
package "📖 **Article 0108**\nStrategija Eager/Lazy" as A1 #E8F5E9 {
card "мемория агент
među сесије" as M1
card "Фајлови EAGER
(аутоматски учитан)" as M2
card "Fajlovi LAZY\n(na zahtev)" as M3
card "Postupak od 6 koraka" as M4
}
package "🧊 **Члан 0110**
Механизам Hot/Warm/Cold" as A2 #FFF9C4 {
card "Starenje
konteksta" as V1
card "Prozor klizanja
10 sesija" as V2
card "hladna vala
identična" as V3
card "Сензор са
два тригера" as V4
}
package "🔍 **Članak 0111**\nAudit + Enciklopedsko rešenje" as A3 #BBDEFB {
card "Аудит датотека\nEAGER" as E1
card "Identifikacija\notpada" as E2
card "Split\nESSENTIALS/енциклопедија" as E3
card "Сачување
инжењерства" as E4
}
A1 --> A2 : "Меморија растe
→ потребан је један механзам
старења"
A2 --> A3 : "Starenje nije dovoljno
→ treba proveriti šta
zaslužuje da bude u EAGER"
note bottom of A3
✅ Les trois couches sont en place
sur 6 projets actifs
end note
@enduml
-
0108 Одговара на : « Како дадите меморију агенту између два сеанса? »
-
0110одговор на : « Kako da sprečimo da ova memorija duši agenta?
-
0111Ako problem nije veličina arhiva, već što smo izabrali da stavimo u EAGER?
Prvi članak je izgrađivao strukturu. Drugi je dodao mehanizam staranja. Treći audituje sadržaj — i otkriva da je metodologija sama postala problema.
Šta bih učinio drugačije
U retrospektivi vidim početnu grešku u dizajnu.`AGENT_MODUS_OPERANDI.adoc`Bio je kreiran kao jedinstveni dokument — manifest. Bio je dobar pristup za formalizovanje misli. Ali jednom kada je misla formalizovana, dokument bi trebalo biti odmah podeljen: osnovni deo u EAGER-u, a kompletno u cold-u.
Nisam to uradio jer sam bio ponosan na dokument. 627 linija čiste inženjerije, napisane rukom, svaka sekcija plod lekcije sesije. To je bilo moje djelo. I kao svaki autor, teško mi je bilo da ga razdvojim.
Лекција :Nije zato što je dokument dobar da mora da se učita automatski.. Kvaliteta sadržaja nema veze sa relevance za trenutni kontekst agenta.
Dan sada, pravilo je jednostavno: svaki dokument sa više od 100 linija u kontekstu EAGER je sumnjiv. On zaslužuje audit. Ne osuda — audit. I pitanje nikada nije: « Da li ga treba obrisati? » već: « Da li ga treba učitati u svakoj sesiji?
Упутство за аудит вашег власног контекста
Ako ste pratili prva dva članka i postavili svoju vlastitu Eager/Lazy upravljanje, ovo je petkorakna procedura audita:
-
Meriti : `wc -l`na svim vašim EAGER fajlovima. Ukupan broj treba da bude ispod 1000 linija.
-
Identifikujte najveći: fajl koji čini više od 20% ukupnog je glavni suspect.
-
Auditi po sekcijama: za svaku sekciju pitajte se « Da li je ova informacija već negde? Da li je agent već pročitao u drugom fajlu? Da li je bila korisna u poslednjih pet sesija?
-
klasifikator: duplikat, nikad neupotrebljen, jedinstveno znanje.
-
Splitter ili premestiti: što je jedinstveno i kritično → ESSENTIALS kompaktovan. Sve ostalo →
encyclopedies/.
@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center title Procedura audita konteksta agenta — 5 koraka 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
Ova procedura traje 15 minuta. Na projektu od 50 sesija, ona štedi stotine tokena po buduće sesiji. ROI je odmah.
Живо управљање
Šta mi je naučila ova seria tri članka, jeste da agenti vladanje nije gotov proizvod. To ježivi organizam. Ona raste sa projektom. Ona doživljava bolei rastu. Ona zahteva regularne pregleda.
Sesija 048 je pokazala da se arhivi povećavaju. Sesija 051 je pokazala da se metodologija sama povećava. Sesija 060 će verovatno pokazati nešto drugo. To je normalno. To je zdravno. Uprava koja se nikada ne pitanje je mrtva uprava.
Tri mehanizma koji su postavljeni — Eager/Lazy, Hot/Warm/Cold, split enciklopedijski — formiraju sistem dubinske odbrane protiv preopterećenja konteksta. Nije jedan dovoljan sam po sebi. Uzajamno se dopunjuju:
-
Željan/Lijenstrukturiši informacije *po dostupnosti
-
vruć/topao/hladanstrukturiši informaciju po svežnosti
-
Enциклопедијски аудитstruktoriši informaciju po gustini
@startuml skinparam backgroundColor #FEFEFE skinparam nodeBackgroundColor #E3F2FD title Дубока одбрана против засићености контекста node "**Контекст агента** ~800 линија здрав" as CTX #C8E6C9 node "Слој 1 **EAGER / LAZY**" as C1 #BBDEFB node "Слој 2\n**HOT / WARM / COLD**" as C2 #BBDEFB node "Слој 3\n**ОСНОВНО / ЕНЦИКЛОПЕДИЈА**" as C3 #BBDEFB CTX --> C1 : "Структура по\n**доступност**" CTX --> C2 : "Struktura po\n**svežini**" CTX --> C3 : "Struktura po **gustini**" note bottom of C3 Les trois couches sont nécessaires. Aucune n'est suffisante seule. end note @enduml
Са овим три слоја, контекст агента на`magic-stick`je presao sa 2087 linija (pre nego bilo kakve optimizacije) na oko 800 linija — podeljeno sa 2,6. Nije se izgubio ni jedan red dokumentacije, ni jedna sesijska arhiva, ni jedna naučena lekcija.
Sve je tamo. Jednostavno bolje uređeno.
Линкови
-
Член 0108 — Eager/Lazy стратегија:Upravljati Agentom AI pomoću AsciiDoc
-
Член 0110 — механизам Hot/Warm/Cold :Sliding Window i hladna vala
-
Мој сајт : https://cheroliv.com
-
Пројекат`magic-stick`: https://github.com/cheroliv/magic-stick
Znanje ne mora da nestane. Ono treba samo da ne bude učitano kada nije potrebno.