Cursor Rules vs CLAUDE.md vs AGENTS.md: Otestoval jsem jednu konfiguraci ve všech třech (2026)

Cursor Rules vs CLAUDE.md vs AGENTS.md: Otestoval jsem jednu konfiguraci ve všech třech (2026)

Otázka cursor rules vs claude md v sobě skrývá past: nejsou to dvě možnosti, mezi kterými si vybíráte. Jsou to dva soubory, které čtou dva různé nástroje a které shodou okolností dělají totéž. Hoďte CLAUDE.md do projektu v Cursoru a Cursor ho ignoruje. Hoďte AGENTS.md do Claude Code a taky se nic nestane. Nás to taky překvapilo. AGENTS.md dnes leží ve více než 60 000 repozitářích jako otevřený standard pod správou Agentic AI Foundation při Linux Foundation, přesto ho Claude Code sám od sebe stále nepřečte. Tady je mapa kompatibility, otestovaná na našem repu.

Hlavní závěry

• Cursor čte .cursor/rules/*.mdc a AGENTS.md, nikoli CLAUDE.md.
• Claude Code čte pouze CLAUDE.md, nikoli AGENTS.md nativně.
• Pro sdílení jednoho souboru: symlinkujte AGENTS.md na CLAUDE.md, nebo ho importujte pomocí @AGENTS.md.
• Standardizujte na AGENTS.md (otevřený standard, 60k+ repozitářů) a přidejte přepisy pro konkrétní nástroje.

Jaký formát konfigurace zvolit? Rozhodnutí za 30 sekund

Vybírejte formát podle tvaru týmu, ne podle humbuku. Pokud používáte jeden nástroj, použijte jeho nativní soubor. Pokud používáte dva a více, přijměte AGENTS.md jako zdroj pravdy a přidejte přepisy pro konkrétní nástroj jen tam, kde daný nástroj potřebuje něco, co ostatní ne. Toto jediné pravidlo vyřeší většinu zmatků.

Ještě se rozhodujete, kterého asistenta nasadit, než začnete řešit jeho konfiguraci? Začněte naším průvodcem výběrem AI coding agenta a pak se vraťte pro nastavení souborů.

Rozhodující osa je přenositelnost. Soubor .cursor/rules je mocný uvnitř Cursoru a k ničemu jinde. AGENTS.md cestuje. Takže pokud nejste navždy přivázaní k jednomu nástroji, nástrojově agnostický soubor je sázka na jistotu.

Co každý formát ve skutečnosti je (každý za 30 sekund)

Všechny tři soubory dělají jednu věc: předají AI nástroji na kód pravidla, konvence a úskalí vašeho projektu, než napíše první řádek. Rozdíl je v tom, kdo je čte a jak si vymezují rozsah. Tady je krátká verze. Podrobný návod pro každý najdete v jeho vlastním průvodci.

Cursor Rules jsou soubory .mdc uvnitř .cursor/rules/. Cursor podporuje čtyři typy pravidel (vždy zapnutá, vyžádaná agentem, glob-scoped a ruční @-zmínka), takže můžete pravidlo připojit jen k souborům *.tsx nebo jen k migracím. Pro frontmatter, globy a tokenový rozpočet si přečtěte našeho průvodce jak psát soubory .cursor/rules.

CLAUDE.md je paměťový soubor Claude Code. Claude prochází adresářový strom od vaší pracovní složky nahoru a zřetězuje každý CLAUDE.md, který najde. Je to čistý Markdown, žádný frontmatter není potřeba. Pro strukturu a pravidla, díky kterým ho Claude nebude ignorovat, viz co dělá CLAUDE.md takový, že ho Claude neignoruje.

AGENTS.md je otevřený standard. Jeden soubor v čistém Markdownu v kořeni repa, který nativně čte Cursor, Codex, Copilot, Windsurf, Zed, Aider a desítky dalších. Spravuje ho Agentic AI Foundation a už je v více než 60 000 projektech.

Tady je ten reframing, který stojí za zapamatování: AGENTS.md, CLAUDE.md a .cursor/rules nejsou konkurenti, jsou to tatáž instrukce adresovaná různým čtenářům.

Cursor Rules vs CLAUDE.md vs AGENTS.md: Hlavní srovnání

Nejrychleji uvidíte rozdíl vedle sebe. Rozhodující sloupec je přenositelnost: které nástroje čtou soubor bez dalšího nastavování. AGENTS.md vyhrává v dosahu, Cursor Rules vyhrávají v přesnosti vymezení rozsahu a CLAUDE.md vyhrává pro každého, kdo vsadil vše na Claude Code.

Všimněte si řádku .cursorrules. Ten jeden soubor v kořeni v Cursoru stále funguje, ale vypadl z dokumentace, takže ho berte jako legacy. Nové projekty by měly používat .cursor/rules/*.mdc nebo AGENTS.md.

Který nástroj čte který soubor? (Vyvrácení mýtu o AGENTS.md)

Tady je fakt, který polovina internetu chápe špatně: Claude Code nečte AGENTS.md nativně a Cursor nečte CLAUDE.md. Cursor čte .cursor/rules/*.mdc plus AGENTS.md. Claude Code čte CLAUDE.md a nic jiného. Žádný automatický fallback v žádném směru neexistuje, což sráží týmy, které předpokládají, že jeden standardní soubor pokryje vše.

Na tohle se lidé ptají neustále, tak buďme přímí. Vhození AGENTS.md do projektu Claude Code samo o sobě nic neudělá. Claude Code čte CLAUDE.md a pouze CLAUDE.md. Dokumentace Anthropic k paměti Claude Code popisuje chování načítání souborů bez zmínky o AGENTS.md, specifikace AGENTS.md uvádí Cursor a Codex mezi nativními čtenáři, ale ne Claude Code, vlastní dokumentace Cursoru k pravidlům potvrzuje toto rozdělení a GitHub issues Claude Code jsou plné vývojářů, kteří narážejí přesně na tuto zeď.

Takže čte Cursor claude.md? Ne. Čte Claude Code agents.md? Ne bez pomoci. Tahle „pomoc" je celý důvod, proč tento článek existuje, a jsou to dva krátké příkazy, které uvidíte vzápětí.

Jak funguje priorita a vnořování, vedle sebe

Každý nástroj řeší konflikty jinak a špatné pochopení je hlavní zdroj zmatku „proč se moje pravidlo ignoruje?". Cursor slučuje pravidla podle priority zdroje. Claude Code zřetězuje podle hloubky adresáře. AGENTS.md vybírá nejbližší soubor ve stromu. Dobrá claude md management začíná tím, že víte, ve kterém mentálním modelu se pohybujete.

V našem nastavení je praktický závěr jednoduchý: široká pravidla dejte nahoru (kořen repa) a konkrétní pravidla dolů (uvnitř složky balíčku). Pro Claude Code i AGENTS.md platí, že soubor nejblíže k místu, kde pracujete, má přednost, takže packages/api/AGENTS.md přepíše kořenový pro cokoli uvnitř dané složky. Cursor je výjimka — řeší podle úrovně zdroje, ne podle hloubky složky.

Prohnali jsme jednu konfiguraci Curzorem + Claude Code, tady je, co každý nástroj skutečně načetl

Testovali jsme na živém klientském repu Techsy (backend Next.js 15) pomocí Cursor 3.7 (build z 17. června 2026) a Claude Code v2.1.x (začátek července 2026). Jeden AGENTS.md, tři nastavení sdílení, stejný prompt otevřený v obou nástrojích. Tady je přesně to, co každý z nich načetl.

Začali jsme s minimálním souborem:

# AGENTS.md
- Package manager: pnpm, never npm.
- Tests: Vitest. Run `pnpm test` before any commit.
- DB access goes through `lib/db.ts` only, no inline SQL.

Nastavení 1: Samotný AGENTS.md. Cursor ho zachytil okamžitě. Soubor se zobrazil v jeho kontextu a správně odmítl navrhovat npm install. Claude Code s ním neudělal nic. Spuštění /memory v Claude Code vypsalo nula souborů projektové paměti: žádný CLAUDE.md nenalezen a AGENTS.md nebyl ani zmíněn. Potvrzeno: žádný nativní fallback.

Nastavení 2: Symlink. Nasměrovali jsme CLAUDE.md na stejný soubor:

ln -s AGENTS.md CLAUDE.md

Teď /memory v Claude Code vypsal ./CLAUDE.md jako projektovou paměť a načtený obsah byl náš AGENTS.md bajt po bajtu. Cursor stále četl AGENTS.md přímo. Jeden fyzický soubor, oba nástroje spokojené. Na Windows je k tomu potřeba povolit režim správce nebo režim vývojáře, jinak ln/mklink tiše selže.

Nastavení 3: @import. Smazali jsme symlink a místo toho vložili jeden řádek na úplný začátek skutečného CLAUDE.md:

@AGENTS.md

/memory pak ukázalo CLAUDE.md jako načtený soubor a AGENTS.md jako importovanou referenci pod ním. Tohle je cesta, kterou Anthropic skutečně dokumentuje, a nevyžaduje žádná speciální oprávnění OS.

Verdikt z našeho testu: symlink přinutí Claude Code číst AGENTS.md bajt po bajtu; import @AGENTS.md je verze bezpečná pro Windows, kterou Anthropic skutečně doporučuje. Obojí vám dá jeden zdroj pravdy. Na macOS/Linux zvolte symlink pro nulovou indirection, nebo importovací řádek, pokud kdokoli v týmu používá Windows.

Migrace mezi formáty: .cursorrules → .cursor/rules → AGENTS.md

Většina týmů sem dorazí s legacy souborem .cursorrules a chce se dostat z pasti jednoho souboru. Migrace je krátká v každém směru a kroky jsou copy-paste. Jeden zádrhel, který lidi kouše: soubor .md uvnitř .cursor/rules bez frontmatteru je tiše ignorován, takže musí být .mdc.

Pro modernizaci starého .cursorrules máte dvě čisté cesty:

• Na .cursor/rules/*.mdc: vytvořte .cursor/rules/general.mdc, přidejte frontmatter (alwaysApply: true pro globální pravidlo) a vložte pod něj starý obsah. Po ověření smažte .cursorrules.
• Na AGENTS.md (doporučeno pro týmy s více nástroji): pro převod cursorrules na agents.md zkopírujte tělo .cursorrules do nového AGENTS.md v kořeni repa. Žádný frontmatter není potřeba; je to čistý Markdown. Pak přidejte symlink nebo import @AGENTS.md, aby ho četl i Claude Code.

Pokud zůstáváte v Cursoru a chcete z něj vymáčknout víc, náš průvodce jak dostat z Cursoru víc den co den pokrývá vymezení rozsahu pravidel v praxi.

Opačný směr (AGENTS.md → CLAUDE.md) je prostě symlink nebo import z předchozí sekce. Žádná ztrátová konverze neexistuje, protože všechny tři jsou uvnitř Markdown.

Kam zapadají SKILL.md a Copilot Instructions?

V této konverzaci se objevují dva další formáty a skills md je právě teď vyhledávaný výraz, takže stojí za rychlé zařazení. Žádný z nich nenahrazuje tři hlavní soubory; stojí vedle nich.

SKILL.md je formát Skills od Anthropic: instrukce specifické pro úlohu zabalené v .claude/skills/*/SKILL.md, které Claude načítá na vyžádání, když úloha odpovídá, místo aby byly vždy zapnuté jako CLAUDE.md. Představte si to jako specializovaný playbook, po kterém Claude sáhne, ne jako paměťový soubor pro celý projekt. Rozsah se stále vyvíjí, takže do toho zatím příliš neinvestujte. Pro to, jak zapadá do reálného workflow, viz kam CLAUDE.md zapadá v reálném workflow Claude Code.

Copilot instructions žijí v .github/copilot-instructions.md pro GitHub Copilot. Dobrá zpráva: Copilot také čte AGENTS.md, takže pokud jste standardizovali na otevřeném standardu, Copilot je pokrytý bez samostatného souboru.

Co byste měli použít? (Podle tvaru týmu)

Přizpůsobte formát tomu, jak váš tým skutečně pracuje:

• Sólo uživatel Claude Code: prostě použijte CLAUDE.md. Není důvod přidávat AGENTS.md, pokud neplánujete později přibrat Cursor nebo Codex.
• Sólo uživatel Cursoru: .cursor/rules/*.mdc pro glob scoping, nebo jeden AGENTS.md, pokud chcete přenositelnost od prvního dne.
• Tým s mixem nástrojů: jeden AGENTS.md jako zdroj pravdy, symlinkovaný nebo importovaný do CLAUDE.md. Malý soubor .cursor/rules přidejte jen pro chování specifické pro Cursor.
• Monorepo: AGENTS.md v kořeni plus vnořené soubory pro každý balíček, takže každý subprojekt popisuje sám sebe a nejbližší soubor vyhrává.

V Techsy standardizujeme konfiguraci AI kódování napříč týmy s mixem nástrojů, obvykle jeden AGENTS.md jako zdroj pravdy s přepisy pro konkrétní nástroj tam, kde ho daný nástroj potřebuje. Pokud váš tým ručně žongluje se třemi konfiguračními soubory, získejte bezplatnou konzultaci a my to zmapujeme.

Ještě jeden odkaz na závěr: tento článek porovnává konfigurační soubory. Pokud se ve skutečnosti snažíte rozhodnout mezi samotnými nástroji, přečtěte si srovnání samotných asistentů, ne jejich konfigurace.

O autorovi

Mert Batur Gurbuz je spoluzakladatel Techsy.io, kde tým dodává AI agenty, automatizační systémy a hlasové/SDR pipeline pro B2B klienty. Studuje na University of Birmingham a píše o stacku nástrojů kolem LLM, který tým Techsy skutečně používá v produkci.

Spoluzakladatel, Techsy.io · University of Birmingham · LinkedIn

Často kladené otázky

Čte Cursor CLAUDE.md?

Ne. Cursor čte .cursor/rules/*.mdc a AGENTS.md nativně, ale CLAUDE.md není v dokumentaci Cursoru nikdy zmíněn a nenačítá se. Pokud používáte Cursor a chcete sdílet konfiguraci s uživateli Claude Code, dejte pravidla do AGENTS.md (který Cursor čte), nikoli do CLAUDE.md.

Čte Claude Code AGENTS.md?

Ne nativně. Claude Code čte pouze CLAUDE.md, bez automatického fallbacku na AGENTS.md. Aby to fungovalo, buď symlinkujte soubory (ln -s AGENTS.md CLAUDE.md), aby Claude četl AGENTS.md bajt po bajtu, nebo přidejte @AGENTS.md na řádek 1 souboru CLAUDE.md pro jeho import. Import je Anthropicem doporučená, bezpečná varianta pro Windows.

Můžu prostě použít jeden soubor pro všechny tři nástroje?

Ano. Přijměte AGENTS.md jako jediný zdroj pravdy a Cursor a Codex ho čtou přímo. Pro Claude Code přidejte jeden most: buď symlinkujte AGENTS.md na CLAUDE.md, nebo hoďte @AGENTS.md na začátek CLAUDE.md. Udržujete jeden soubor a každý nástroj načítá stejná pravidla. To je celý recept na sdílení jedné konfigurace.

Je .cursorrules deprecated?

Soft-deprecated. Jednosouborový .cursorrules v kořeni repa v Cursoru stále funguje, ale už není v oficiální dokumentaci, což je obvyklý signál, že formát končí. Nové projekty by měly používat .cursor/rules/*.mdc pro pravidla s vymezeným rozsahem nebo AGENTS.md pro přenositelnost.

Jak převedu .cursorrules na AGENTS.md?

Zkopírujte tělo souboru .cursorrules do nového AGENTS.md v kořeni repa. Je to čistý Markdown, takže žádný frontmatter ani přeformátování není potřeba. Pak přidejte symlink nebo import @AGENTS.md, aby ho četl i Claude Code, a smažte starý .cursorrules, jakmile potvrdíte, že Cursor načítá nový soubor.

Jaký je rozdíl mezi CLAUDE.md a AGENTS.md?

CLAUDE.md je proprietární paměťový soubor Claude Code, který čte pouze Claude Code. AGENTS.md je otevřený standard, který čte Cursor, Codex, Copilot a více než 20 dalších nástrojů, ale ne Claude Code nativně. Stejný formát Markdown, stejná práce. Rozdíl je v dosahu. AGENTS.md cestuje napříč nástroji; CLAUDE.md zůstává uvnitř Claude Code.

Na jakém formátu by se měl standardizovat tým používající více AI nástrojů?

AGENTS.md. Je to otevřený standard, který nativně čte většina nástrojů a který už je ve více než 60 000 repozitářích. Standardizujte sdílená pravidla tam, přemostěte do Claude Code symlinkem nebo importem a přidejte malé soubory specifické pro nástroj (jako .cursor/rules) jen tam, kde jeden nástroj potřebuje chování, které ostatní ne.

Jak funguje priorita, když mám vnořené konfigurační soubory?

Pro Claude Code i AGENTS.md platí, že soubor nejblíže k pracovnímu adresáři vyhrává, takže pravidlo v packages/api/AGENTS.md přepíše soubor v kořeni repa pro cokoli uvnitř dané složky. Cursor je jiný: slučuje pravidla Team, Project a User podle úrovně zdroje, ne podle hloubky složky, přičemž dřívější zdroje vyhrávají konflikty.

Kam zapadá SKILL.md?

SKILL.md je nově se objevující formát Skills od Anthropic: instrukce specifické pro úlohu v .claude/skills/*/SKILL.md, které Claude načítá na vyžádání, když úloha odpovídá, místo aby byly vždy zapnuté jako CLAUDE.md. Doplňuje CLAUDE.md, spíše než aby ho nahrazoval. Rozsah se v roce 2026 stále vyvíjí, takže ho berte jako specializovaný doplněk, ne jako čtvrtý soubor, který každý projekt potřebuje.