Lekce 05.2: Řízení pomocí ukazatelů (Steering With A Pointer)

⏱️ 3 min čtení • Lekce 05.2

🧠 Mentální model & teoretický rozbor

Jedna z nejčastějších chyb při práci s kontextem je snaha vložit celou znalostní bázi projektu do hlavního instrukčního souboru. Řešením je Technika ukazatelů (Pointers) založená na principu Progresivního odhalování (Progressive Disclosure):

ŠPATNĚ (Monolitický soubor):
AGENTS.md / CLAUDE.md (800 řádků):
├── Pravidla pro CSS (150 řádků)
├── Pravidla pro SQL a DB (250 řádků)  <── Čte se VŽDY, i když upravujete jen tlačítko!
└── Pravidla pro Docker (200 řádků)

SPRÁVNĚ (Řízení pomocí ukazatelů):
AGENTS.md / CLAUDE.md (25 řádků):
├── CSS pravidla: viz pointer `docs/css-rules.md`
├── Databáze: viz pointer `docs/db-rules.md`   <── Načte se POUZE při práci s DB!
└── Docker: viz pointer `docs/docker-rules.md`

Model si specializovanou dokumentaci otevře přes čtecí nástroje (view_file v Antigravity nebo ViewFile v Claude Code) teprve tehdy, když to úkol vyžaduje. Váš výchozí kontext zůstává ultralehký!

🏢 Realistický scénář z praxe

Vývojář upravuje barevnou paletu v Tailwind CSS:

Při monolitickém konfiguračním souboru má model v kontextu 250 řádků pravidel pro PostgreSQL migrace a indexaci.
Při použití pointerů má model v kontextu pouze 25 řádků. Přečte si pointer na CSS dokumentaci, otevře docs/css-rules.md a provede změnu s 90% úsporou tokenů.

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

Praktický příklad ukazatelů v `AGENTS.md` (nebo `CLAUDE.md`):

## Dokumentační ukazatele (Pointers)
Před zahájením práce v příslušné oblasti si VŽDY prostuduj dedikovaný dokument:
- **Práce s databází a migrace**: `docs/database.md`
- **Tvorba a stylování UI komponent**: `docs/design-system.md`
- **Bezpečnost a autorizace API**: `docs/security.md`
- **Postup psaní integračních testů**: `docs/testing.md`

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

Chyba: Ukazatel bez konkrétní cesty k souboru

Napsat: „Pravidla pro databázi najdeš v dokumentaci.“

Agent neví, kde přesně dokumentace leží, a začne rekurzivně prohledávat celý disk.
Pravidlo: Ukazatel musí vždy obsahovat přesnou relativní cestu k souboru (např. docs/database.md).

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

Projděte svůj AGENTS.md / CLAUDE.md a vyhledejte bloky delší než 15 řádků věnované jedné konkrétní doméně.
Vyjměte tento blok a uložte ho do docs/[domena].md.
Do kořenového souboru vložte jednořádkový ukazatel s cestou k novému souboru.

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

Úkol:

Převeďte část svých instrukcí na techniku ukazatelů.

Kroky:

Vytvořte soubor docs/testing-guidelines.md s popisem, jak v projektu spouštět a psát testy (např. Vitest s in-memory SQLite).
Vložte do AGENTS.md (nebo CLAUDE.md) odkaz: - Testování: Prostuduj pravidla v docs/testing-guidelines.md.
Spusťte agy (nebo claude) a zadejte: „Napiš nový test pro auth.“ Sledujte, jak si model nejprve sám otevře odkazovaný dokument!