Lekce 05.7: Prořezávání (Pruning) (Pruning)

⏱️ 3 min čtení • Lekce 05.7

🧠 Mentální model & teoretický rozbor

Jedna z nejnebezpečnějších vývojářských patologií je Hromadění instrukcí (Instruction Creep): Pokaždé, když agent udělá drobnou chybu, vývojář přispěchá a přidá do AGENTS.md (nebo CLAUDE.md) nový řádek: „Vždy dávej středník! Nikdy nepoužívej lodash! Importuj z @/! Nezapomeň na alt u obrázků!“

ZÁKON PROŘEZÁVÁNÍ (THE PRUNING LAW):
Více pravidel ≠ Lepší kód.
Více pravidel = Přetížená pozornost modelu = Horší kód!

Pravidla pro efektivní instrukce:

Pokud model chybu sám od sebe nedělá, nepište pro ni pravidlo.
Pokud lze pravidlo vynutit linterem nebo kompilátorem, nepatří do instrukcí agenta!

🏢 Realistický scénář z praxe

Firma měla soubor instrukcí o délce 650 řádků: Model neustále ignoroval pravidla pro databáze. Seniorní inženýr provedl radikální prořezání (Pruning):

Smazal 500 řádků stylistických doporučení a svěřil je Biome linteru.
Smazal 100 řádků duplicitní dokumentace a nahradil je ukazateli.
Zůstalo 35 úderných řádků.
Spolehlivost modelu okamžitě vzrostla o 40 %, protože podstatná pravidla už nebyla utopena v balastu.

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

Srovnání před a po prořezání:

❌ Před prořezáním (Přeplněný balast v AGENTS.md / CLAUDE.md):

- Vždy používej jednoduché uvozovky v TypeScriptu.
- Před otevírací závorkou piš mezeru.
- Maximální délka řádku je 100 znaků.
- Všechny importy seřaď abecedně.
- Nepoužívej var, ale const nebo let.

(Zbytečné! Tohle všechno vyřeší jeden příkaz linteru za 50 ms).

✅ Po prořezání (Čisté inženýrské mantinely):

- Veškeré formátování kódu řeší automaticky: `npx biome check --write src/`.
- Před commitem spusť: `pnpm vitest run && pnpm tsc --noEmit`.

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

Chyba: Řešení každé náhodné anomálie novým pravidlem

Model jednou v pátek odpoledne použil podivný název proměnné. Vývojář okamžitě napíše zákaz do konfiguračního souboru. Za půl roku je soubor plný obskurních zákazů věcí, které se staly jednou v životě.

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

Otevřete AGENTS.md (nebo CLAUDE.md).
Projděte každé pravidlo a položte si otázku: „Dokáže toto zkontrolovat kompilátor nebo linter?“
- ANO ➔ Smazat ze souboru a nastavit linter.
„Dělá model tuto chybu opakovaně, pokud pravidlo smažu?“
- NE ➔ Smazat.
Udržujte soubor pod 50 řádky.

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

Úkol:

Proveďte prořezávací audit vašeho souboru AGENTS.md / CLAUDE.md a zredukujte jeho délku na polovinu.

Kroky:

Otevřete stávající instrukční soubor.
Odstraňte linterová pravidla a převeďte doménové bloky na ukazatele (docs/).
Spusťte agy (nebo claude) a ověřte přesnost odpovědí v odlehčeném kontextu.