Lekce 04.3: Zobrazení a diagnostika kontextu (Showing Context and Budget)

⏱️ 3 min čtení • Lekce 04.3

🧠 Mentální model & teoretický rozbor

V pilotní kabině letadla nespoléhá pilot na odhad výšky – sleduje výškoměr. Při řízení AI agenta je vaším výškoměrem indikátor zaplnění kontextového okna a rozpočet Smart Zone:

STAVOVÝ ŘÁDEK A ROZPOČET KONTEXTU:
[████████░░░░░░░░░░░░░░░░░░░░░░] 28 % (56k tokenů) -> SMART ZONE 🟢 (Plné IQ, blesková odezva)
[████████████████████░░░░░░░░░░] 68 % (136k tokenů) -> DUMB ZONE 🔴 (Pozornost roztříštěna)

Pokud nevíte, kolik tokenů zbývá do konce Smart Zone, řídíte projekt poslepu. Moderní harnessy umožňují přesně diagnostikovat, co v kontextu zabírá místo.

🏢 Realistický scénář z praxe

Inženýr má rozpracovaný složitý platební proces. Před zadáním finálního refaktoringu zkontroluje stav kontextu:

V sezení je již akumulováno přes 60 000 tokenů z výpisů selhávajících testů.
Místo toho, aby zadal těžký refaktor do vyčerpaného sezení, zastaví se.
Provede Handoff: nechá agenta shrnout rozpracovaný stav do HANDOFF.md, zadá /clear a v čerstvém sezení (stav 4 %) dokončí refaktor s maximální bystrostí modelu.

💻 Diagnostické příkazy v praxi

1. Diagnostika v Antigravity CLI (`agy`):

V Antigravity CLI vidíte spotřebu tokenů a stav kontextu po každém kroku. Detailní rozpis naleznete také v logu sezení.

2. Diagnostika v Claude Code:

Příkaz /context (grafický rozpad kontextu): Zobrazí přesný procentuální a tokenový rozpad:
- Kolik zabírá systémový prompt a pravidla CLAUDE.md.
- Kolik zabírají definice systémových nástrojů.
- Kolik zabírají přečtené soubory v paměti.
- Kolik zabírá dosavadní historie zpráv.

Příkaz /cost (finanční a tokenová statistika):

> /cost
Total cost: $0.05
Input tokens: 24,100
Cached tokens: 21,500
Output tokens: 740

⚠️ Analýza selhání & Anti-patterns

Chyba: Ignorování varovných příznaků a práce až do vyčerpání

Když necháte sezení přetéct hluboko do Dumb Zone:

Model začne svévolně zkracovat kód.
Místo kompletní komponenty vygeneruje jen torzo s komentářem // zbytek doplňte sami.
Každý tah trvá 3x déle kvůli vysoké latenci zpracování velkého kontextu.

🛠️ Inženýrský postup krok za krokem (Playbook)

Vytvořte si inženýrský reflex: Před zahájením dalšího netriviálního úkolu zkontrolujte stav kontextu (/context nebo stavový řádek).
Hranice 40 % (nebo 60k tokenů): Jakmile se k ní blížíte, naplánujte nejbližší commit a /clear.
Nikdy nezačínejte novou funkci v zaneseném sezení.

🧪 Praktické cvičení (Hands-on Lab)

Úkol:

Zmapujte si rychlost spotřeby tokenů v reálném sezení.

Kroky:

Spusťte agy (nebo claude).
Nechte agenta přečíst 2 soubory v repozitáři.
V Claude Code zadejte /context a prozkoumejte, jak se přečtené soubory promítly do rozpadu okna.
Zadejte /clear a ověřte, že kontext klesl na čistou výchozí hodnotu.