# CLAUDE.md a AGENTS.md: trvalý kontext pro AI agenta **URL:** https://aibility.org/blog/claude-md-agents-md **Meta popis:** Co je CLAUDE.md a AGENTS.md, co do nich napsat a jak oba soubory propojit, aby AI agent znal pravidla projektu i v novém chatu. Postup z praxe Aibility. --- [Blog](/blog) · Build with AI · 5 min čtení # CLAUDE.md a AGENTS.md: trvalý kontext pro AI agenta Oba soubory jsou obyčejný text ve složce projektu a AI agent si je přečte pokaždé, když začne pracovat. Pravidla napíšeš jednou a zná je i nový chat. Sepsal jsem, co do nich patří a jak v Markdownu držíme i firemní znalosti. Vibe Coding Summer 2026 Soubory, které agent čte jako první Soubor Co v něm je _A_AGENTS.md pravidla pro Codex, Cursor a další _C_CLAUDE.md jeden řádek: @AGENTS.md _C_context.md cíl, stav, rozhodnutí, další krok _D_docs/ podrobnosti podle témat Jeden zdroj pravdy Obsah 1. [Trvalé pokyny pro AI agenta](#trvale-pokyny-pro-ai-agenta) 2. [Jeden zdroj pravdy pro Claude Code i Codex](#jeden-zdroj-pravdy-pro-claude-code-i-codex) 3. [Obsah souboru s pravidly](#obsah-souboru-s-pravidly) 4. [Firemní znalosti v Markdownu](#firemni-znalosti-v-markdownu) 5. [Pravidla pro více projektů](#pravidla-pro-vice-projektu) 6. [Údržba souboru](#udrzba-souboru) 7. [Často se ptáte](#faq) Dlouho jsem tyhle soubory neměl, protože jsem měl pocit, že je nepotřebuju. Začal jsem je psát, až když mi začaly růst složky a potřeboval jsem, aby agent dělal určité věci pokaždé stejně. Dnes je mám ve složkách, ve kterých pracuju. Bez nich začíná každý nový chat od nuly. Znovu vysvětluješ, o jaký projekt jde, kde leží podklady a co agent nemá dělat. V programu [Vibe Coding Summer](https://aibility.org/vibe-coding-summer) jsme se k tomu vraceli v několika lekcích, protože dlouhý chat dlouhodobou paměť nenahradí. Plní se, starší části se komprimují a rozhodnutí z prvního týdne se postupně ztrácejí. ## Trvalé pokyny pro AI agenta Oba soubory dělají totéž: řeknou agentovi, jak se má v dané složce chovat. Píšou se v Markdownu, tedy v obyčejném textu s pár značkami, třeba `#` pro nadpis. Žádnou syntaxi navíc nepotřebuješ, pravidla do nich normálně slovně popíšeš. Liší se hlavně tím, kdo je čte. `AGENTS.md` je otevřený formát, který čtou Codex, Cursor, GitHub Copilot a další nástroje. Claude Code čte `CLAUDE.md`, od září 2026 ale přečte i `AGENTS.md`, když ve složce žádný `CLAUDE.md` nenajde. Agent soubor otevře na začátku každé práce, takže pokyny platí i v chatu, který otevřeš za měsíc, nebo pro kolegyni, která pracuje ve stejné složce. Typické pravidlo může znít: „Na tomhle projektu pracuju pro firmu, tady je deset věcí, které děláš pracovně, a tři, které jsou soukromé.“ Nebo: „Nikdy neměň data ve složce s uživatelskými daty.“ U toho druhého počítej s tím, že je to pořád jen pokyn. Agent se jím řídí, ale tvrdou hranici udělají až oprávnění a nastavení nástroje. ## Jeden zdroj pravdy pro Claude Code i Codex Když střídáš nástroje, nechceš udržovat dva soubory se stejnými pravidly. Za měsíc se rozejdou a nebudeš vědět, který platí. V Aibility to řešíme jednoduše. Všechna pravidla jsou v `AGENTS.md` a v `CLAUDE.md` je jediný řádek `@AGENTS.md`, který do Claude Code načte celý soubor. Slovní pokyn, ať si ho přečte, je slabší: Claude soubor otevře, jen když se tak rozhodne. Claude pak pracuje podle stejných pravidel jako Codex a měníš je jen na jednom místě. Vyzkoušej Funguje v Claude Code, Codexu i Cursoru. Otevři nástroj ve složce projektu a povol mu úpravy souborů. PromptZkopírovat Projdi tuhle složku a naše poslední konverzace. Najdi pokyny, které ti opakuju pořád dokola, a zeptej se mě na to, co z podkladů nepoznáš. Pak je zapiš do AGENTS.md jako krátká pravidla. Vytvoř i CLAUDE.md s jediným řádkem @AGENTS.md, aby Claude Code načetl stejná pravidla. Na konci mi ukaž, co v obou souborech je. ## Obsah souboru s pravidly Do `AGENTS.md` nedávej všechno. Soubor má fungovat jako rozcestník, který agentovi řekne, kde začít, kde najde podrobnosti a které soubory se ručně nepřepisují. Díky tomu nemusí při každé otázce číst celou složku. Stabilní informace o projektu patří do vedlejšího souboru, například `context.md`. Do něj napiš cíl, pro koho projekt je, jak funguje, v jakém je stavu, jaká padla rozhodnutí, co je omezení, co právě řešíš a jaký je další krok. `AGENTS.md` pak obsahuje větu „Než začneš, přečti si `context.md`“. Když projekt naroste, `context.md` zůstane rozcestníkem a podrobnosti se rozdělí do složky `docs/`, třeba na produkt, uživatele, architekturu a rozhodnutí. Agentovi řekni, ať chybějící fakta označí jako `TODO` a nedomýšlí si je. Na jednom check-inu jsme rozebírali prompt na psaní textů, který si pokaždé načítal deset nebo dvanáct dalších souborů. Doporučili jsme ho zjednodušit, protože tolik kontextu spíš škodí. Agent má načíst jen to, co potřebuje pro krok, který právě dělá. ## Firemní znalosti v Markdownu Stejný princip používáme pro celou firmu. V Aibility máme pracovní prostor PACT, složku se čtyřmi částmi: Projects pro rozpracovanou práci, Agents pro opakované postupy a skilly, Context pro stabilní informace o firmě, produktech a strategii a Tools pro skripty a malé nástroje. Kdokoli z týmu ví, kam co uložit, a agent ví, kde to hledat. Texty v něm píšeme v Markdownu, takže je přečte člověk i agent, a když je verzuješ v Gitu, vidíš, kdo co změnil. Na jednom nástroji přitom nezávisíš: Codex, Claude Code i Cursor pracují nad stejnou složkou, takže když ti jeden přestane vyhovovat, další pokračuje se stejným kontextem. U chatové paměti, která leží u jednoho poskytovatele, to nejde. Velká videa a prezentace do takové složky nedávej. Nech je na Drivu a v PACTu měj jen seznam s cestou k souboru, popisem a tím, k čemu se hodí. Do `AGENTS.md` pak napiš, který seznam má agent otevřít, když multimédia hledá. Firemní a osobní znalosti držím odděleně. Mám osobní pracovní prostor a firemní PACT a do firemního dávám jen to, co má opravdu sdílet celý tým. ## Pravidla pro více projektů Každý projekt má vlastní `AGENTS.md`, protože agent ho hledá ve složce, ve které začíná práci. Codex i Claude Code čtou i soubory v nadřazených složkách, takže společná pravidla můžou ležet o patro výš. Obsah se klidně může mezi projekty opakovat. Postupy, které používáš všude, třeba jak chceš psát prezentace nebo dělat research, kopírovat nemusíš. Nech je na jednom místě a odkaž na ně. Stabilní osobní preference, třeba tón psaní, patří do vlastních instrukcí v nastavení nástroje. `AGENTS.md` může odkázat i na osobní soubory mimo projekt, pokud k nim má agent přístup. Z mé praxe Když jsem po agentovi chtěl idea file, nedělal ho dobře, i když jsem mu postup nalinkoval. Tak jsem mu do vlastních instrukcí výslovně napsal, kde ho najde. Stejně to mám u extrakce znalostí z přepisů. ## Údržba souboru `AGENTS.md` má tendenci bobtnat. Na naší platformě ho mám přerostlý, je tam i seznam příkazů, které agent smí v terminálu spouštět. Best practice to není, ale funguje mi to: nemusím agentovi pořád vysvětlovat, co smí a co ne. Claude Code má příkaz `/doctor prompt-audit`, který projde `CLAUDE.md`, `AGENTS.md` a další instrukce a řekne ti třeba, že pět řádků je zastaralých nebo si odporuje. Úpravy jen navrhne, soubory sám nemění. Pravidla taky necháváme měnit jen přes kontrolu. Automatizace na mém Mac mini jednou chtěla upravit můj `AGENTS.md`. Poslala to jako žádost o změnu, prošel jsem si rozdíl proti původní verzi a schválil ho. Sama soubor nepřepsala. Začni jedním souborem v projektu, ke kterému se vracíš nejčastěji. Pomůže ti s tím 15minutový [AI Workout na založení souboru s pravidly](https://aibility.org/knihovna/agents-md). Když chceš, aby kolega i nový chat hned poznali stav projektu, přidej k němu [úvodní stránku projektu](https://aibility.org/knihovna/project-start-here). Jak s agenty začít úplně od začátku, popisuju v článku [Co je vibe coding](https://aibility.org/blog/co-je-vibe-coding). ## Vyzkoušej na své práci ### [Založ si AGENTS.md: pravidla pro AI v jednom souboru](https://aibility.org/knihovna/agents-md) AI Workout, 15 minut, soubor s pravidly, který AI čte na začátku každé práce ### [Vytvoř si README: úvodní stránka projektu](https://aibility.org/knihovna/project-start-here) AI Workout, 15 minut, README projektu, ze kterého nový chat pozná stav [obrázek: Tom Paulus]**Tom z Aibility**Co-CEO pro produkt ## Často se ptáte K čemu je soubor `CLAUDE.md`? Claude Code si ho přečte na začátku každé práce ve složce. Napíšeš do něj pravidla a kontext projektu jednou a nemusíš je opakovat v každém chatu. Jaký je rozdíl mezi `AGENTS.md` a `CLAUDE.md`? Obsahem žádný. `AGENTS.md` čtou Codex, Cursor a další nástroje, `CLAUDE.md` čte Claude Code. Ten od září 2026 přečte i `AGENTS.md`, ale jen když `CLAUDE.md` chybí. Když používáš víc nástrojů, dej pravidla do `AGENTS.md` a v `CLAUDE.md` nech jen řádek `@AGENTS.md`. Potřebuju `CLAUDE.md`, když pracuju jen v jedné malé složce? Na první pokusy ne. Vyplatí se, jakmile agentovi začneš opakovat stejné pokyny nebo když ve složce přibývají projekty. Musí mít každý projekt vlastní `AGENTS.md`? Vyplatí se to, agent ho hledá ve složce, ve které začíná práci. Soubory z nadřazených složek čte taky, takže společné postupy můžou zůstat na jednom místě a projekt na ně jen odkáže. Stačí napsat pravidlo do `AGENTS.md`, aby ho agent dodržel? Agent se jím řídí, ale je to pořád pokyn. Co nesmí udělat nikdy, ohlídej i v oprávněních nástroje. Jak spojit firemní pravidla s osobním stylem psaní? Pravidla projektu patří do `AGENTS.md`. Osobní styl dej do vlastních instrukcí v nastavení nebo do souboru mimo projekt, na který `AGENTS.md` odkáže. Newsletter ## Nechcete nic zmeškat? Jednou za dva týdny posíláme souhrn toho nejlepšího z AI světa. Žádný spam, jen věci, které stojí za přečtení. [Odebírat newsletter](/newsletter) Superpowered Professional ## Zjistěte, jak s AI pracujete Krátký test AI dovedností trvá asi 2 minuty. Je zdarma a výsledek máte hned. [Začít zdarma](https://sp.aimee.coach/assessment) ## Další články [[obrázek: Zpráva od AI agenta ve Slacku: nabídka pro klienta je hotová pět minut po callu]30\. října 2026 · Build with AIAI v obchodu: nabídka do pěti minut po callu a onboarding sám od sebeAI v obchodu nemusí prodávat za tebe. Kolegyně z obchodu si nechala jen hovor s klientem a přípravu, nabídku i onboarding za ni dělá AI. Sepsal jsem, jak to má postavené a jak začít.](/blog/ai-v-obchodu) [[obrázek: Marketingový obsah jako výrobní linka: strategie, článek, kontrola textu, vizuál a plán]30\. října 2026 · Build with AIAI marketing: obsah jako výrobní linka s agentyAI marketing funguje nejlíp jako výrobní linka: vlastní myšlenka, rešerše, draft, kontrola, vizuál a publikace. Popisuju, jak ji máme v Aibility a jak si ji během léta postavil jeden účastník programu.](/blog/marketing-s-ai-agenty) [[obrázek: Ukazatel kontextového okna zaplněného na 93 procent]30\. října 2026 · AI nástrojeKontextové okno a tokeny: proč AI zapomíná a jak šetřitKontextové okno je to, co AI v jednom chatu právě vidí, a tokeny jsou jednotky, ve kterých se počítá text i cena. Když se okno zaplní, AI začne zapomínat, a když pálíš tokeny, dojde ti limit. Sepsal jsem, co s tím dělám já a co jsme řešili v létě s lidmi z programu.](/blog/kontextove-okno-a-tokeny)