# Jeden súbor s pokynmi pre Claude Code, Codex a Cursor v roku 2026
> Jeden zdroj pravdy pre Claude Code, Codex a Cursor v roku 2026: kedy Claude Code číta AGENTS.md samo, import @AGENTS.md do CLAUDE.md, symbolický odkaz a /init.
Source: https://ailoot.ai/blog/sk/agents-md-claude-md-one-instruction-file/
Canonical: https://ailoot.ai/blog/sk/agents-md-claude-md-one-instruction-file/
Language: sk
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-004
Revision: sha256-790972a3c48f042d30f9be9a931ffd7d4336c638939cdefd8d97b8a1f0a13178
Informácie o službe nájdete v [dokumentácii Ailoot](https://ailoot.ai/docs/).
## Čo sa zmení, keď používate Claude Code, Codex a Cursor spolu?
Kľúčové zistenie
V roku 2026 typické nastavenie vibe codera neobsahuje jeden nástroj, ale 3–5. Claude Code ako hlavný nástroj, Codex na dlhé autonómne úlohy, Cursor na rýchle úpravy v IDE. Každý má vlastný súbor s pokynmi: `CLAUDE.md`, `AGENTS.md`, `.cursorrules`. Ak ich synchronizujete ručne, upravíte jeden riadok na piatich miestach, zabudnete aktualizovať Cursor a o týždeň neskôr budú Claude a Codex dávať na rovnakú výzvu odlišné výsledky.
V opísanom príklade je Claude Code hlavný nástroj, zatiaľ čo Codex a Cursor sa používajú na konkrétne úlohy. Moje `CLAUDE.md` má približne 250 riadkov pokynov: čo čítať a v akom poradí, na čo sa nesmie siahať, ktoré príkazy používať pri nasadení a aké pravidlá platia pre formátovanie commitov. Keď som na projekte prvýkrát vyskúšal Codex CLI, nepoznal žiadne z pravidiel: spustil `git push --force`, šmátral v `.env` a bez rozmyslu premenovával súbory.
Najprv som ručne skopíroval `CLAUDE.md` do `AGENTS.md`. O dva týždne neskôr som zistil, že projekt už má štyri verzie rovnakých pokynov: v `CLAUDE.md`, `AGENTS.md`, `.cursorrules` a `.windsurf/rules/`. Všetky sa trochu líšili. Toto nie je problém Clauda ani Cursoru; je to základná pasca každého systému s viacerými zdrojmi pravdy. Podrobnejšie o tomto probléme píšem v [sprievodcovi prácou s viacerými agentmi](https://ailoot.ai/blog/sk/claude-code-codex-together/).
V júni 2026 priniesla dokumentácia pamäte Claude Code od Anthropic jedno riešenie: spoločný súbor a import. Od septembra 2026 číta Claude Code samo aj `AGENTS.md`, ak projekt nemá `CLAUDE.md`; import je potrebný vtedy, keď máte pravidlá špecifické pre Claude. Nižšie vysvetľujem, kedy stačí jediné `AGENTS.md`, ako nastaviť import a ako oddeliť spoločné pravidlá od tých špecifických pre Claude.
## Číta Claude Code samo súbor AGENTS.md?
Kľúčové zistenie
Áno, od verzie 2.1.277, vydanej 18. septembra 2026, ale iba vtedy, ak v pracovnom adresári ani v žiadnom jeho nadradenom adresári nie je `CLAUDE.md`, `.claude/CLAUDE.md` ani `CLAUDE.local.md`. Ak `CLAUDE.md` existuje, Claude Code štandardne číta iba tento súbor a `AGENTS.md` sa zahrnie riadkom `@AGENTS.md` v súbore `CLAUDE.md` alebo pomocou symbolického odkazu. Správanie sa mení v časti Project instructions v `/config`. Pred septembrom Claude Code súbor `AGENTS.md` vôbec nečítalo a import bol jediným spôsobom.
Pred septembrom 2026 bola odpoveď „nie“. Issue \#6235, v ktorom sa žiadala podpora AGENTS.md, bolo otvorené od augusta 2025 a uzavreli ho 17. augusta 2026. Dokumentácia pamäte celý ten čas odporúčala jedno riešenie: vytvoriť CLAUDE.md a zahrnúť doň `AGENTS.md` ako import. Od verzie 2.1.277 dokumentácia hovorí niečo iné:
Claude Code dokáže čítať AGENTS.md ako pokyny pre projekt, takže repozitár už nastavený pre iných agentov funguje bez súboru CLAUDE.md, importu alebo konfigurácie.
— Anthropic, https://code.claude.com/docs/en/memory#agents-md
To, ktoré súbory Claude Code číta, závisí od toho, ktoré súbory sa v projekte nachádzajú:
| Súbory v projekte | Čo číta Claude Code |
|----|----|
| `AGENTS.md`, bez `CLAUDE.md` alebo `CLAUDE.local.md` v pracovnom adresári či v niektorom nadradenom adresári | `AGENTS.md` |
| `AGENTS.md` a `CLAUDE.md` (alebo `CLAUDE.local.md`) v pracovnom adresári či v niektorom nadradenom adresári | Iba `CLAUDE.md` |
| `CLAUDE.md` s riadkom `@AGENTS.md` | `CLAUDE.md` a `AGENTS.md` vložené cez import |
Pri tejto kontrole sa započítavajú súbory `CLAUDE.md`, `.claude/CLAUDE.md` a `CLAUDE.local.md` v pracovnom adresári a vo všetkých nadradených adresároch. Osobný súbor `~/.claude/CLAUDE.md`, firemne spravovaný súbor a pravidlá z `.claude/rules/` sa nezapočítavajú: načítavajú sa spolu so súborom `AGENTS.md`.
Keď neexistuje `CLAUDE.md`, Claude Code pri spustení načíta všetky súbory `AGENTS.md` a `.claude/AGENTS.md` v pracovnom adresári a jeho nadradených adresároch. Súbor `AGENTS.md` v podadresári načíta, keď v ňom otvorí súbor. Fungujú aj importy `@path` v súbore `AGENTS.md`. Claude Code nečíta `AGENTS.local.md`, `AGENTS.override.md` ani obsah adresára `.agents/`.
Háčik: započítava sa aj osobný súbor `CLAUDE.local.md`. Vytvorte si ho, aby ste v ňom uchovávali vlastné necommitnuté pravidlá, a Claude Code potichu prestane čítať `AGENTS.md`. Riešením je nastavenie uvedené nižšie.
Správanie sa mení v časti Project instructions v `/config`:
| Nastavenie | Čo číta Claude Code |
|----|----|
| `claude-md-or-agents-md` (predvolené) | `CLAUDE.md`, alebo ak neexistuje ani on, ani `CLAUDE.local.md`, súbor `AGENTS.md` |
| `claude-md-and-agents-md` | Oba súbory: v každom adresári najprv `CLAUDE.md` a potom `AGENTS.md` |
| `claude-md` | Iba `CLAUDE.md` |
| `managed-only` | Iba firemný spravovaný súbor `CLAUDE.md` a automatická pamäť |
Ak si chcete ponechať `CLAUDE.local.md` a zároveň nestratiť `AGENTS.md`, nastavte `claude-md-and-agents-md`. K dvojitému čítaniu nedôjde: ak je `AGENTS.md` už zahrnutý cez riadok `@AGENTS.md` alebo symbolický odkaz, Claude Code ho nenačíta druhýkrát bez ohľadu na nastavenie.
Pomocou príkazu `/memory` môžete skontrolovať, či sa súbor načítal: od verzie 2.1.280 sa cesta k súboru `AGENTS.md` zobrazuje v zozname. Vo verziách starších než 2.1.277 a v reláciách, v ktorých je vypnutý vstavaný plugin `agents-md`, Claude Code číta iba `CLAUDE.md` a v ponuke `/config` nie je položka Project instructions. Pred verziou 2.1.281 sa rovnako správali aj relácie cez Amazon Bedrock a relácie s vypnutou telemetriou. V prvej relácii po aktualizácii zo staršej verzie sa navyše môže stať, že sa `AGENTS.md` nenačíta; začne fungovať od nasledujúcej relácie.
Čo to znamená pre nastavenie s jedným súborom? Ak nemáte pravidlá špecifické pre Claude, môžete `CLAUDE.md` vynechať: stačí `AGENTS.md` a budú ho čítať Claude Code, Codex aj Cursor. Ak také pravidlá máte (režim plánovania pre rizikové adresáre, skills, hooks), potrebujete `CLAUDE.md` a Claude Code prestane `AGENTS.md` čítať samo. Potom do `CLAUDE.md` vložte `AGENTS.md` riadkom `@AGENTS.md`; toto nastavenie funguje rovnako ako pred septembrom. Pomáha aj so staršími verziami Claude Code. Podrobne to vysvetľujem nižšie.
## Ako vložiť @AGENTS.md do súboru CLAUDE.md?
Kľúčové zistenie
Import je potrebný, keď projekt obsahuje `CLAUDE.md`: ak je prítomný, Claude Code štandardne nečíta `AGENTS.md` samo. Nastavíte ho tak, že na začiatok súboru `CLAUDE.md` napíšete riadok `@AGENTS.md`. Keď Claude Code spustí reláciu, na miesto tohto riadka vloží obsah súboru `AGENTS.md` a výsledok prečíta ako jeden text. Pod import môžete pridať sekciu „Claude Code“ s pravidlami, ktoré platia iba pre Claude. Importy fungujú s relatívnymi aj absolútnymi cestami a možno ich vnoriť až do štyroch úrovní.
Minimálny funkčný príklad z oficiálnej dokumentácie:
```markdown
@AGENTS.md
## Claude Code
Use plan mode for changes under `src/billing/`.
```
Tu je postup. Prvý riadok, `@AGENTS.md`, je direktíva importu. Keď Claude Code na začiatku relácie analyzuje súbor `CLAUDE.md`, nájde tento import a vloží na jeho miesto celý obsah súboru `AGENTS.md`. Nasleduje nadpis `## Claude Code`: je to obyčajný markdown, ale funguje ako sekcia „dodatkov špecifických pre Claude“. Pod ňou je pravidlo, ktoré platí iba pre Claude Code: pri zmenách v adresári billing použiť režim plánovania. Codex CLI ani Cursor tento súbor vôbec neotvárajú; používajú obyčajný súbor `AGENTS.md`.
Citát z dokumentácie o fungovaní importov:
Súbory CLAUDE.md môžu importovať ďalšie súbory pomocou syntaxe @path/to/import. Importované súbory sa rozbalia a pri spustení relácie načítajú do kontextu spolu so súborom CLAUDE.md, ktorý na ne odkazuje.
— Anthropic, https://code.claude.com/docs/en/memory
Niekoľko praktických podrobností:
- **Relatívne a absolútne cesty.** Cesta `@AGENTS.md` je relatívna k súboru, ktorý obsahuje import. Cesty `@/Users/me/shared/rules.md` alebo `@~/.claude/personal.md` sú absolútne. Cestu `@~/.claude/personal.md` používam na osobné preferencie, ktoré nechcem vložiť do repozitára.
- **Hĺbka štyroch úrovní.** Súbor `AGENTS.md` môže importovať `@docs/coding-style.md` a súbor `coding-style.md` môže importovať ďalší súbor, až do štyroch úrovní. To stačí na akúkoľvek reálnu štruktúru.
- **Spätné apostrofy blokujú importy.** Ak text obsahuje `` `@README` ``, ide len o zmienku názvu, nie o import. Hodí sa to pri vysvetľovaní fungovania importov čitateľom bez toho, aby ste nejaký spustili.
- **Schválenie súborov mimo projektu.** Ak import smeruje mimo pracovného adresára, napríklad na `@~/.claude/personal.md`, Claude Code pri prvom použití zobrazí dialóg so zoznamom týchto súborov. Ak ho odmietnete, externé importy zostanú vypnuté a dialóg sa už nezobrazí. Import `@AGENTS.md` v koreňovom adresári projektu dialóg nevyvolá. Chráni vás to pred náhodným načítaním nesúvisiaceho súboru do kontextu.
Po prechode na toto nastavenie v opísanom projekte sa moje `CLAUDE.md` skrátilo z 250 riadkov na 60: `@AGENTS.md` a päť až sedem pravidiel platných iba pre Claude Code (režim plánovania pre rizikové adresáre, na čo nesiahať v administračnej časti a ako formulovať commity). Všetky spoločné pravidlá sú v súbore `AGENTS.md`, ktorý čítajú Codex a Cursor.
## Kedy zvoliť symbolický odkaz a kedy import?
Kľúčové zistenie
Anthropic ponúka dva mechanizmy: import cez `@AGENTS.md` alebo symbolický odkaz, `ln -s AGENTS.md CLAUDE.md`. Symbolický odkaz je jednoduchší — je to len alias a nevyžaduje zmeny súborov. Má však tri nevýhody: Windows vyžaduje oprávnenia správcu, do súboru `CLAUDE.md` nemožno pridať pravidlá špecifické pre Claude a Git niekedy zobrazuje symbolický odkaz ako zbytočnosť v rozdiele. Import je univerzálny spôsob. Ak nemáte pravidlá iba pre Claude, od verzie 2.1.277 nepotrebujete ani jedno: Claude Code si prečíta `AGENTS.md` samo.
Dokumentácia ukazuje možnosť so symbolickým odkazom takto:
```bash
ln -s AGENTS.md CLAUDE.md
```
A hneď uvádza otvorené varovanie pre Windows:
Ak vy alebo ktokoľvek, kto klonuje repozitár, pracujete vo Windows, použite import @AGENTS.md. Vytvorenie symbolického odkazu tam vyžaduje oprávnenia správcu alebo režim Developer Mode. Git bez zapnutého nastavenia core.symlinks pri checkout-e uložený odkaz zmení na obyčajný textový súbor, takže namiesto pokynov v danej kópii zostane jednoradový súbor CLAUDE.md.
— Anthropic, https://code.claude.com/docs/en/memory
Porovnávacia tabuľka:
| Kritérium | Import `@AGENTS.md` | Symbolický odkaz `ln -s` |
|----|----|----|
| **Funguje vo Windows bez oprávnení správcu** | áno | nie (vyžaduje Developer Mode) |
| **Možno pridať pravidlá iba pre Claude** | áno, pod import | nie, súbor je totožný |
| **V Gite sa zobrazuje ako obyčajný markdown** | áno | ako odkaz (závisí od `core.symlinks`) |
| **Možno importovať viac súborov** | áno, až štyri úrovne | nie, vzťah jeden k jednému |
| **Caching/neplatnosť v Claude Code** | štandardné pre CLAUDE.md | funguje, ale symbolické odkazy majú úskalia v metadátach |
| **Predvolená voľba** | vhodná pre každého | iba ak nezáleží na používaní naprieč platformami |
V opísanom projekte používam importy. Dôvody:
1. **Tím používa rôzne platformy.** Používam Mac; v príklade je tím približne rovnomerne rozdelený medzi Windows a Mac. Ak sa v repozitári objaví symbolický odkaz, používateľom Windows bez Developer Mode sa pri checkout-e zmení na obyčajný textový súbor s jediným riadkom `AGENTS.md`. To spôsobuje zvláštne chyby: niekedy pravidlá fungujú, inokedy nie a nie je jasné prečo.
2. **Chcem pravidlá iba pre Claude.** Pod `@AGENTS.md` je v mojom `CLAUDE.md` sekcia „Claude Code“ s pravidlami: použiť `--effort high` na architektonické úlohy, spustiť `npm run build` pred `git push` a ručne nevolať `/api/v1/deploy`. Codex týmto príkazom nerozumie.
3. **Ladenie je jednoduchšie.** Keď sa niečo pokazí, otvorím `CLAUDE.md` a vidím import aj svoje zmeny. Pri symbolickom odkaze nie je zrejmé, že „toto bolo pridané sem“. Viac o ladení nastavení Claude Code nájdete v [sprievodcovi bezpečným režimom](https://ailoot.ai/blog/sk/claude-code-safe-mode-recovery/).
Ak nemáte pravidlá špecifické pre Claude, od verzie 2.1.277 už symbolický odkaz nepotrebujete: odstráňte `CLAUDE.md` a Claude Code bude čítať `AGENTS.md` samo. Odkaz si ponechajte iba vtedy, ak niekto v tíme používa verziu staršiu než 2.1.277 a nemôže ju aktualizovať. Ak máte pravidlá špecifické pre Claude, import je pohodlnejší v deviatich prípadoch z desiatich.
## Čo čítajú Codex, Cursor, Copilot, Windsurf a Gemini CLI?
Kľúčové zistenie
Každý nástroj číta vlastný súbor, niekedy aj viac než jeden. Claude Code číta `CLAUDE.md` a od septembra 2026 číta aj `AGENTS.md`, ak projekt nemá `CLAUDE.md`. Codex CLI číta `AGENTS.md` a `AGENTS.override.md`. Cursor číta starší formát `.cursorrules` alebo novší `.cursor/rules/*.mdc` a od leta 2026 číta aj `AGENTS.md`. Copilot číta `.github/copilot-instructions.md` alebo `.github/instructions/*.instructions.md`. Windsurf číta starší súbor `.windsurfrules` alebo novší adresár `.windsurf/rules/`. Gemini CLI číta `GEMINI.md`. Aider a Cline už prijali štandard `AGENTS.md`.
Prehľad siedmich hlavných nástrojov (na základe oficiálnej dokumentácie každého nástroja):
| Nástroj | Hlavný súbor s pokynmi | Alternatívy | Číta AGENTS.md? |
|----|----|----|----|
| **Claude Code** | `CLAUDE.md` | `~/.claude/CLAUDE.md`, `./.claude/CLAUDE.md`, spravovaná politika | áno, ak projekt nemá `CLAUDE.md` (od 2.1.277), inak cez import |
| **Codex CLI** (OpenAI) | `AGENTS.md` | `AGENTS.override.md` | áno (natívne) |
| **Cursor** | `.cursor/rules/*.mdc` | `.cursorrules` (zastarané) | áno |
| **GitHub Copilot** | `.github/copilot-instructions.md` | `.github/instructions/*.instructions.md` | cez rozšírenia |
| **Windsurf** | `.windsurf/rules/` | `.windsurfrules` (zastarané) | áno |
| **Gemini CLI** | `GEMINI.md` | \- | nie |
| **Aider, Cline, opencode** | `AGENTS.md` | \- | áno (natívne) |
Čo z toho vyplýva? Ak má repozitár `AGENTS.md` (a tiež `CLAUDE.md` s importom, ak sú potrebné pravidlá špecifické pre Claude), päť zo siedmich nástrojov automaticky dostáva aktuálne pokyny. Cursor a Windsurf, ktoré majú vlastné natívne súbory, môžete ponechať tak, ako sú (`AGENTS.md` čítajú tiež), alebo do nich pridať import `@AGENTS.md` — ich syntax sa však líši a nie vždy je podporovaná.
Najjednoduchšia stratégia pre nový projekt:
1. **Vložte všetky spoločné pravidlá do `AGENTS.md`** — patrí tam 95 % pravidiel.
2. **Vytvorte `CLAUDE.md`, ak potrebujete pravidlá iba pre Claude:** na prvý riadok vložte `@AGENTS.md` a pod neho pridajte sekciu s pravidlami iba pre Claude. Ak také pravidlá nemáte, `CLAUDE.md` netreba; Claude Code číta `AGENTS.md` samo od verzie 2.1.277.
3. **Adresár `.cursor/rules/` ponechajte pre Cursor** na zriedkavé prípady, keď je potrebné niečo špecifické pre Cursor (jeho príkazy `@Codebase` a `@Docs`).
4. **To isté urobte pre Windsurf:** zabudnite na starý `.windsurfrules`; nový `.windsurf/rules/` používajte iba vtedy, keď sú potrebné vzory pre jeho syntax.
Tento prístup prináša 80 % výhod za 20 % práce. Podľa mojich skúseností sa pri organizovaní zmiešaných tímov v „Antigravity“ stáva údržba viac než dvoch zdrojov pravdy (spoločných a iba pre Claude) náročnou. Ak niekto z tímu pridá pravidlo do `.cursorrules` a zabudne na `AGENTS.md`, o týždeň neskôr sa Cursor a Codex nebudú zhodovať.
## Ako Claude Code pri príkaze /init načíta existujúci súbor AGENTS.md?
Kľúčové zistenie
Príkaz `/init` vytvorí súbor `CLAUDE.md` podľa toho, čo už je v repozitári, a ušetrí 20–30 minút ručnej práce. V predvolenom nastavení preberá pravidlá Cursoru (`.cursor/rules/`, `.cursorrules`) a Copilotu (`.github/copilot-instructions.md`), zatiaľ čo `AGENTS.md`, `.windsurfrules` a `.clinerules` číta v režime `CLAUDE_CODE_NEW_INIT=1`. Tento režim spúšťa rovnaký interaktívny viacfázový postup: kladie otázky, skúma kód prostredníctvom podagenta a pred zápisom navrhuje plán. Od septembra 2026 má `/init` v projekte so súborom `AGENTS.md` nevýhodu: nový `CLAUDE.md` vypne priame čítanie `AGENTS.md` a pravidlá skončia v dvoch súboroch.
Anthropic vo svojej dokumentácii opisuje `/init` takto:
Spustenie príkazu /init číta súbory s pokynmi pre iné nástroje a presúva relevantné časti do vytváraného súboru CLAUDE.md: pravidlá Cursoru z .cursor/rules/ alebo .cursorrules, pravidlá Copilotu z .github/copilot-instructions.md a pri nastavení CLAUDE_CODE_NEW_INIT=1 aj súbor AGENTS.md, adresár .devin/rules/, adresár .windsurf/rules/ alebo súbor .windsurfrules a súbor .clinerules.
— Anthropic, https://code.claude.com/docs/en/memory
Čo to znamená v praxi? Opísaný repozitár mal súbor `.cursorrules` z čias, keď som skúšal Cursor (približne 80 riadkov), a súbor `AGENTS.md` (120 riadkov, zostavený ručne). Keď som spustil `claude /init`, príkaz použil oba súbory, odstránil podobné pravidlá a za minútu vytvoril čistý súbor `CLAUDE.md`. Potom som ho skontroloval a vykonal drobné úpravy — odstránil som zastarané položky a pridal štruktúru s nadpismi. Bolo to rýchlejšie než prepisovať všetko od začiatku.
Interaktívny režim, v ktorom `/init` číta aj `AGENTS.md`, sa zapína pomocou premennej prostredia:
```bash
CLAUDE_CODE_NEW_INIT=1 claude
```
Keď sa `/init` spustí, Claude položí sériu objasňujúcich otázok: ktoré prvky nakonfigurovať (`CLAUDE.md`, skills, hooks), aký technologický stack projekt používa a ktoré príkazy použiť na testy. Potom podagent preskúma kódovú základňu — prečíta `package.json`, `README.md` a konfiguračné súbory — a doplní chýbajúce časti. Nakoniec zobrazí návrh, ktorý môžete pred uložením upraviť. Viac o konfigurácii Claude Code pri zakladaní projektu nájdete v [samostatnom sprievodcovi](https://ailoot.ai/blog/sk/spec-kit-claude-code-spec-driven-development/).
Teraz nevýhoda. Ak už projekt obsahuje aktívny súbor `AGENTS.md`, príkaz `/init` vedľa neho vytvorí súbor `CLAUDE.md` s kópiou jeho pravidiel. Od tej chvíle Claude Code štandardne číta iba `CLAUDE.md`, takže opäť existujú dva zdroje pravdy: vy aktualizujete `AGENTS.md`, zatiaľ čo Claude naďalej pracuje so starou kópiou. Príkaz `/import` robí niečo podobné: do `CLAUDE.md` pridá jednorazovú kópiu súboru `AGENTS.md`. Ak chcete zachovať jediný zdroj, po príkaze `/init` vložte na prvý riadok súboru `CLAUDE.md` import `@AGENTS.md` a odstráňte z `CLAUDE.md` všetko, čo opakuje obsah súboru `AGENTS.md`.
Príkaz `/init` je správnym začiatkom nového projektu alebo projektu, ktorý presúvate z Cursoru či Copilotu. Netreba na internete hľadať „najlepšiu šablónu CLAUDE.md“ — Anthropic už zohľadňuje obsah repozitára. Ak projekt už má aktívny `AGENTS.md` a nemá pravidlá iba pre Claude, `/init` nie je potrebný: Claude Code si prečíta `AGENTS.md` samo.
## Ako oddeliť spoločné pokyny od tých špecifických pre Claude?
Kľúčové zistenie
Do `AGENTS.md` vložte pravidlá, ktorým rozumie každý agent AI: na čo nesiahať, ako pomenúvať vetvy, že `.env` obsahuje tajomstvo a ktoré príkazy používať na testy. Do `CLAUDE.md` (pod import) vložte pravidlá špecifické pre Claude Code: režim plánovania, skills, hooks, odkazy na skills a názvy modelov podľa verzie. Rozlíšenie je jednoduché: ak sa pravidlo začína slovami „Claude má“, patrí do `CLAUDE.md`. Ak sa začína slovami „nástroj má“, patrí do `AGENTS.md`.
Oddeľujem ich podľa tejto zásady. Spoločné pravidlá, ktoré patria do `AGENTS.md`:
- **Na čo v kóde nesiahať.** Adresáre `.env`, `node_modules`, `prisma/migrations` (len cez `prisma migrate`), `.next/`, `.git/`.
- **Ako pomenúvať veci.** Vetvy: `feat/`, `fix/`, `chore/`. Commity: predpony `feat:`, `fix:`, `docs:` a krátky opis. Súbory komponentov v `kebab-case`.
- **Príkazy na testy/lint.** `npm run build`, `npm run lint`, `npm test`. Ktorý príkaz spustiť pred `git push`.
- **Architektonické princípy.** Čo patrí do `src/lib/`, čo do `src/components/`, kde sa nachádza obchodná logika a kde používateľské rozhranie.
- **Bezpečnosť.** Nikdy necommitujte tajomstvá. K produkčnej databáze pristupujte iba cez `prod-psql`. K produkcii cez SSH pristupujte iba pomocou aliasu `prod`, nie cez `root@IP`.
Pravidlá špecifické pre Claude, ktoré patria do `CLAUDE.md` (pod `@AGENTS.md`):
- **Režim plánovania.** Pri zmenách v rizikových adresároch (napríklad `src/billing/`) používajte `plan mode`.
- **Úroveň úsilia.** Na architektonické úlohy používajte `--effort high` a na bežnú prácu `medium`.
- **Skills.** Ktorých agentov AI a skills spúšťať v jednotlivých situáciách. Napríklad: „pri práci na sprievodcovi spustite skill `build-masterskaya-guide`.“
- **Pamäť Claude.** Čo ukladať do automatickej pamäte a čo do `CLAUDE.local.md`. Viac o pamäti Claude nájdete v [sprievodcovi pamäťou a CLAUDE.md](https://ailoot.ai/blog/sk/claude-memory-claude-md-auto-memory/).
- **Hooks.** Ak sú v `.claude/settings.json` nakonfigurované hooks, opíšte v `CLAUDE.md`, čo robia (Codex a Cursor o nich nevedia a nemusia).
- **Skills a príkazy.** Zoznam príkazov so lomkou, ktoré často používam (`/init`, `/cd`, `/memory`, `/plan`).
Hranica nie je vždy jasná. Napríklad „nikdy nespúšťajte `git push --force` do `main`“ je zjavne spoločné pravidlo, takže patrí do `AGENTS.md`. Ale „pri spúšťaní `git push` do horúcej vetvy najprv použite režim plánovania“ je špecifické pre Claude Code, takže patrí do `CLAUDE.md`. Skúška znie: „Keby som zajtra odstránil Claude Code a nechal iba Codex, platilo by toto pravidlo stále?“ Ak áno, vložte ho do `AGENTS.md`. Ak nie, vložte ho do `CLAUDE.md`.
## Čo patrí do AGENTS.md a čo do CLAUDE.md alebo .claude/rules?
Kľúčové zistenie
Pri veľkom projekte jeden súbor `AGENTS.md` nestačí — priveľmi narastie a každý agent si do kontextu načíta zbytočný materiál. Riešením je adresár `.claude/rules/` so samostatnými súbormi podľa tém a YAML frontmatter `paths:` na spúšťanie pravidiel podľa cesty. Napríklad pravidlo pre API sa uplatní iba vtedy, keď Claude pracuje v `src/api/`. Takto sa ušetrí veľa miesta v kontextovom okne. Ekvivalentom pre Cursor je `.cursor/rules/` a pre Windsurf `.windsurf/rules/`.
Ak pravidlá presiahnu 200 riadkov, je čas rozdeliť ich. Dokumentácia Anthropic odporúča cieliť na 200 riadkov na súbor, pretože pri dlhých súboroch `CLAUDE.md` Claude potichu prestáva dodržiavať pokyny: vyzerá to, že ich číta, ale riadi sa nimi menej často.
Štruktúra veľkého projektu, ktorá sa mi osvedčila:
```
my-project/
├── AGENTS.md # 100-150 lines, shared
├── CLAUDE.md # 30-50 lines: @AGENTS.md + Claude-only
└── .claude/
├── CLAUDE.md # alternative to root file, same file
└── rules/
├── api.md # with paths: ['src/api/**']
├── components.md # with paths: ['src/components/**']
├── testing.md # without paths, always active
└── security.md # without paths, always active
```
Každý súbor v `.claude/rules/` môže obsahovať frontmatter:
```markdown
---
paths:
- "src/api/**/*.ts"
---
# API rules
- Every endpoint validates input with zod
- Errors use the standard `{error, code}` format
- OpenAPI comments are required
```
Claude načítava tieto pravidlá iba pri práci so súbormi, ktoré zodpovedajú tomuto vzoru. Ak upravuje `src/components/Button.tsx`, pravidlá pre API sa do kontextu nepridajú. Kontextové okno tak využíva iba na relevantné informácie. Adresár `.claude/rules/` funguje aj bez `CLAUDE.md`: ak projekt obsahuje iba `AGENTS.md`, pravidlá sa načítajú spolu s ním a nevypnú priame čítanie súboru `AGENTS.md`.
Cursor a Windsurf podporujú rovnaký prístup prostredníctvom adresárov `.cursor/rules/` a `.windsurf/rules/`. Štandard AGENTS.md môže odkazovať na tieto adresáre, ale syntax pre rôzne nástroje ešte nie je úplne ustálená. Bezpečnejšie je ponechať spoločné pravidlá v `AGENTS.md` a pravidlá obmedzené na cesty duplikovať v `.claude/rules/` a `.cursor/rules/` — ide o zriedkavé špecifické prípady, nie o väčšinu pravidiel.
Užitočné umiestnenia pre CLAUDE.md (od najširšieho po najužšie):
| Úroveň | Umiestnenie | Účel |
|----|----|----|
| **Spravovaná politika** | `/Library/Application Support/ClaudeCode/CLAUDE.md` (Mac), `/etc/claude-code/CLAUDE.md` (Linux) | Firemné pravidlá, IT/DevOps |
| **Používateľ** | `~/.claude/CLAUDE.md` | Osobné preferencie pre všetky projekty |
| **Projekt** | `./CLAUDE.md` alebo `./.claude/CLAUDE.md` | Pravidlá projektového tímu |
| **Lokálne** | `./CLAUDE.local.md` (v `.gitignore`) | Osobné preferencie pre konkrétny projekt |
Príklad súboru `~/.claude/CLAUDE.md` môže obsahovať dve pravidlá: „odpovedajte v jazyku, ktorý používateľ uprednostňuje“ a „píšte Ailoot presne takto“. Tieto pravidlá platia pre každý projekt, takže ich netreba duplikovať v každom repozitári.
Z týchto štyroch úrovní priame čítanie `AGENTS.md` vypína iba projektový `CLAUDE.md` a `CLAUDE.local.md`. Osobný `~/.claude/CLAUDE.md` ani spravovaná politika neprekážajú; Claude Code ich číta spolu so súborom `AGENTS.md`.
## Čo robiť, ak je AGENTS.md vo vašom projekte už zastaraný?
Kľúčové zistenie
Ak bol súbor `AGENTS.md` zostavený ešte v roku 2025 pre Codex alebo Aider a odvtedy ste ho neupravovali, otvorte projekt v Claude Code a požiadajte Claude, aby súbor upravilo. AGENTS.md je živý dokument; špecifikácia Linux Foundation sa aktualizuje. Hlavné pravidlo, ako ho udržiavať aktuálny: každé pravidlo musí odpovedať na otázku „Čo už ma unavuje opakovať Claude/Codexu?“ Ak neodpovedá, archivujte ho.
V opísanom projekte som mal `AGENTS.md` z mája 2025 — 180 riadkov, z ktorých mnohé boli zastarané (spomínal koncové body Anthropic API, ktoré sa odvtedy zmenili; príklady so syntaxou `claude --tools`, ktorá už neexistuje; a pravidlá pre `~/.claude/projects/` so zastaranou štruktúrou).
Postup, ktorý som použil pri jeho aktualizácii:
1. **Skontrolujte ho pomocou `claude` v režime plánovania.** Otvorím repozitár, spustím `claude --safe-mode` a požiadam: “Reread `AGENTS.md` and suggest a list of items that are outdated or repeated. Don’t edit it; list them only.” Za dve minúty som dostal zoznam 23 položiek na kontrolu.
2. **Odstráňte zjavne zastarané položky.** Z 23 položiek bolo 9 jednoznačne zastaraných — syntax príkazov, koncové body a názvy príznakov. Tieto riadky som odstránil.
3. **Spojte duplicity.** Ďalších 6 položiek opakovalo to isté inými slovami („nerobte force-push“, „nikdy nepoužívajte `--force`“, „vyhnite sa `git push -f`“). Spojil som ich do jedného riadka.
4. **Pridajte nové položky.** Pridal som to, čo som si všimol, že Claude/Codex za posledný mesiac pravidelne robili nesprávne, podľa pravidla „jeden riadok na vzor chyby“. Tak vzniklo 8 nových položiek.
5. **Na záverečnú kontrolu použite podagenta.** Požiadal som Claude o kontrolu s pokynom „nájdite rozpory, nejednoznačnosti a duplicity“. Našlo tri formulácie, ktoré sa dali spresniť. Opravil som ich.
Po hodine mal `AGENTS.md` 110 riadkov, bol aktuálny a poznal som každý riadok. Ľahko sa z neho dal vytvoriť 30-riadkový `CLAUDE.md`. Codex bolo potom pri testoch tiež viditeľne opatrnejšie — mám podozrenie, že niektoré jeho „čudné“ rozhodnutia vychádzali zo zastaraných pokynov, ktoré poctivo dodržiavalo.
Hlavné zásady živého súboru `AGENTS.md`:
- **Každé pravidlo rieši opakujúcu sa chybu.** Ak mi pravidlo ani raz počas mesiaca nenapadlo, nemá zmysel ho ponechávať.
- **Píšte pravidlá ako príkazy, nie ako teóriu.** „Použite dve medzery“ je pravidlo. „Štýl kódu má byť úhľadný“ pravidlom nie je.
- **Konkrétne pokyny majú prednosť pred všeobecnými.** „Pred `git push` spustite `npm run build`“ je pravidlo. „Otestujte svoje zmeny“ pravidlom nie je.
## Čo pri tomto nastavení určite NEFUNGUJE?
Kľúčové zistenie
Import `@AGENTS.md` nespôsobí, že sa rôzne nástroje budú správať rovnako. Každý má svoje zvláštnosti: Codex CLI nepozná `.claude/rules/` ani hooks. Cursor má vlastný nástroj na automatické dopĺňanie, ktorý pri dopĺňaní textu nečíta CLAUDE.md. Copilot sa riadi súborom `.github/copilot-instructions.md` a samotné pravidlá v AGENTS.md mu nestačia. Neplatí „jeden súbor = jedno správanie“, ale „jeden zdroj základných pravidiel a potom dodatky špecifické pre každý nástroj“.
Niekoľko vecí, ktoré som sa za šesť mesiacov práce s týmto nastavením naučil ťažkou cestou:
**1. Automatické dopĺňanie Cursoru nepoužíva AGENTS.md.** Keď Cursor navrhne dokončenie riadka v editore, v reálnom čase nečíta `AGENTS.md` — pracuje tam samostatný rýchly nástroj. Pravidlá v AGENTS.md sú dôležité iba pri zadaní požiadavky v chate v rámci Cursoru. To znamená, že napísanie „nepoužívaj `var`, použi `const`“ do AGENTS.md automatické dopĺňanie neovplyvní; treba to nakonfigurovať cez ESLint alebo konfiguráciu TypeScriptu.
**2. Hooks Claude Code v AGENTS.md nefungujú pre Codex.** Ak má `.claude/settings.json` nakonfigurovaný hook PreToolUse, ktorý blokuje určitú akciu, táto informácia je užitočná iba pre Claude. Codex o hooks nevie; preň je to „nástroj rozhoduje sám“. Má zmysel napísať do `AGENTS.md` „nerob X“ a pod import do `CLAUDE.md` „existuje hook, ktorý X fyzicky blokuje“.
**3. Copilot a `.github/copilot-instructions.md`.** GitHub Copilot číta vlastný súbor a stále nečíta AGENTS.md veľmi dobre. Ak váš tím aktívne používa Copilot, pridajte buď samostatný `.github/copilot-instructions.md` so skrátenou verziou pravidiel, alebo použite [rozšírenia Copilotu](https://github.com/marketplace?type=apps&category=copilot-extensions), ktoré poznajú AGENTS.md. Situácia sa rýchlo mení, takže o tri až šesť mesiacov môže vyzerať inak.
**4. Git nesleduje symbolický odkaz ako zmenu v CLAUDE.md.** Ak spustíte `ln -s AGENTS.md CLAUDE.md` a o týždeň neskôr aktualizujete `AGENTS.md`, Git zobrazí rozdiel iba pre `AGENTS.md`. Je to normálne, ale kolega kontrolujúci PR si nemusí uvedomiť, že sa aktualizoval aj `CLAUDE.md` (cez symbolický odkaz). Riešenie: do opisu PR výslovne napíšte: „aktualizovaný súbor `AGENTS.md`; Claude Code vidí ten istý súbor cez symbolický odkaz“.
**5. Hlboké importy sa ťažko ladia.** Ak `AGENTS.md` importuje `@docs/coding-style.md`, ten importuje `@docs/typescript.md` a nejaké pravidlo je v rozpore s iným, ladenie je náročné. Importy obmedzujem na jednu úroveň (`CLAUDE.md` → `AGENTS.md`) a ďalej ich nevnáram. Anthropic poskytuje hook `InstructionsLoaded`, ktorý zaznamenáva načítané súbory — hodí sa na ladenie vrstvených nastavení. Poznámka: hook sa spúšťa pre súbor `AGENTS.md` zahrnutý cez import alebo symbolický odkaz, ale nie pre súbor `AGENTS.md`, ktorý Claude Code prečítalo samo.
### Zdroje
- [Dokumentácia Claude Code Memory - sekcia AGENTS.md](https://code.claude.com/docs/en/memory#agents-md) - kedy Claude Code číta AGENTS.md samo, nastavenia Project instructions, importy a symbolické odkazy, správanie príkazu `/init`.
- [Dokumentácia Claude Code Memory - importovanie ďalších súborov](https://code.claude.com/docs/en/memory#import-additional-files) - syntax `@path/to/file`, hĺbka štyroch úrovní, relatívne a absolútne cesty.
- [agents.md - štandard Linux Foundation](https://agents.md/) - oficiálny štandard AGENTS.md a zoznam podporovaných nástrojov.
- [Dokumentácia Cursor Rules](https://docs.cursor.com/context/rules-for-ai) - čo Cursor číta (`.cursor/rules/*.mdc`, AGENTS.md).
- [Vlastné pokyny GitHub Copilot](https://docs.github.com/en/copilot/customizing-copilot/adding-custom-instructions-for-github-copilot) - formát `.github/copilot-instructions.md`.
- [Špecifikácia AGENTS.md na Linux Foundation](https://aaif.io/projects/agents-md/) - živá špecifikácia.
Kompletné nastavenie vibe codingu na jeden večer: **klon AI + Druhý mozog + inžinierstvo kontextu**.
Spoznajte [Ailoot](https://ailoot.ai/).
## Otázky a odpovede: Jeden súbor s pokynmi pre Claude Code, Codex a Cursor v roku 2026
### Kedy použiť import namiesto symbolického odkazu?
@AGENTS.md v CLAUDE.md použite pri špecifických dodatkoch Claude či kolegoch s Windows. Symbolický odkaz spája oba názvy s rovnakým obsahom, takže nemôže mať samostatnú sekciu iba pre Claude.
### Ako overiť načítanie spoločných pokynov?
Spustite /memory a prezrite zoznam. Ak CLAUDE.md či CLAUDE.local.md potláča priame načítanie AGENTS.md, pridajte import alebo nastavte načítanie oboch a začnite novú reláciu.
## Ailoot · Spoločnosť a jej portfólio projektov
Ailoot stavia na dlhodobých prevádzkových skúsenostiach, širokej klientskej základni, stabilných službách a priebežnom sledovaní KPI.
Spoločnosť a jej portfólio projektov: milióny zákazníkov; mesačné tržby v miliardách.
Ailoot využíva tieto prevádzkové skúsenosti na poskytovanie prístupu cez API k funkciám AI v produktoch zákazníkov, agentoch, aplikáciách a automatizáciách.