CLAUDE.md po Opus 5: Proč dlouhé pokyny Claudeovi nyní překážejí

Informace o práci s Ailootem najdete v dokumentaci.

Co se změnilo po vydání Claude Opus 5?#

Opus 5 vyšel 24. července 2026 a okamžitě se stal výchozím modelem v Claude Code. Samotnému modelu — jeho ceně, benchmarkům a režimům úsilí — se podrobně věnuje samostatný průvodce „Měli byste přejít na Claude Opus 5?“. Tento článek je o něčem jiném: vydání modelu také změnilo to, jak s ním efektivně komunikovat.

Společnost Anthropic zveřejnila analýzu na blogu Claude. Její hlavní myšlenka zní takto:

Klíčové slovní spojení je „příliš omezovali“. Když byly modely slabší, potřebovaly oporu: udělej tohle, nedělej tamto, tady je příklad, zopakuj to ještě jednou. Opus 5 už takovou oporu nepotřebuje a navíc mu může začít překážet. Anthropic nový princip formuluje jednoduše: nechte Claudea použít vlastní úsudek.

Co to pro vás znamená v praxi?

• Váš CLAUDE.md je stejný typ systémového promptu, ale pro váš projekt. Pokud Anthropic zkrátil ten svůj o 80 procent, váš je nejspíš také přebujelý.
• Dlouhé seznamy pravidel už nezaručují jejich dodržování. Naopak, čím více řádků, tím méně důsledně se jimi model řídí (níže se k tomu vrátíme s údaji z dokumentace).
• Objevily se nové mechanismy — automatická paměť a dovednosti — které přebírají část práce, kterou jste dříve museli ručně vypisovat do souboru CLAUDE.md.

Hlavní pointa: nejdůležitější práce probíhá před promptem — v tom, co vložíte do kontextu modelu ještě před prvním požadavkem. Aktualizace Opus 5 je v podstatě oficiálním potvrzením téže myšlenky ze strany Anthropic. Tentokrát jsou k tomu ale konkrétní údaje a nové nástroje. Proberu je postupně.

Proč dlouhý CLAUDE.md nyní překáží?#

Funguje to takto. CLAUDE.md je soubor pravidel, který Claude čte na začátku každé relace. Samostatný průvodce „Jak nastavit CLAUDE.md“ vysvětluje, jak ho vytvořit od začátku; tento článek se zabývá opačným postupem: co z něj nyní odstranit. Všechno, co do něj napíšete, se dostane do kontextu před vaším prvním požadavkem a zůstává tam po celou konverzaci. Kontext není nekonečný — každý další řádek pravidel zabírá prostor, který by mohl být využit pro váš úkol.

Dokumentace Claude Code to říká přímo:

Druhý bod je důležitější než první: dlouhé soubory snižují míru dodržování pokynů. Model začne pokynům věnovat menší pozornost. To je past, do které spadne téměř každý začátečník. Logika se zdá neprůstřelná: chci, aby mě Claude poslouchal, tak napíšu více pravidel. V praxi se stane opak. Čím delší je seznam, tím roztříštěnější je pozornost modelu a tím častěji některé pravidlo vynechá.

Takto se přístup změnil:

Je tu ještě druhý problém: rozpory. Jak soubor roste, téměř nevyhnutelně se v něm nahromadí vzájemně konfliktní pravidla. Na jednom místě se píše „vždy piš testy“, na jiném „nesahej do složky testů“. Dokumentace varuje, že pokud si dvě pravidla odporují, Claude si může náhodně vybrat kterékoli z nich. Jinými slovy, přerostlý soubor činí chování modelu méně předvídatelným.

Jednoduché pravidlo: CLAUDE.md je stručná poznámka o tom, co Claude nedokáže sám odvodit. Cokoli navíc pouze zabírá jeho pozornost.

Co si v CLAUDE.md ponechat a co odstranit?#

Dokumentace uvádí jasné kritérium, podle kterého lze rozhodnout, zda si pravidlo zaslouží místo v souboru CLAUDE.md. Přidejte ho, pokud:

1. Claude udělal stejnou chybu podruhé.
2. Kontrola kódu odhalila něco, co měl model o tomto projektu vědět.
3. Zadáváte stejnou opravu do chatu už podruhé.
4. Nový člen týmu by potřeboval stejný kontext, aby projekt nerozbil.

Obecným principem je ponechat úskalí specifická pro projekt a odstranit očividné věci. Claude Code má dokonce vestavěnou kontrolu claude doctor, která doporučuje uklidit přerostlý CLAUDE.md. Odstraňuje podrobnosti, které lze odvodit z kódové základny — strukturu složek, seznam závislostí, přehled architektury — a ponechává úskalí, zdůvodnění a konvence odlišné od výchozích.

Druhým důležitým pravidlem je konkrétnost. Vágní formulace nefungují. Porovnejte:

Rozdíl je jednoduchý. Model si může „správně naformátuj“ vyložit, jak chce. „Používej odsazení o 2 mezery“ lze jednoznačně ověřit. Každé pravidlo v souboru CLAUDE.md by mělo být viditelné a ověřitelné — tedy zda bylo, nebo nebylo dodrženo.

A za třetí, odstraňte očividné věci. Pokud do souboru CLAUDE.md napíšete „piš čistý kód“ nebo „dodržuj osvědčené postupy“, je to šum. Model to už zná a tento řádek zabírá místo a tříští jeho pozornost. Anthropic výslovně nedoporučuje plýtvat kontextem na očividné věci.

Kam přesunout pravidla, která se do CLAUDE.md nehodí?#

Tady přichází na řadu nejvíce nedoceněný nástroj. Dříve musely všechny pokyny zůstávat v souboru CLAUDE.md, ale dlouhé postupy nyní mají vlastní místo: dovednosti. Samostatný průvodce „Jak vybírat dovednosti Claude Code“ vysvětluje, jak zvolit ty správné a nepřidat jich příliš mnoho.

Rozdíl je zásadní. CLAUDE.md se na začátku každé relace načte celý. Dovednost ne. Dokumentace to formuluje takto:

Tomu se říká progresivní zpřístupňování — načítání informací podle potřeby. Jde o to poskytovat modelu kontext po částech a ve správnou chvíli. Anthropic přesunul podrobné pokyny, například pokyny ke kontrole kódu, do dovedností a odstranil je ze systémového promptu.

Kritérium pro přesun něčeho do dovednosti je jednoduché: část souboru CLAUDE.md se z faktu rozrostla v postup. Jednořádková poznámka „Sestavení probíhá přes npm run build“ je fakt a patří do souboru CLAUDE.md. Deset kroků popisujících „jak publikujeme projekt“ je postup a patří do dovednosti.

Praktická zásada: předejte dovednosti vše, co děláte více než párkrát. Jednou vysvětlete, jak sestavujete například týdenní zprávu pro klienta, převeďte toto vysvětlení na dovednost a už ho nebudete muset opakovat. Dovednost je připravená k použití, aniž by zabírala místo v kontextu, a lze ji zavolat jménem příkazem, jako je /otchet.

Do dovedností se hodí přesunout:

• Vícekrokové postupy (publikování, sestavování zprávy, kontroly před vydáním).
• Dlouhé pokyny, které jsou zřídka potřeba, ale tehdy celé.
• Cokoli, co podruhé nebo potřetí kopírujete z jednoho chatu do jiného.

Existuje také mezilehlá možnost: pravidla specifická pro složku. Pokud je pokyn důležitý jen pro jednu část projektu, můžete ho vložit do .claude/rules/ a propojit s příslušnými soubory. Potom se načítá pouze tehdy, když Claude pracuje s těmito soubory, místo aby byl neustále v kontextu.

Co je automatická paměť a proč ji v roce 2026 používat?#

Druhým novým mechanismem, který odlehčuje souboru CLAUDE.md, je automatická paměť. Jde o to, že si Claude nyní pamatuje nejen to, co jste napsali, ale také to, čeho si všiml sám. Samostatný průvodce „Paměť Claudea vs. CLAUDE.md“ vysvětluje, v čem se její fungování liší od souboru CLAUDE.md.

Rozdíl mezi těmito dvěma druhy paměti:

Funguje to takto: při práci na vašem úkolu si Claude všímá užitečných detailů — který příkaz spouští sestavení, kde se při ladění něco zadrhlo, co jste ho požádali dělat jinak — a ukládá si je do poznámek. V další relaci je znovu načte. Důležité je, že je ukládá selektivně a ponechává si jen to, co považuje za užitečné do budoucna.

Poznámky jsou uložené v samostatné složce pro každý projekt spolu s indexovým souborem MEMORY.md. Můžete si je zobrazit a upravovat příkazem /memory. Jsou to obyčejné textové soubory, takže je můžete kdykoli číst, upravovat nebo mazat.

Co to pro vás v praxi mění: Claude nyní zaznamenává část toho, co jste dříve po každé chybě sami přidávali do souboru CLAUDE.md. Díky tomu může být váš soubor s pravidly ještě kratší — a to je dobře.

Proč Opus 5 odporuje vašim pokynům?#

Má to i odvrácenou stránku.

Model, kterému dáte právo používat vlastní úsudek, bude z definice někdy nesouhlasit s rigidním příkazem, pokud v kontextu uvidí lepší možnost.

Co to znamená pro vás, pokud jste přešli na Opus 5 a něco se pokazilo:

1. Znovu zkontrolujte své staré dovednosti a pluginy. Nastavení vytvořená pro předchozí modely mohou být v rozporu s novou logikou. Něco, co dříve fungovalo jako hodinky, se nyní vyplatí znovu otestovat.
2. Odstraňte nejrigidnější formulace. Modely páté generace zvládají příkazy jako „nikdy nedělej X, vždy dělej jen Y“ hůře než pružné formulace, které vysvětlují proč.
3. Sledujte případy, kdy model skončí příliš brzy. Někdy to signalizuje, že si pokyn odporuje nebo naráží na pravidlo v přerostlém souboru CLAUDE.md.

Jak přepsat CLAUDE.md pro Opus 5: krok za krokem#

Takto postupujte při práci se souborem CLAUDE.md zděděným po předchozích modelech.

1. Spusťte vestavěnou kontrolu

   V projektu zadejte claude doctor. Navrhne, co z přerostlého souboru odstranit a co ponechat.

2. Odstraňte očividné věci

   Smažte každý řádek, jehož obsah dokáže Claude odvodit ze samotného kódu: strukturu složek, seznam knihoven a obecné fráze jako „piš čistý kód“.

3. Odstraňte rozpory

   Projděte soubor od začátku do konce a najděte pravidla, která jsou v rozporu. Jedno ponechte a to konfliktní smažte.

4. Přesuňte postupy do dovedností

   Cokoli, co se z faktu změnilo v návod krok za krokem, přesuňte do samostatné dovednosti. V souboru CLAUDE.md ponechte jednořádkový odkaz.

5. Zbývající pravidla upřesněte

   Přeformulujte každé pravidlo tak, aby bylo možné ho ověřit: „správně to naformátuj“ změňte na „používej odsazení o 2 mezery“.

6. Zapněte automatickou paměť a zkontrolujte délku

   Ujistěte se, že automatická paměť funguje (/memory) a že soubor má méně než 200 řádků. Pokud ne, je ještě co přesunout.

První kontrolu nemusíte provádět ručně — požádejte Claudea, aby ji provedl za vás. Tady je výchozí zadání, které můžete použít: zkopírujte ho a vložte do relace otevřené ve vašem projektu:

Přečti si můj soubor CLAUDE.md a můj kód. Tvým úkolem je soubor CLAUDE.md zkrátit a zpřehlednit pro model páté generace.

Projdi soubor a rozděl všechna pravidla do tří skupin:

PONECHAT – úskalí a konvence specifické pro projekt, které sám ze svého kódu nevyvodíš.

ODSTRANIT – zřejmé věci, které už znáš, a vše, co lze vyvodit z kódu.

PŘESUNOUT DO DOVEDNOSTI – vícekrokové postupy, které jsou nyní uvedeny jako text v souboru CLAUDE.md.

U první skupiny přeformuluj vágní pravidla tak, aby byla konkrétní a ověřitelná.
Najdi pravidla, která si odporují, a uveď je zvlášť.
Vrať novou verzi souboru CLAUDE.md kratší než 200 řádků a také seznam toho, co navrhuješ přesunout do dovedností.
Dokud to nepotvrdím, neměň žádné soubory.

Všimněte si posledního řádku: „Dokud to nepotvrdím, nic neměň.“ U modelu, který nyní používá vlastní úsudek, je to důležité: nechte si nejprve ukázat plán a rozhodnutí ponechte na sobě.

Proč je kontext důležitější než prompt?#

Když necháme stranou podrobnosti o Opus 5 a podíváme se na širší obraz, celá tato analýza je o jedné myšlence: kontext je důležitější než prompt. Nejdůležitější práce probíhá před zadáním požadavku — při sestavování prostředí, ve kterém bude model pracovat.

CLAUDE.md, dovednosti a automatická paměť jsou součástmi jedné věci: toho, co Claude vidí před vaší první zprávou. Formulaci svého požadavku můžete ladit donekonečna, ale pokud je kontext sestaven špatně — přerostlý soubor CLAUDE.md, protichůdná pravidla, žádná struktura — výsledky budou stále nejednotné.

Jednoduchá kontrola: bez prvního mozku druhý mozek nepomůže. „Druhým mozkem“ tento článek myslí strukturu znalostí o projektu, kterou model čte při každém požadavku. Funguje však pouze tehdy, když se opírá o vaše jasné porozumění úkolu. Nástroj zesiluje vaše myšlení a tím jeho role končí.

Aktualizace Opus 5 tuto logiku zostřila. Anthropic na vlastní práci ukázal, že když je model dost chytrý, další pravidla jen škodí a výhodu má ten, kdo pečlivě sestavil kontext. Tato dovednost vám zůstane i u každého dalšího modelu, ať už to bude Opus 6, nebo jakýkoli jiný.

Kde začít hned teď?#

Neodkládejte to na „někdy“. Nejjednodušší první krok je otevřít CLAUDE.md právě teď a upřímně se u každého řádku zeptat: jde o úskalí, které Claude nedokáže odvodit, nebo o něco očividného, co jsem přidal pro jistotu? Vše z druhé skupiny je kandidátem na smazání.

Potom soubor projděte pomocí zadání v předchozí části, přesuňte dlouhé postupy do dovedností a ověřte, že je automatická paměť zapnutá. Jeden večer práce a váš kontext se stane stručným a přesným základem pro model.

Můžete to uplatnit na vlastním skutečném projektu: CLAUDE.md, druhý mozek a dovednosti pro vaše úkoly.

Seznamte se s Ailootem.