Lekce 04.1: Váš výchozí kontext (Your Starting Context)

⏱️ 3 min čtení • Lekce 04.1

🧠 Mentální model & teoretický rozbor

Když otevřete čerstvé sezení v terminálu, máte pocit, že začínáte s čistým listem papíru. Ve skutečnosti je vaše kontextové okno již znatelně zaplněno:

ANATOMIE VÝCHOZÍHO KONTEXTU (Před prvním písmenem):
┌─────────────────────────────────────────────────────────────┐
│ 1. Systémový prompt Anthropicu (~3 000 – 5 000 tokenů)      │
│    Základní identita, instrukce pro kódování a bezpečnost.   │
├─────────────────────────────────────────────────────────────┤
│ 2. Schémata nástrojů / Tools (~2 000 – 4 000 tokenů)        │
│    Kompletní JSON specifikace pro Bash, ViewFile, EditFile. │
├─────────────────────────────────────────────────────────────┤
│ 3. Instrukce repozitáře (CLAUDE.md / AGENTS.md)            │
│    Může mít 500 tokenů (skvělé) až 30 000 tokenů (katastrofa)│
├─────────────────────────────────────────────────────────────┤
│ 4. Git kontext (~200 – 1 000 tokenů)                        │
│    Název větve, stav indexu, základní info o repu.          │
└─────────────────────────────────────────────────────────────┘
CELKEM VÝCHOZÍ ZÁTĚŽ: 6 000 až 40 000+ tokenů!

Pokud je váš konfigurační soubor neúměrně dlouhý, ukousne podstatnou část z vaší Smart Zone ještě dříve, než agentovi zadáte první úkol.

🏢 Realistický scénář z praxe

Vývojář si do kořenového CLAUDE.md zkopíroval celou dokumentaci knihovny Tailwind CSS, kompletní schéma databáze a firemní kodex na 800 řádků.

Výchozí kontext při každém spuštění: 38 000 tokenů.
Protože hranice Smart Zone je kolem 60 000–80 000 tokenů, zbývá mu pouhých 25 000 tokenů na samotnou práci!
Po otevření dvou větších souborů se model okamžitě propadne do Dumb Zone.

💻 Konkrétní ukázky kódu & promptů

Ukázka ideálního, štíhlého kořenového `CLAUDE.md` (cca 300 tokenů):

# Projekt: E-Commerce Storefront (Next.js 15, React 19, TypeScript)

## Klíčové příkazy
- Vývoj: `pnpm dev` (spouští vývojář mimo sezení)
- Testy: `pnpm vitest run <cesta_k_testu>`
- Typová kontrola: `pnpm tsc --noEmit`
- Linter a formátování: `pnpm biome check --write src/`

## Pravidla architektury
- Byznys logika žije v `src/server/services/`, nikdy ne v komponentách.
- Všechny databázové dotazy jdou přes Drizzle ORM v `src/server/db/`.
- Podrobná pravidla pro databázi viz pointer: `docs/database.md`.

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

Anti-pattern: Vkládání proměnlivého stavu do systémových instrukcí

Některé skripty automaticky generují do CLAUDE.md kompletní výpis git log nebo stav všech otevřených ticketů.

To způsobuje neustálou neplatnost mezipaměti (Prompt Cache Miss).
Každý příkaz se prodraží a kontext se plní zastaralými informacemi.

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

Změřte výchozí stav: Otevřete čerstvé sezení a ihned zadejte /cost.
Optimalizujte CLAUDE.md: Udržujte kořenový soubor pod 50 řádků.
Přeneste detaily do pointerů: Všechny specializované návody přesuňte do samostatných markdown souborů ve složce docs/.

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

Úkol:

Změřte přesnou velikost výchozího kontextu ve vašem projektu.

Kroky:

Spusťte claude a ihned napište /cost. Poznamenejte si číslo Base Input Tokens.
Přidejte do CLAUDE.md 100 řádků fiktivního textu.
Zadejte /clear, znovu napište /cost a sledujte, o kolik tokenů se výchozí zátěž zvětšila.