CLAUDE.md – osvědčené postupy: 9 pravidel, díky kterým vás Claude přestane ignorovat (2026)

Osvědčené postupy pro CLAUDE.md: 9 pravidel, díky kterým vás Claude přestane ignorovat (2026)

Většina článků o osvědčených postupech pro CLAUDE.md vám nabídne šablonu a tím to pro ně končí – jenže soubor, který jste napsali minulý týden, už pravděpodobně Claude ignoruje, a vy netušíte proč. Řešením zřídka bývá „přidat další pravidla“. Obvykle je to přesně naopak. Nasadili jsme Claude Code na každém z posledních klientských projektů a těchto 9 pravidel je to, co skutečně přináší výsledky: hierarchie odpovídající tomu, jak Claude načítá soubory, rozpočet instrukcí, který nelze překročit, rozhodnutí ohledně AGENTS.md a šest důvodů, proč Claude uprostřed relace tiše odloží váš soubor stranou.

Klíčové poznatky

• CLAUDE.md je projektová paměť načítaná do kontextu Claude Code; udržujte ji pod 200 řádků, jinak se začnou pravidla ztrácet.
• Soubory se načítají shora dolů: globální, kořen projektu, podadresář (líně) a CLAUDE.local.md (osobní, ignorovaný gitem).
• Použijte AGENTS.md, pokud používáte i Cursor nebo Copilot; vytvořte symbolický odkaz z CLAUDE.md na AGENTS.md a zacílíte na oba nástroje.
• Pokud Claude váš soubor ignoruje, v 90 % případů je příčinou délka, vágnost nebo chybějící „proč".

Co CLAUDE.md ve skutečnosti dělá (a proč na tom záleží)

Stručně řečeno: CLAUDE.md je markdownový soubor, který Claude Code načítá jako paměť projektu na začátku každé relace. Není to systémový prompt, hook ani skill – je to poradní kontext, který Claudea směřuje ke konvencím vašeho týmu. Berte ho méně jako dokumentaci a více jako konfigurační soubor, který váš AI párový programátor skutečně čte.

Spousta týmů píše CLAUDE.md jako README. To je první chyba. README vysvětluje projekt lidem, kteří mohou text přelétnout a části přeskočit. CLAUDE.md Claude Code na začátku relace zkonzumuje celé – každý řádek stojí tokeny i dodržování. Je mnohem blíže konfiguračnímu souboru nebo sadě testovacích fixtur než dokumentaci.

Také to není jediný způsob, jak Claudea řídit. Hooky spouštějí deterministické akce (formátování, blokování commitů). Skilly sdružují znovu použitelné pracovní postupy. CLAUDE.md stojí mezi nimi jako poradní kontext – Claude ho vyhodnocuje, někdy ho přepíše, a pokud toho napíšete příliš, rozhodně na části zapomene. Toto rozlišení je základem všeho, co následuje, a je důvodem, proč je CLAUDE.md jedním z nástrojů širší praxe inženýrství kontextu, nikoli stříbrnou kulkou.

Pravidlo č. 1: Zacházejte s ním jako s kódem, ne jako s dokumentací. Verzujte ho. Revidujte ho v PR. Prořezávejte ho stejně, jako byste refaktorovali nabobtnalý modul. Podle průvodce CLAUDE.md od Anthropicu se soubor načítá se stejnou prioritou jako jakákoli systémová instrukce, což znamená, že zastaralé pravidlo staré šest měsíců stále aktivně formuje každou dnešní odpověď.

Jak se načítá CLAUDE.md: čtyřúrovňová hierarchie

Stručně řečeno: Claude Code načítá CLAUDE.md ze čtyř úrovní: globální (~/.claude/CLAUDE.md), kořen projektu, CLAUDE.local.md pro osobní přepisy a soubory v podadresářích, které se líně načítají pouze tehdy, když Claude čte soubory uvnitř daného adresáře. Sousední podadresáře si navzájem nikdy nevidí do CLAUDE.md, což udržuje paměť claude code úzce vymezenou.

Hierarchie je zdaleka nejnepochopenější částí CLAUDE.md a právě v ní se žádný z pěti nejlepších výsledků ve vyhledávání nepouští do hloubky. Tady je, co se ve skutečnosti děje pod kapotou:

Dva pojmy, které stojí za to si ujasnit: líné načítání a izolace sousedních adresářů.

Líné načítání znamená, že CLAUDE.md v podadresáři nevstoupí do kontextu Claude, dokud Claude ve skutečnosti neotevře soubor uvnitř tohoto adresáře. Pokud požádáte „oprav ten bug v přihlášení" a Claude se dotýká pouze backend/, váš frontend/CLAUDE.md se nikdy nenačte. To je dobře, udržuje to kontextové okno čisté, ale kouše to týmy, které umístí kritická pravidla do podadresářů a očekávají, že budou platit vždy.

Izolace sousedních adresářů je důsledek: frontend/CLAUDE.md a backend/CLAUDE.md se navzájem nikdy nenačtou. Sdílejí pouze to, co je v kořeni projektu. Takže pokud si vaše pravidla pro frontend protiřečí s pravidly pro backend, je to v pořádku. Pokud potřebují sdílet nějakou konvenci, vytáhněte ji nahoru do kořenového souboru.

CLAUDE.local.md je únikový východ. Načítá se, ale necommituje se — ideální pro přepisy ve stylu „já dávám přednost pnpm, ale tým se standardizoval na npm". Háček: není automaticky v gitignore. Musíte si ho přidat sami. Zapomeňte na to a commitnete svá osobní pravidla do týmového repozitáře. Pravidlo č. 4: Umístěte instrukce tam, kde je Claude skutečně čte. Pravidla stylu pro React komponenty patří do frontend/CLAUDE.md, ne do kořenového adresáře. Pravidla pro databázové migrace patří do backend/. Dokumentace Anthropic Memory (aktualizováno v listopadu 2025) to potvrzuje – chování lazy-load je záměrné a nezbytné pro funkčnost.

Co dát do CLAUDE.md (a co vynechat)

Stručně řečeno: Do CLAUDE.md patří vše, co Claude nedokáže odvodit z vašeho kódu: buildovací příkazy, konvence pojmenování, antipatterny, na kterých se váš tým spálil, a proč stojící za každým pravidlem. Ven patří vše, co je v README, vše v package.json a jakékoli pravidlo, které se mění každý týden. claude code instructions by měly být testovatelné a konkrétní.

Tady je minimální CLAUDE.md, který skutečně odvádí svou práci:

# Projekt: techsy-app
## Příkazy
- Build: `pnpm build` (Turbopack — příznaky Webpacku zde neplatí)
- Test: `pnpm test --run` (používáme Vitest, ne Jest)
- Lint: `pnpm lint` (CI selže i při varováních, nejen při chybách)
## Konvence
- Ve výchozím stavu používejte serverové komponenty. `'use client'` přidávejte jen tehdy, když je to skutečně nutné.
  Proč: V minulém čtvrtletí jsme kvůli nadměrnému přesouvání logiky na klienta narazili na LCP 8 s.
- K databázi přistupujte výhradně přes helpery v `lib/db/` — v routách nikdy nepište surové SQL.
  Proč: V těchto helperech jsou definovány zásady zabezpečení na úrovni řádků.
- Testy umisťujte jako soubory `*.test.ts` vedle testovaného souboru.
## Co nedělat
- Nepřidávejte novou závislost, aniž byste nejprve otevřeli komentář k PR.
- Nepoužívejte `any` — použijte `unknown` a typ zúžte.
## Kde hledat
- Schéma: `db/schema.ts`
- Autentizační tok: `lib/auth/README.md`

Now compare that to the anti-pattern version most teams ship:

# Pravidla projektu

- Pište čistý, udržovatelný kód.
- Dodržujte osvědčené postupy.
- Používejte TypeScript správně.
- Ujistěte se, že testy procházejí.
- Buďte konzistentní s existujícími vzory.
- Dokumentujte složitou logiku.

Druhý soubor není špatný. Je prostě zbytečný. Claude už chce psát čistý kód. „Buďte konzistentní" Claude neříká, se kterým vzorem má být konzistentní. Veřejné příklady Borise Chernyho, inženýra z Anthropicu, se silně přiklánějí k prvnímu stylu: konkrétní příkazy, pojmenované nástroje a proč za rozhodnutími, která nejsou ze samotné kódové báze zřejmá.

Pravidlo č. 2: Buďte konkrétní, ne aspirační. „Pište čistý kód" je aspirační. „Serverové komponenty jako výchozí; 'use client' přidejte pouze tehdy, když je to opravdu potřeba" je testovatelné. Stejná disciplína je základem dobrého prompt inženýrství: konkrétní, testovatelné instrukce porážejí vágní přání, ať už se nacházejí v promptu, nebo v CLAUDE.md.

Pravidlo č. 3: Vysvětlete, proč je každé pravidlo důležité. „Proč" není vata, je to způsob, jak se Claude rozhoduje v okrajových případech. Pravidlo s důvodem („narazili jsme na 8s LCP kvůli přemíře kódu na straně klienta") se zobecňuje na podobné situace. Pravidlo bez důvodu se ignoruje ve chvíli, kdy se změní kontext. Tento vzor je zdokumentován také v průvodci CLAUDE.md od Builder.io.

Proč Claude ignoruje váš CLAUDE.md? Rozpočet na instrukce

Ve zkratce: Claude není zlomyslný, jen mu dochází pozornost. Zhruba po 80 řádcích si začnete všímat, že pravidla vypadávají; po 200 řádcích se velké bloky zcela ignorují; po 500 slovech hustých pravidel se dodržování hroutí. Řešením je rozpočet na instrukce. Každý řádek vnímejte jako náklad na paměť claude code a dodržování jednotlivých pravidel.

Nedávný výzkum potvrzuje to, co uživatelé v produkci opakovaně zjišťují: schopnost řídit se instrukcemi klesá s počtem pravidel nelineárně. Článek na arXivu 2507.11538 o kapacitě pro řízení se instrukcemi ukazuje, že míra dodržování jednotlivých pravidel klesá s tím, jak je vrstvíte, a analýza HumanLayer o CLAUDE.md v produkci potvrzuje stejný závěr.

Přeloženo: každé pravidlo, které přidáte, mírně sníží pravděpodobnost dodržení všech ostatních pravidel. CLAUDE.md o 400 řádcích tedy není 4× účinnější než ten o 100 řádcích. Často je méně účinný, protože pravidla, na kterých vám skutečně záleží, se ředí těmi, která jste napsali v pátek před třemi měsíci a nikdy nesmazali.

V našich souborech CLAUDE.md se cokoliv po 150. řádku začne viditelně hůře dodržovat. Na 250. řádku jsme viděli, jak Claude přeskakuje celé sekce. Takže stanovujeme limit.

wc -l CLAUDE.md

To je celý nástroj. Spusťte ho. Pokud jste přes 200, jste přes rozpočet. Pevné pravidlo, které dodáváme klientům:

Vnímejte CLAUDE.md jako rozpočet 200 řádků. Každý řádek vás stojí dodržování. Utrácejte ho tam, kde na tom záleží.

Pravidlo #1 posíleno: Buďte struční. Pod 200 řádků. Pod 500 slov hustých pravidel. Pokud zjistíte, že chcete přidávat automatizační pravidla („vždy spusťte prettier po úpravách“), ta pravděpodobně patří spíše do hooků Claude Code, hooky jsou deterministické a nestojí tokeny z rozpočtu na instrukce.

Používat CLAUDE.md, AGENTS.md, .cursorrules, nebo copilot-instructions?

Stručně řečeno: Pokud používáte pouze Claude Code, CLAUDE.md stačí. Pokud používáte dva a více agentních CLI (Codex, Cursor, Copilot, Sourcegraph), přejděte na AGENTS.md a vytvořte symbolický odkaz z CLAUDE.md na AGENTS.md. AGENTS.md se na konci roku 2025 etablovalo jako standard napříč nástroji a většina moderních agentů ho používá jako záložní variantu, takže jediný soubor zásobuje všechny ekosystémy.

Tohle je nultá otázka, na kterou top 5 výsledků skutečně odpovídá. Zde je matice:

Trik pro dva cíle je na jeden řádek:

ln -s AGENTS.md CLAUDE.md

A je to. Nyní Claude Code, Codex a jakýkoli nástroj podporující AGENTS.md čtou stejný soubor. Aktualizujete jednou a každý agent změny převezme. Specifikace AGENTS.md je otevřená a záměrně minimalistická — je to jen markdown s konvenčními sekcemi.

Dva zádrhele z praxe. Za prvé: pokud má váš tým power usera Cursoru, .cursorrules od Cursoru volí jiný přístup — jeden soubor, žádná hierarchie, rigidnější formát. Některé týmy udržují obojí: AGENTS.md pro sdílená pravidla, .cursorrules pro specifika Cursoru. Za druhé: .github/copilot-instructions.md od Copilotu nefallbackuje na AGENTS.md, takže týmy silně spoléhající na Copilot potřebují samostatný soubor.

Pokud si sestavujete agentní stack od nuly, náš rozbor Claude Code vs Cursor vs Copilot pokrývá kompromisy na úrovni použití. Krátká verze: hierarchie Claude Code je nejvýkonnější pro monorepa, UX Cursoru vítězí pro sólovou práci a integrace Copilotu do IDE je stále nejhladší pro postupné nasazování.

Pravidlo č. 9: Používejte AGENTS.md, pokud provozujete více než jeden agentní CLI. Neudržujte dva soubory říkající totéž. Vyberte soubor, který čte většina vašeho stacku, a na zbytek vytvořte symbolické odkazy.

CLAUDE.md vs. hooks vs. skills: Rozhodovací trojúhelník

Shrnutí: CLAUDE.md = doporučující kontext. Hooks = deterministické akce. Skills = zabalené schopnosti. Vyberete-li špatně, budete plýtvat rozpočtem instrukcí na něco, co by měl řešit hook, nebo napíšete do CLAUDE.md pravidlo pro něco, co dokáže dodat jen skill. Tento trojúhelník je nejlevnější způsob, jak udržet CLAUDE.md štíhlý.

Tři nástroje, tři úkoly. Nejčastější chyba, se kterou se setkáváme: dát do CLAUDE.md pravidlo „vždy po úpravě spusť prettier". Claude si to přečte. Claude prettier spustí občas. Vy jste frustrovaní. Řešením je přesunout tento řádek z CLAUDE.md do hooku, protože hooky se spouštějí deterministicky pokaždé, bez jakéhokoli prostoru pro vlastní interpretaci.

Pokud se pravidlo musí spustit vždy, patří do hooku. Pokud jde o stylistickou předvolbu, kterou Claude dokáže vyhodnotit v kontextu, patří do CLAUDE.md. Pokud jde o vícekrokový workflow se zabalenými assety (šablony, skripty, prompty), patří do skillu.

Pravidlo č. 8: Správně vybírejte mezi CLAUDE.md, hooky a skilly – vložení hooku do CLAUDE.md je nejčastějším plýtváním rozpočtem instrukcí. Deterministické akce konfigurujte pomocí hooků Claude Code a znovupoužitelné workflow balíčkujte jako skilly Claude. Váš CLAUDE.md bude kratší, vaše mantinely budou pevnější a Claude přestane „zapomínat" na pravidla, na kterých záleží.

Vzory pro monorepo: vnořené CLAUDE.md, @importy a .claude/rules/

Stručně: V monorepu udržujte kořenový CLAUDE.md malý, jen s odkazy a sdílenými konvencemi. Specifika přesuňte do apps/*/CLAUDE.md, aby každý podstrom měl vlastní pravidla. Ke sdílení modulárních souborů pravidel přes .claude/rules/ používejte @importy. Jde o progresivní zpřístupňování — Claude si každý díl načte, jen když je relevantní.

Typický strom CLAUDE.md v monorepu:

.
├── CLAUDE.md                        # 30 lines — points to subdirs and shared rules
├── .claude/
│   └── rules/
│       ├── style.md
│       ├── testing.md
│       └── security.md
├── apps/
│   ├── web/
│   │   └── CLAUDE.md                # Next.js-specific rules
│   └── api/
│       └── CLAUDE.md                # Fastify-specific rules
└── packages/
    └── shared/
        └── CLAUDE.md                # Library author rules

Syntaxe @import umožňuje kořenovému souboru načíst sdílené části pravidel, aniž by se opakovaly:

# Kořenový CLAUDE.md

Toto je Turborepo. Pravidla specifická pro aplikaci najdete v souboru CLAUDE.md v podadresáři.

@import .claude/rules/style.md
@import .claude/rules/testing.md
@import .claude/rules/security.md
## Příkazy nejvyšší úrovně
- `pnpm dev` spustí všechny aplikace paralelně
- `pnpm test` spustí testovací skript každého workspace

Toto je progresivní odkrývání v praxi. Kořenový soubor je 30řádkový ukazatel. Každý CLAUDE.md v podadresáři přidává 50–80 řádků zaměřených pravidel. Soubory v .claude/rules/ obsahují bloky konvencí, které si mohou načítat různé podadresáře. Nic se neduplikuje, nic se nepřehlédne a žádný jednotlivý soubor nepřekročí rozpočet instrukcí.

Pravidlo o líném načítání z předchozí části je zde ještě důležitější: když Claude pracuje na apps/web/Button.tsx, vidí kořenový soubor plus apps/web/CLAUDE.md plus soubory pravidel načtené přes @import. Nevidí apps/api/CLAUDE.md. To je přesně ten smysl, konvence backendu neznečišťují kontext frontendu a vaše kontextové okno zůstává použitelné.

Pravidlo č. 6: Používejte @import, aby kořenový soubor zůstal pod 200 řádky. Průvodce Anthropic Best Practices for Claude Code považuje tento přístup za standardní vzor pro monorepo. Subagenti také dědí kontext nadřazeného CLAUDE.md, což stojí za vědění, pokud vnořujete workflow – viz context engineering, kde se dozvíte, jak to souvisí s návrhem subagentů.

6 důvodů, proč Claude ignoruje váš soubor (a řešení pro každý z nich)

Ve zkratce: Když Claude ignoruje CLAUDE.md, téměř vždy jde o jednu ze šesti příčin: soubor je příliš dlouhý, vágní formulace, chybějící zdůvodnění „proč", zhutnění kontextu, konfliktní nadřazený soubor, nebo nesprávný název souboru. Každá z nich má řešení na 60 sekund. Po každé změně proveďte test v nové relaci – to je pravidlo č. 7.

1. Soubor je příliš dlouhý (>200 řádků / >500 slov)

Spusťte wc -l CLAUDE.md. Pokud přesahuje 200 řádků, razantně ho zkraťte. Pravidla automatizace přesuňte do hooks. Workflow přesuňte do skills. Sdílené části rozdělte do .claude/rules/ a načítejte je pomocí @import. Nejčastější důvod, proč Claude „přestal dodržovat" vaše pravidla, je ten, že soubor časem příliš nabyl a dodržování pravidel se potichu zhroutilo.

2. Nejasné formulace („pište čistý kód“)

Nahraďte každé aspirační pravidlo konkrétním a testovatelným. „Buďte konzistentní“ je pro Claude neviditelné. „Ve výchozím nastavení používejte serverové komponenty; 'use client' přidejte pouze pro formuláře nebo interaktivní UI“ je něco, co Claude dokáže skutečně aplikovat.

3. Chybějící „proč"

Pravidla bez zdůvodnění se nedají zobecňovat. Claude nedokáže odvodit, kdy pravidlo ohnout, protože neví, před čím ho pravidlo chrání. Každé neoczyvidné pravidlo dostane jednořádkové vysvětlení: „používáme unknown, ne any, protože minulý kvartál jsme měli tři runtime pády kvůli odpovědím API typovaným jako any."

4. Kompakce kontextu ho zahodila

Dlouhé relace spouštějí kompakci, Claude shrne dřívější kontext, aby se vešel do okna, a obsah CLAUDE.md se někdy shrne do zapomnění. Řešení: /clear po velkém vyčerpání kontextu, nebo restartovat celou relaci. Přesně tento problém neustále vyplouvá na povrch v GitHub Issue #17530.

5. Konfliktní nadřazený CLAUDE.md

Globální říká „používej 4 mezery“. Kořen projektu říká „používej 2 mezery“. Podadresář neříká nic. Claude si vybere jednu, někdy tu špatnou. Zkontroluj ~/.claude/CLAUDE.md a kořen projektu na rozpory. Měl by vyhrát ten konkrétnější, ale jen pokud to výslovně nastavíš.

6. Nesprávné umístění souboru nebo velikost písmen v názvu souboru

Claude.md a CLAUDE.md jsou na Linuxu a macOS různé soubory. Stejně tak claude.md a CLAUDE.md. Ověřte, že cesta je přesně ./CLAUDE.md (vše velká písmena), a že Claude Code je spuštěn z adresáře, který tento soubor obsahuje. Issue #668 na GitHubu je plná případů, kdy soubor existoval, ale Claude ho kvůli cestě neviděl.

Pravidlo #7: Testujte v nové relaci. Po jakékoli změně v CLAUDE.md otevřete novou relaci a požádejte Claude, aby „shrnul pravidla v CLAUDE.md". Pokud shrnutí něco vynechá, soubor nesplňuje svůj účel.

Váš první CLAUDE.md za 10 minut: návod v 5 krocích

Ve zkratce: Spusťte /init pro vygenerování konceptu, prořežte ho na 6–10 skutečných pravidel s odůvodněním, přidejte 3 příkazy, které by měl Claude znát, přidejte 2 antipatterny, na které váš tým narazil, a pak to otestujte v nové relaci tím, že Clauda požádáte o shrnutí souboru. Celkový čas: asi 10 minut. Tento návod v 5 krocích používáme první den v každém novém repozitáři.

1. Spusťte /init pro vygenerování konceptu. Příkaz /init v Claude Code prohledá váš repozitář a zapíše základní CLAUDE.md. Nenasazujte to, co vygeneruje. Výstup /init je výchozí bod, ne hotový soubor, a upřímně, většina toho, co vygeneruje, může jít pryč.

2. Prořežte ho na 6–10 řádků skutečných pravidel s odůvodněním. Smažte vše obecné. Smažte vše, co je v README. Ponechte pouze pravidla, která si Claude nemůže odvodit ze samotného kódu.

3. Přidejte 3 příkazy, které by měl Claude znát. Build, test, lint. Uveďte přesný příkaz a všechny nezřejmé přepínače. Pokud používáte Vitest a ne Jest, napište to.

4. Přidejte 2 antipatterny, na které tento tým narazil. Skutečné. „Nepoužívej any, protože jsme měli tři pády za běhu" je vždycky lepší než „používej TypeScript správně".

5. Otevřete novou relaci a ověřte. Požádejte Clauda: „Shrň pravidla v CLAUDE.md." Pokud něco vynechá, soubor je příliš dlouhý, příliš vágní nebo v něm chybí „proč". Opravte a zopakujte.

Pravidlo č. 5: Negenerujte automaticky pouze z /init. /init je výchozí bod, ne hotový soubor. Těch 8 minut, které strávíte jeho prořezáváním, je to, kde je ta hodnota.

Často kladené dotazy

Co je soubor CLAUDE.md?

Soubor CLAUDE.md je markdownový soubor, který Claude Code načítá jako paměť projektu na začátku každé relace. Předává Claudovi vaše konvence, příkazy a antipatterny, aby nemusel nic odhadovat. Funguje ve čtyřech úrovních: globální, kořen projektu, podadresář (líně načítaný) a osobní CLAUDE.local.md, který máte v gitignore.

Jak dlouhý má být soubor CLAUDE.md?

Méně než 200 řádků a méně než 500 slov hutných pravidel. Za těmito hranicemi se schopnost Clauda řídit se instrukcemi zhoršuje – každé pravidlo, které přidáte, mírně snižuje pravděpodobnost, že se budou dodržovat ta ostatní. Berte to jako pevný rozpočet. Pokud potřebujete více, rozdělte pravidla do souborů CLAUDE.md v podadresářích a pro sdílené části použijte @import.

Kam mám umístit CLAUDE.md?

Hlavní soubor patří do kořenového adresáře projektu (./CLAUDE.md) a commituje se. V monorepech přidejte soubory CLAUDE.md do podadresářů pro pravidla specifická pro jednotlivé aplikace. Předvolby platné napříč projekty uložte do ~/.claude/CLAUDE.md. Soubor CLAUDE.local.md použijte pro osobní přepsání, která nechcete commitovat, ale nezapomeňte jej ručně přidat do gitignore.

Proč Claude ignoruje můj CLAUDE.md?

V 90 % případů jde o jednu ze tří věcí: soubor je příliš dlouhý (přes 200 řádků), pravidla jsou vágní („write clean code“), nebo pravidlům chybí „proč“, o které se může Claude při jejich uplatňování opřít. Spusťte wc -l CLAUDE.md a poté zkontrolujte, zda jsou pravidla dostatečně konkrétní. Změny otestujte v nové relaci tak, že Clauda požádáte, aby soubor shrnul.

Mám použít CLAUDE.md, nebo AGENTS.md?

Pokud váš tým používá výhradně Claude Code, zůstaňte u CLAUDE.md. Pokud používáte dva nebo více agentů CLI (Codex, Cursor, Sourcegraph), přejděte na AGENTS.md a nastavte CLAUDE.md jako symbolický odkaz na něj: ln -s AGENTS.md CLAUDE.md. Většina moderních CLI agentů používá AGENTS.md jako záložní soubor, takže jediný soubor obslouží všechny nástroje.

Mám spustit /init pro vygenerování CLAUDE.md?

Ano, jako koncept. Ne, jako hotový soubor. /init proskenuje váš repozitář a vytvoří počáteční verzi, ale je upovídaná a obecná. Anthropic i HumanLayer doporučují po spuštění /init důrazně zkrátit. Těch 8 minut, které strávíte proškrtáváním a přidáváním řádků s „proč", je přesně to, čím se soubor stává skutečně užitečným.

Jak fungují soubory CLAUDE.md v monorepu?

Kořenový CLAUDE.md zůstává malý, obsahuje pouze odkazy a sdílená pravidla. Každá aplikace má vlastní apps/*/CLAUDE.md se svými konvencemi. Soubory v podadresářích se načítají lazy-load způsobem, až když Claude čte soubory v daném podstromu, takže sousední aplikace zůstávají izolované. Pomocí @import .claude/rules/style.md můžete sdílet modulární části pravidel, aniž byste je museli duplikovat napříč aplikacemi.

Jaký je rozdíl mezi CLAUDE.md, hooky a skilly?

CLAUDE.md je doporučující kontext – Claude si ho přečte a obvykle se jím řídí. Hooky jsou deterministické akce, které se spustí vždy (formátování, blokování commitů). Skilly jsou balíčky schopností pro opakovaně použitelné pracovní postupy s assety. CLAUDE.md používejte pro stylistická doporučení, hooky pro pevná pravidla a skilly pro vícekrokové úlohy, které budete opakovat napříč projekty.

Jak k tomu přistupujeme v Techsy

V Techsy má každý projekt s Claude Code, který dodáváme, soubor CLAUDE.md do 150 řádků a symlink AGENTS.md. Chováme se k tomuto souboru jako ke kódu, verzujeme ho, kontrolujeme změny v PR a před sloučením znovu testujeme v nových relacích. Potřebujete pomoci s napojením AI agentů na váš vývojový workflow? Získejte bezplatnou konzultaci.