Blog

Proč Claude dělá něco jiného: 3 zadání

Markdown

Claude napíše něco jiného, protože se hned pouští do kódu, aniž by porozuměl vašemu záměru. Vysvětluji proč a nabízím 3 připravená zadání, která ho přimějí nejprve se ptát.

Přečíst celý článek

Hlavní poznatek

Claude napíše něco jiného, protože se hned pouští do kódu a doplňuje si, co si myslí, že jste chtěli. Často to odhadne špatně. Problém téměř nikdy není v modelu — i ten nejsilnější mine cíl, když je zadání nejasné. Řeším to jedním krokem: nejprve nechám Claude, aby mě vyzpovídal a zjistil, co mám na mysli, a teprve potom začal psát. Níže najdete tři hotová zadání, která můžete zkopírovat a vložit.

Další informace o používání služby najdete v dokumentaci Ailoot.

Proč Claude nedodrží zadaný úkol?

Hlavní poznatek

Claude dostane krátké zadání, okamžitě doplní chybějící části a pustí se do psaní kódu podle vlastní představy o úkolu. Ta se od vaší liší. Tak vznikne diff, který zasahuje do 14 souborů, přestože jste čekali změnu na jednom řádku. Příčinou je rozdíl mezi tím, co jste řekli, a tím, co jste měli na mysli. Model s tím téměř vůbec nesouvisí.

Napíšete: „Přidej filtry na stránku produktů.“ Vy si představíte pár zaškrtávacích políček a aktualizovaný seznam. Claude slyší totéž a rozhodne se postavit plnohodnotný filtrovací engine: vlastní úložiště stavu, samostatnou logiku zpoždění vstupu, synchronizaci s URL a tucet pomocných funkcí. Stovky řádků, přestože by stačilo pár parametrů URL.

V takovém případě je závěr jasný: agent neudělal chybu, jen vyřešil mnohem větší problém, než bylo potřeba. Chyba byla v tom, že požadovaný výsledek nebyl popsán dost stručně a přesně.

Klíčovým slovem je „záměr“. Vy ho máte v hlavě, Claude ne. Vidí text vašeho zadání a vše, co má v kontextu až do chvíle, kdy ho zadáte. Pak mezery doplňuje odhady. Čím kratší je zadání, tím více odhadů dělá — a tím více se výsledek vzdaluje tomu, co jste chtěli.

Anthropic to v dokumentaci Claude Code říká jasně:

Když necháte Claude rovnou přejít ke kódu, může řešit nesprávný problém.

— Claude Code Docs, https://code.claude.com/docs/en/best-practices

Sám jsem se s tím setkal ve vlastním projektu. Požádal jsem o opravu jedné autorizační obrazovky a dostal diff, který zasahoval do poloviny sousedního modulu. Claude za to nemohl: dal jsem mu jeden řádek a on si zbytek doplnil sám. Od té doby začínám každý úkol větší než oprava překlepu otázkami — těmi, které mi Claude pokládá.

Proč při nejasném zadání selhávají i nejsilnější modely Claude?

Hlavní poznatek

Na modelu záleží méně, než si lidé obvykle myslí. U nejasného úkolu mine cíl i ten nejsilnější: dostane stejně neúplné pokyny a mezery vyplní vlastními odhady. Vývojáři, kteří mají svého agenta pod kontrolou, dosahují stejných výsledků s nejmodernějším modelem i modelem střední třídy. Vše závisí na tom, jak jasně popíšete, co chcete. Výkon modelu je tu druhořadý.

Každý týden přichází model, který je „chytřejší“ než ten předchozí, a pokaždé to vypadá, že právě teď nám AI konečně porozumí z několika slov. Nestane se to. Silnější model píše kód rychleji a lépe zvládá složitou logiku, ale stále vám nevidí do hlavy. Pokud je úkol špatně formulovaný, dostanete něco krásně napsaného, co je stále špatně.

Ponaučení je jednoduché. Honit se za nejnovějším modelem, aby lépe odhadoval, je slepá ulička. Levnější a spolehlivější je naučit se zadávat mu úkoly tak, aby nemusel hádat. A právě tomu se budeme věnovat dál.

Co je grilling a jak řeší nesoulad s AI?

Hlavní poznatek

Grilling znamená, že necháte AI, aby vás před začátkem práce vyzpovídala: klade podrobné otázky k úkolu, dokud nedosáhnete společného porozumění. Smyslem je překlenout komunikační propast ještě před prvním řádkem kódu.

Zní to neintuitivně. Obracíme se na AI, abychom věci zvládli rychleji, a teď nám říkají, abychom ji zpomalili a nejdřív ji nechali klást otázky. Pět minut otázek před psaním kódu vám ale může ušetřit hodinu následných oprav.

Problém není jen v tom, že jste Claude špatně vysvětlili, co chcete. Často jste si úkol sami dostatečně nepromysleli — jaké případy zohlednit, kde jsou hranice, co je nejdůležitější. Grilling vám to pomůže zjistit otázkami. Na konci rozhovoru máte nejen úkol, kterému AI rozumí, ale také konečně podrobně vymezený vlastní úkol.

Tak funguje context engineering: hlavní práce se odehrává před zadáním, ne během něj. Nehledáte kouzelné znění promptu; předem Claude vysvětlujete, co potřebujete, dokud tomu neporozumí bez dalšího vysvětlování.

Jak přimět Claude, aby se nejdřív ptal?

Hlavní poznatek

Stručně popište Claude úkol a výslovně ho požádejte, aby vás před zahájením práce vyzpovídal: ať se ptá na podrobnosti, okrajové případy a omezení a nakonec vše sepíše do souboru se specifikací. Jde o oficiální doporučení Anthropic — dokumentace Claude Code obsahuje připravenou šablonu zadání. Zkopírujte ji, upravte popis a vložte na začátku relace.

Anthropic tento přístup nejen povoluje, ale i doporučuje. V dokumentaci má oddíl s názvem „Nechte Claude, aby vás vyzpovídal“, který obsahuje připravené zadání. Tady je praktická verze:

Zadání

Zadání pro grilling — nechte Claude, aby vás vyzpovídal

Chci vytvořit [stručný popis úkolu].

Než napíšete jakýkoli kód, podrobně mě vyzpovídejte. Ptejte se na implementaci, rozhraní, okrajové případy, rizika a kompromisy. Nepokládejte zřejmé otázky — zaměřte se na složité části, které jsem možná nedomyslel.

Pokládejte vždy jednu otázku a počkejte na mou odpověď. Ke každé otázce hned navrhněte svou doporučenou odpověď.

Pokračujte, dokud neprobereme vše. Potom sestavte úplnou specifikaci do souboru s názvem SPEC.md.

Tři podrobnosti dělají toto zadání užitečným, a ne jen ozdobným. Zaprvé „vždy jednu otázku“. Když na vás AI vychrlí deset otázek najednou, zahltí vás to a odpovíte povrchně. Zadruhé „navrhněte svou odpověď“: nemusíte všechno vymýšlet od začátku; můžete souhlasit nebo návrh opravit. Zatřetí „sestavte specifikaci do souboru“: záměr, který z vás otázky vytáhly, se promění v dokument, který se neztratí.

Anthropic popisuje přínos z hlediska vynaloženého úsilí:

Čas věnovaný správnému sepsání specifikace má větší hodnotu než čas strávený sledováním implementace.

— Dokumentace Claude Code, https://code.claude.com/docs/en/best-practices

Po rozhovoru otevřete novou relaci a předejte jí hotovou specifikaci. Čistý kontext a jasně vyjádřený záměr — a Claude napoprvé trefí cíl.

Technika „dokaž mi, že je to nejlepší plán“

Hlavní poznatek

Nestačí přimět AI, aby kladla otázky — nechte ji také obhájit své rozhodnutí. Do zadání přidávám požadavek, aby dokázala, že navržený plán je nejlepší, nikoli jen první, který ji napadne, a že je promyšlený několik kroků dopředu. Claude tak přestane být v režimu „udělám něco podobného“ a přejde do kritického režimu, v němž kontroluje vlastní práci dřív, než začnete s implementací.

Grilling pomáhá odhalit váš záměr. AI má ale ještě jeden zlozvyk: sáhne po prvním řešení, které vypadá věrohodně. Anthropic tomu říká mezera mezi důvěrou a ověřením: Claude vytvoří věrohodnou implementaci, která neobstojí v okrajových případech. Řešením je vyžádat si důkazy ještě před psaním kódu.

Pokud výsledek nemůžete ověřit, neodevzdávejte ho.

— Anthropic, Claude Code Docs, https://code.claude.com/docs/en/best-practices

Do zadání téměř vždy přidávám oddíl „dokaž to“. Tady je jeho přesné znění:

Zadání

Zadání — přimějte AI, aby obhájila svůj plán

Než začnete psát kód, analyzujte úkol jako kritik.

Najděte 2-3 způsoby, jak ho vyřešit. U každého mi dokažte, že skutečně řeší můj úkol, místo aby jen přidával složitost pro složitost samu. Nepište kód jen proto, abyste psali kód.

Potom jeden vyberte a dokažte, že jde o nejlepší řešení, promyšlené několik kroků dopředu. Co se pokazí, až projekt poroste? Co nám právě teď uniká?

Teprve potom navrhněte implementaci.

Bez tohoto oddílu vám Claude nabídne první funkční možnost. S ním sám zavrhne slepé uličky, vysvětlí svou volbu a umožní vám seznámit se s jeho úvahami ještě předtím, než se dotkne jediného souboru. Přečtete si krátký text, který zabere dvě minuty, místo abyste hodinu zjišťovali, proč hotový kód nefunguje podle očekávání.

Pre-mortem: nechte AI najít 10 důvodů neúspěchu ještě před začátkem

Hlavní poznatek

Pre-mortem je technika, při níž AI požádáte, aby si představila, že projekt už selhal, a pojmenovala důvody. Claude přepne z optimistického režimu „zvládnu to“ do hledání slabin, které by jinak vyšly najevo po týdnu práce. Dostanete seznam rizik ještě předtím, než projektu věnujete čas, a můžete je předem řešit.

Tahle technika je moje nejoblíbenější a je psychologická. Když AI požádáte, aby „odvedla dobrou práci“, je nastavená na úspěch a přehlíží nedostatky. Požádejte ji, aby si představila neúspěch, a začne si všímat toho, co předtím ignorovala. Zadání je krátké:

Zadání pro pre-mortem — najděte nedostatky před začátkem

Představte si, že je za rok. Projekt, který plánujeme, selhal.

Sepište 10 důvodů, proč se to stalo. S čím jsme na začátku nepočítali, co jsme podcenili, kde jsme šli na úkor kvality a které předpoklady se ukázaly jako nepravdivé?

Potom mi u každého důvodu řekněte, co můžeme napravit už teď.

Toto zadání používám před schválením plánu. Polovina důvodů se ukáže jako nesmysl, ale druhá polovina představuje skutečná úskalí, na která bych narazil o týden později. Jejich řešení ve fázi plánování zabere deset minut. Narazit na ně v hotovém projektu znamená několik dní pátrání.

Kombinace je jednoduchá: grilling odhalí záměr, „dokaž to“ obhájí rozhodnutí a pre-mortem odhalí nedostatky. Tři krátké texty, které vložíte před psaním kódu. Změní Claude z uspěchaného vykonavatele na spolupracovníka, který nejdřív přemýšlí.

Proč přetížený kontext způsobí, že se Claude chová hloupě?

Hlavní poznatek

Claude má omezené kontextové okno — množství informací, které dokáže mít najednou v hlavě. Když je okno zaplněné z více než poloviny, začne ztrácet důležité podrobnosti, plést si předchozí dohody a doplňovat mezery místo toho, aby si vzpomněl. Dlouhá relace o všem možném je častým důvodem, proč AI na konci dne dělá něco úplně jiného, než na čem jste se ráno dohodli.

I dokonale formulovaný úkol se rozpadne, pokud na něm pracujete v přeplněném kontextu. Funguje to takto: každý nový požadavek přenese do pracovního kontextu Claude celou historii chatu. Čím delší relace, tím rychleji se okno zaplňuje. Udržujte ho zaplněné nejvýše z poloviny; potom se AI začne chovat hloupě a ztrácet důležité věci, o kterých jste mluvili na začátku.

Tady je pravidlo, které mi ušetří nejvíc frustrace: jeden úkol, jeden chat. Dokončili jste funkci? Zavřete chat a pro další úkol otevřete nový. Ano, někdy je pohodlnější dělat všechno v jednom okně, ale zaplatíte za to ztrátou kontextu a odpověďmi mimo téma.

Anthropic tomuto způsobu selhání říká „relace jako šuplík na harampádí“. Řešení je jednoduché: mezi nesouvisejícími úkoly použijte /clear, abyste vyprázdnili okno a nepřenášeli do nového úkolu nepořádek z předchozího.

Pokud vedete dlouhé relace a nevíte, kam jdou peníze a pozornost AI, podrobněji se tomu věnuji v průvodci Kam míří tokeny Claude Code. Základy trvalého kontextu, který Claude čte při každém spuštění, jsem shrnul v průvodci Nastavení souboru CLAUDE.md.

Grilling, nebo Plan Mode — v čem se liší a jak spolu souvisejí?

Hlavní poznatek

Grilling a Plan Mode řeší dvě různé poloviny téhož problému. Grilling otázkami odhaluje váš záměr ještě před vytvořením plánu. Plan Mode vezme již pochopený úkol a ukáže vám plán změn, aniž by na cokoli sáhl, dokud ho neschválíte. Nejlépe fungují společně: nejprve grilling vyjasní, co vytváříme, a potom Plan Mode ukáže přesně jak.

Lidé si tyto dvě techniky často pletou nebo předpokládají, že stačí jen jedna. V praxi patří do různých fází postupu.

FunkceGrillingPlan Mode
Kdy probíháPřed plánem — vyjasňuje záměrPotom — vytváří plán změn
Kdo se koho ptáAI vás vyzpovídáVy si plán přečtete a schválíte
Co získáteSpecifikaci úkoluPlán změn po jednotlivých souborech
Hlavní přínosPředchází námitce „to jsem nechtěl“Předchází námitce „na nic jiného nesahejte“

Anthropic popisuje standardní pracovní postup ve čtyřech fázích: nejprve Explore (Claude zkoumá a klade otázky), potom Plan (vytvoří plán bez provádění změn), dále Implement (napíše kód podle plánu) a nakonec Commit (zaznamená výsledek). Grilling probíhá v první fázi, Plan Mode ve druhé. Podrobnější popis druhé fáze najdete v průvodci Plan Mode v Claude Code.

Důležité upozornění od samotného Anthropic: malé úkoly tím nezatěžujte.

Pokud dokážete změnu popsat jednou větou, plán přeskočte.

— Oficiální dokumentace Claude Code, https://code.claude.com/docs/en/best-practices

U překlepu, přejmenování nebo změny na jednom řádku ji jednoduše rovnou popište, bez rozhovorů a plánů. Grilling se vyplatí u nejednoznačných úkolů, kde chyba něco stojí. U triviálních úkolů vás jen zpomalí.

5 chyb ve formulaci úkolu, kvůli kterým AI dělá něco jiného

Hlavní poznatek

Téměř každé selhání AI lze vysvětlit pěti chybami ve formulaci úkolu: vágní jednověté zadání, žádná omezení, pokyn „napiš kód“ bez fáze „nejdřív porozuměj“, žádná definice toho, co znamená „hotovo“, a nekonečná relace pro všechno. Kvůli každé z nich Claude doplňuje úkol vlastními odhady. Níže je popsáno, jak jednotlivé chyby vypadají a čím je nahradit.

Častá úskalí jsem shrnul v tabulce. Vlevo je obvyklý chybný postup, vpravo to, co dělat místo něj.

ChybaJak to zníCo dělat místo toho
Vágní jednověté zadání„Vylepši dashboard“Popište úkol a začněte grilling — nechte AI, aby otázkami zjistila podrobnosti
Žádná omezení„Přidej autorizaci“Uveďte, co se nesmí rozbít, jaké knihovny se nemají přidávat a co je mimo rozsah
Okamžité „napiš kód“Zadání — a začít kódovatNejprve „porozuměj a ptej se“, potom piš kód
Žádná definice „hotovo“Čekáte, že AI výsledek odhadneUkažte příklad, referenční snímek obrazovky nebo test, který definuje, co znamená „funguje“
Jedna relace na všechnoStrávíte celý den v jednom chatuJeden úkol, jeden nový chat, aby se kontext nezaplnil

Projděte si poslední zadání, na které vám AI odpověděla špatně. Téměř jistě v tom hrála roli jedna z těchto pěti chyb. Nejčastější je ta první: zadali jste jí krátkou frázi a čekali, že Claude správně doplní zbytek. Doplnil ho — jen ne tak, jak jste měli na mysli.

Co dál: vybudujte systém, díky kterému vám AI porozumí z několika slov

Hlavní poznatek

Jednotlivá zadání řeší jednotlivé úkoly. Chcete-li, aby vám AI rozuměla bez dlouhého vysvětlování pokaždé, potřebujete systém: grilling odhalí záměr pro každý úkol, Second Brain uchová znalosti o projektu a context engineering propojí vše, co Claude čte před zadáním. Pak zmizí důvod, proč dělá něco jiného: vždy má dost kontextu, aby nemusel hádat.

Tři zadání v tomto průvodci — grilling, „dokaž to“ a pre-mortem — se zaměřují na konkrétní úkol. Už to je velká změna: místo změny na jednom řádku přestanete dostávat diff se 14 soubory.

Grilling má ale své hranice. Zjišťovat pokaždé váš záměr od začátku trvá dlouho. Skutečný posun nastane, když je část kontextu vždy k dispozici: ve složce se znalostmi o projektu, v souboru CLAUDE.md, který Claude čte při každém spuštění, a ve vaší metodice zakódované ve skillech. Pak AI přistupuje k úkolu se znalostí vašeho podnikání, cílů a stylu — a rozumí vám z několika slov, protože polovinu kontextu jste připravili předem.

Nedávná analýza Anthropic ukazuje, kolik práce to obnáší: vývojáři používají AI asi při 60% své práce, ale plně jí mohou důvěřovat jen u 0-20% úkolů. Zbytek vyžaduje vaše porozumění, dohled a schopnost vysvětlit, co se má vytvořit. Právě tuto dovednost má smysl rozvíjet, místo honby za nejchytřejším modelem.

Poznejte Ailoot.

Další podrobnosti

Časté otázky

Kdy místo přímého psaní kódu použít zadání s rozhovorem?

Když nejsou jasné výsledek, okrajové případy či omezení a chyby by byly drahé. Ptejte se postupně a dohodu uložte do SPEC.md; překlep nebo jasnou jednořádkovou změnu lze zadat přímo.

Co ověřit před přijetím navrženého plánu?

Požadujte dva či tři přístupy a porovnejte splnění specifikace a omezení. Potom spusťte zadání předběžného rozboru selhání, projděte uvedené příčiny a relevantní rizika vyřešte před implementací.

Všechny články