--- title: Knižnica za agentom type: deep-dive level: L2 status: live revision: 1 updated: 2026-08-17 systemVersion: 4.2 authoring: machine-translated tags: [architecture, library, decision-making, deep-dive] rating: 7.95 ratingAxes: useful 8 · evidence 9 · pull 7 · original 8 · form 7 ratingKind: derived source: library_citations.log (144 entries) + library_lookup.py + doctrine history --- # Knižnica za agentom _Written 2026-08-17 · last verified 2026-08-17 · system v4.2 · live_ **TL;DR** — Agent si vedie knižnicu 123 skutočných kníh a 4 periodík, ktoré sa vyhľadávajú pomocou váženého kľúčového indexu namiesto embeddingov. Záznam citácií so 144 skutočnými položkami ukazuje, že približne 84 % konzultácií zmenilo spôsob, akým sa úloha skutočne vykonala; zvyšok sa zaznamenáva ako ignorovaný, nie sa maže. Systém prešiel jedným skutočným zlyhaním — vyhľadávací nástroj dosahoval 93 % úspešnosť pri dvojslovných dopytoch a 37 % pri prirodzených vetách — a jednou skutočnou zmenou doktríny, potom čo prvá verzia optimalizovala na frekvenciu citácií a vyprodukovala presne tie ozdobné citácie, ktorým mala zabrániť. ## Čo to je 123 kníh a 4 periodiká, usporiadané do 19 klastrov — stratégia, cenotvorba, dodávateľský reťazec, vyjednávanie, dátová analytika a podobne. Každá kniha, ktorá sa počíta ako „súčasť knižnice", má tri veci: plný text vo formáte markdown, jednostránkový prehľad (brief) a spúšťaciu kartu (trigger card) s kľúčovými slovami, mentálnymi modelmi a jedným riadkom o tom, kedy sa dá použiť. PDF ležiace na disku bez týchto troch vecí nie je súčasťou knižnice — vyhľadávací nástroj ho nenájde, a pre tento systém to znamená, že neexistuje. ## Ako funguje vyhľadávanie Žiadna vektorová databáza, žiadne embeddingy, žiadne vyhľadávanie podobnosti. Kľúčový index nad spúšťacími kartami, s váhami — spúšťacie frázy a názov majú váhu 3x, mentálne modely a jednoriadkový popis majú váhu 2x, názov klastra má váhu 1x. Dopyt typu *„ako mám postaviť zvýšenie ceny bez toho, aby som prišiel o zákazníka"* sa tokenizuje, porovná sa so všetkými 127 kartami a vráti sa top 3. Dôvod je rovnaký, aký stojí za pamäťovou vrstvou tohto systému vo všeobecnosti: vyhľadávanie nikdy nebolo tým zaujímavým problémom. Zaujímavé bolo vedieť, ktorý framework sa naozaj *hodí*. Vektorové vyhľadávanie vráti najbližšiu zhodu; nemá žiadny názor na to, či je táto zhoda len ozdoba, alebo skutočne sedí na danú situáciu. Toto rozhodnutie — **brána zhody frameworku (Framework-Fit Gate)** — prebieha až po vyhľadaní, nie namiesto neho: pred aplikáciou metódy z knihy sa overí, či kontext skutočne zodpovedá predpokladom danej knihy. Slepé použitie dobrého frameworku na nesprávnu situáciu je horšie zlyhanie než nepoužiť žiadny framework. ## Číslo, na ktorom záležalo: nie citácie, ale zmeny metódy Prvá verzia tohto systému merala, ako často bola kniha citovaná za jednu session, a stanovila spodnú hranicu — približne jednu citáciu na jednu obchodnú konverzáciu. Výsledok bol presne taký, aký by ste čakali od optimalizácie zástupnej metriky (proxy metric): knihy sa citovali na konci odpovede, ktorá už bola rozhodnutá úplne inak. Ozdobná citácia. Riešením nebola lepšia spodná hranica. Bola to zmena toho, čo sa zaznamenáva. Každá konzultácia teraz zaznamenáva jeden zo štyroch výsledkov — `accepted`, `rejected`, `ignored`, `tbd` — a úprimná odpoveď je plnohodnotný výsledok, nie zlyhanie, ktoré treba potlačiť: ``` 2026-08-14 | Reconciling supplier invoicing — mapped clusters, but the task was pure numeric reconciliation | none — hook fired, book not used | ignored ``` Zo 144 zaznamenaných konzultácií sa približne **84 % skončilo `accepted`** — kniha zmenila metódu, postupnosť krokov alebo rozhodovacie pravidlo, nielen znenie odpovede. Zvyšok sa uchováva, nie maže. Záznam citácií, ktorý zaznamenáva iba úspechy, meria vlastnú sebadôveru, nie vlastnú presnosť. ## Čo sa skutočne cituje a ako často Najčastejšie konzultované knihy podľa počtu záznamov: Cialdini – *Influence* (7), Muller – *Essentials of Inventory Management* (6), Baker/Marn/Zawada – *The Price Advantage* (5), Hormozi – *$100M Offers* (5), Simon – *Confessions of the Pricing Man* (5), O'Brien – *Supplier Relationship Management* (4), Voss – *Never Split the Difference* (3), Knaflic – *Storytelling with Data* (3), Meadows – *Thinking in Systems* (3), Lewis – *Moneyball* (3). Tam, kde bolo zaznamenané skóre prekvapenia — teda o koľko framework zmenil odpoveď oproti tomu, čo by sa stalo bez neho, na škále 1 – 5 — priemer za 63 hodnotených záznamov je **2,97**. Nie každá konzultácia je zjavením; väčšina je prípad, keď framework potvrdí a zaostrí smer, ktorý bol už zhruba správny. Log si uchováva aj tieto prípady, pretože framework, ktorý si svoje miesto zaslúži iba na dramatických prípadoch, sa v skutočnosti nepoužíva ako doktrína. ## Čo sa pokazilo Prvá verzia vyhľadávacieho nástroja fungovala dobre na dopytoch, na ktorých bola testovaná — dve alebo tri kľúčové slová, presné výrazy — a zle na dopytoch, ktoré v skutočnosti dostáva, teda na celých vetách. Interný audit zistil **93 % presnosť top-3 pri presných krátkych dopytoch a 37 % pri dopytoch v prirodzenom jazyku** — rozdiel medzi demom a produkciou. Dve príčiny, obe mechanické. Po prvé, chýbal zoznam stop slov (stopword list): krátke výplňové slová v jazyku dopytu sa zhodovali ako podreťazce vo vnútri nesúvisiacich slov — trojpísmenové funkčné slovo sa objavilo vložené v nesúvisiacom osempísmenovom výraze a natiahlo nesprávnu kartu. Kniha so širokou, všeobecnou spúšťacou kartou porazila knihu s presnou, doslovnou zhodou na skutočnú tému, čisto preto, že široká karta nazbierala viac zhôd podreťazcov. Po druhé, chýbalo ošetrenie skloňovania slov: množné číslo alebo skloňovaný tvar hľadaného výrazu sa nezhodoval so základným tvarom v jednotnom čísle uloženým v spúšťacej karte, čo výrazne potápa vyhľadávanie v každom jazyku s bohatou morfológiou. Riešením bol zoznam stop slov, zhoda založená na prefixe na hranici slova a požiadavka, aby časť skóre zhody pochádzala z polí s vysokou výpovednou hodnotou — spúšťacie frázy, názov, mentálne modely — namiesto toho, aby slabá zhoda v poli s nízkou výpovednou hodnotou vyhrávala len na základe objemu. Regresný test teraz beží pred každou zmenou v logike hodnotenia (ranking) a zablokuje ju, ak presnosť pri presných zhodách klesne alebo ak sa presnosť pri prirodzenom jazyku nezlepší. Toto ponaučenie presahuje rámec jedného nástroja: vyhľadávací systém testovaný iba na tvare dopytu, aký by ste napísali ručne, potichu zlyhá na tvare dopytu, aký v skutočnosti produkuje reálna konverzácia. ## Aj obstarávanie má svoj filter Nie každá kniha, ktorá vyzerá relevantne, sa aj pridá. Jeden opakujúci sa signál: prefix ISBN. Prefix `979-8` označuje samovydávanie cez Amazon KDP — prideľuje sa každému, kto nahrá súbor, nie je to signál redakčného preverenia. Dávkové hodnotenie kandidátskych titulov v jednej rýchlo sa meniacej technickej kategórii zistilo, že 9 z 11 kandidátov malo tento prefix, a verdikt o jednom konkrétnom titule sa obrátil po tom, čo bol prefix overený voči skutočnému vydavateľovi. Druhým filtrom je polčas rozpadu (half-life): kniha, ktorá učí syntax, má životnosť na mesiace; kniha, ktorá učí metódu, prežije aj zmenu nástrojov pod ňou. Knižnica nakupuje pre ten druhý typ. ## Od prehľadu k playbooku Jednostránkový prehľad (brief) stačí na rozhodnutie, či sa kniha dá použiť. Nestačí však na to, aby sa jej metóda skutočne vykonala pod tlakom — brief hovorí, *čo* kniha tvrdí, nie rozhodovacie pravidlá a poradie krokov, ktoré potrebujete uprostred konverzácie. Desať kníh postúpilo k druhému artefaktu: playbooku. Nie je to zhrnutie, ale vykonateľná postupnosť — kedy ho aktivovať, aké vstupy potrebuje, postup s vypísanými rozhodovacími pravidlami, aká stopa vo finálnom výstupe dokazuje, že metóda bola skutočne dodržaná, a kde je v konflikte s odporúčaním inej knihy, keď by dva frameworky ukazovali odlišným smerom. Povýšenie na playbook je zámerne líne: kniha si ho zaslúži až po tom, čo bola skutočne použitá, dvakrát, pri dvoch samostatných príležitostiach — nie na základe toho, aká dobrá sa zdá byť pri prvom prečítaní. Napísať vykonateľnú verziu skôr, než framework preukázal svoju hodnotu v praxi, by znamenalo zakódovať neoverené úsudky ako postup, čo je drahšia chyba než nechať dobrú knihu o niečo dlhšie, než je nutné, vo fáze briefu. Delegovaná práca (pozri **[Twelve Agents, One Memory](/architecture/twelve-agents-one-memory)**) posúva toto ešte ďalej: sub-agent, ktorý rieši otázku z danej oblasti, dostane riadok s názvom jednej až troch kníh relevantných pre jeho úlohu, a od jeho výstupu sa očakáva, že preukáže aplikovanú metódu danej knihy, nie len spomenutie jej názvu. Je to rovnaké rozlíšenie, aké zabilo spodnú hranicu frekvencie citácií — *citovať* zdroj a *riadiť sa* ním sú dve odlišné správania a len jedno z nich mení to, čo sa skutočne stane ďalej. ## Kam to smeruje Pokrytie briefmi je na 100 % zo 123 kníh — každý titul, ktorý sa dostal do knižnice, má všetky tri artefakty, od ktorých vyhľadávanie závisí. Čo ešte nie je hotové: systematické preverenie toho, či filter na základe prefixu ISBN niekedy vyprodukoval falošne negatívny výsledok — teda legitímne dobrú knihu zamietnutú len na základe prefixu — pretože filter bol doteraz testovaný iba na falošne pozitívne výsledky.