Ako nastaviť CLAUDE.md v roku 2026: šablóna a 6 pravidiel

Materiály o vibe codingu: nástroje, prípadové štúdie, chyby. Sprievodcovia Ailoot.

Prečo potrebujete CLAUDE.md a prečo bez neho Claude zabúda na projekt?#

V utorok otvoríte Claude Code a vysvetlíte: „Pracujem na tomto projekte, toto sú nástroje, toto nerob.“ Funguje to.

Vo štvrtok sa ten istý chat už skončil, takže všetko opakujete. V sobotu znova; v pondelok ešte raz.

Takto vyzerá práca s agentom bez CLAUDE.md: každé nové okno je stážista bez predchádzajúcich skúseností, ktorému musíte stále dookola hovoriť to isté. Kedysi som na toto úvodné vysvetľovanie v každej relácii míňal 5-10 minút. Výzvy boli dlhé, pretože som musel všetok kontext prenášať ručne. A výsledok bol aj tak všeobecný: agent nepoznal moje publikum, ekonomiku ani zásady.

So živým CLAUDE.md úvodné vysvetľovanie odpadá. Všetky pravidlá, ktoré ste opakovali v každom chate, sú v jednom súbore a automaticky sa zobrazia na začiatku každej relácie. Výzva je krátka: „urob X“, namiesto „pracujem na projekte Y, nástroje sú Z, nerob A ani B a, mimochodom, pamätaj aj na C“.

Potom prestanú opakované chyby.

Každá chyba agenta je dôvodom pridať do CLAUDE.md jeden riadok. Po mesiaci máte živú „ústavu projektu“ a Claude prestane padať do tých istých známych pascí.

A je tu tretia vrstva: agent prestane písať do prázdna. Prostredníctvom CLAUDE.md smerujem Claude do priečinkov s kontextom: kde hľadať informácie o publiku, cenách a značke. Bez tohto smerovania agent píše „kvalitné riešenia“ bez znalosti mojej ekonomiky, takže sú abstraktné, šablónovité a „ako všetky ostatné“.

Čo je CLAUDE.md a v akom poradí ho Claude číta?#

Anthropic opisuje CLAUDE.md vo svojej oficiálnej dokumentácii takto:

Štyri miesta, kde Claude Code hľadá CLAUDE.md, zoradené vzostupne podľa priority:

Všetky štyri súbory sa načítajú do kontextu naraz. Ak si pravidlá odporujú, Anthropic vo svojej dokumentácii priamo uvádza, že nie je známe, ktoré z nich dostane prednosť; Claude si môže jedno vybrať svojvoľne. Preto je jednoduchšie ponechať všetko dôležité v projektovom CLAUDE.md a nevytvárať duplikáty.

Je tu jeden technický detail, o ktorom takmer nikto nepíše, no vysvetľuje mnohé zvláštne správanie.

Inými slovami, CLAUDE.md nie je „systémový prompt“ v prísnom zmysle. Je to prvá používateľská správa, ktorú Claude vidí. Jeho pravidlá sú teda dôrazné odporúčania, nie zákony. Ak pravidlo potrebuje vynucovanie, použite otestovaný hook pre pokrytú udalosť a na širšie hranice prístupu oprávnenia či izoláciu prostredia. Automatické spustenie hooku nerobí jeho kontroly úplnými. Hranicu medzi hooks a CLAUDE.md vysvetlím nižšie.

Ako napísať minimálny CLAUDE.md za 5 minút (pripravená šablóna)?#

Nižšie je šablóna, ktorú som otestoval v desiatkach svojich projektov. Súbor má približne 80-120 riadkov, teda v súlade s odporúčaním Anthropic snažiť sa zostať pod 200 riadkami. S touto šablónou agent prináša najrozumnejšie výsledky.

# [PROJECT NAME] - project navigation

This document is the project map. Read it at the start of every session
to understand where things are and how to work with them.

## What this project is

**[NAME]** - [one sentence: what it is and who it’s for].
[1-2 sentences: what problem it solves and how].

Details are in `business/INDEX.md`.

## Reading order at the start of every session

1. `about-me/INDEX.md` - who I am and how I think
2. `business/INDEX.md` - what we do (product, audience, economics)
3. `CLAUDE.md` (this file) - repo rules, tools, navigation
4. Task area: the relevant file from `business/`, `plans/<current plan>`,
   `mastery/<area>` or the feature folder in the code

Principle: layer 1 (about me) comes before layer 2 (business) for a reason.
First, **who** is thinking, then **about what**.

## Repository structure

[NAME]/
├── CLAUDE.md            ← this file, navigation
├── about-me/            ← digital projection of you (how you think, what you value)
│   └── INDEX.md
├── business/            ← the business’s second brain
│   ├── INDEX.md
│   ├── audience/        ← customer profile
│   ├── products/        ← products, prices
│   ├── goals/           ← goals, metrics
│   └── economics/       ← unit economics, revenue
├── plans/               ← technical plans (one plan = one feature)
├── retrospectives/      ← reflections after each session
└── (project code)

### Where to find things

| What you need | Where to look |
|---|---|
| Why we’re building the project, and for whom | `business/INDEX.md` |
| Target customer, pains, desires | `business/audience/` |
| Product, plans, prices | `business/products/` |
| Goals and metrics | `business/goals/` |
| Economics | `business/economics/` |
| Technical plans | `plans/` |

## Tools

[INSERT TOOLS - for example: Next.js 14, TypeScript, Tailwind CSS, Prisma + PostgreSQL].

## Repo rules

1. Never hardcode dynamic data (prices, dates, figures) -
   get everything from files in `business/` and the LIVE marker.
2. Don’t publish without my explicit command.
3. Before `git push`, run `npm run build` and check that it
   builds without errors or warnings.
4. Add files by name with `git add`. Never use `git add .` or `git add -A`.
5. Don’t read `.env` in full. To check a variable, use
   `grep "^VAR=" .env`.

## Big features = a plan in `plans/`

Any task lasting more than an hour must be written up as a plan in the `plans/` folder:
1. Filename: `YYYY-MM-DD-feature-name.md`.
2. Divide the plan into phases. Mark each phase `[ ]` or `[x]`.
3. At the end of the plan, add a summary: whether it was fully implemented and what remains.

## End-of-feature cycle

After each feature is complete, go through these 5 steps:
1. Find errors → prove them with an example → fix them.
2. What was missed (edge cases, input validation, error handling).
3. Is this a real problem in our project? Check `business/` and `plans/`.
4. Take a fresh look: reread the diff as if you’re seeing it for the first time.
5. Security review. Especially: personal data and third-party materials.

## End-of-session reflection

In `retrospectives/YYYY-MM-DD_short-name.md`, record:
1. What the task was.
2. How it was solved.
3. Whether it was solved - yes / no / partially.
4. What could have been done better.
5. What was learned about the user or project.

## Language

Always respond in the user’s preferred language. Use hyphens only, not em dashes.

Ak chcete, aby Claude túto šablónu pre váš projekt automaticky vyplnilo, zadajte mu túto výzvu. Prečíta si kontext a doplní polia v hranatých zátvorkách:

Vytvor súbor CLAUDE.md v koreňovom priečinku projektu podľa tejto šablóny:

[VLOŽ CELÚ ŠABLÓNU ZOZAČIATKU]

Postupuj takto:

Prečítaj about-me/INDEX.md a business/INDEX.md, aby si pochopil kontext projektu a mňa ako autora.

Vyplň všetky polia v hranatých zátvorkách podľa toho, čo nájdeš v týchto priečinkoch.

Ak niektoré informácie chýbajú, pýtaj sa ma na objasňujúce otázky po jednej a ponúkni 3-4 možnosti odpovede.

Snaž sa udržať výsledný CLAUDE.md pod 200 riadkami. Ak je dlhší, skontroluj duplicity a podrobné postupy presuň do prepojených súborov. Zachovaj podstatné pravidlá plánovania, retrospektívy a repozitára a potom ich otestuj na reprezentatívnych úlohách.

Ukáž mi výsledný súbor a opýtaj sa, čo treba upraviť.

Vždy odpovedaj v jazyku, ktorý používateľ uprednostňuje.

Ak ešte nemáte priečinky about-me/ a business/, nevadí. Claude vám položí objasňujúce otázky a zostaví minimálny CLAUDE.md podľa dostupných informácií. Priečinky môžete vytvoriť neskôr, keď budete vedieť, čo do nich vložiť.

Ktorých 6 pravidiel z CLAUDE.md urobí živý dokument?#

Pravidlo 1. Udržujte ho pod 200 riadkami

Anthropic to vo svojej oficiálnej dokumentácii hovorí stručne:

Dlhý CLAUDE.md pôsobí proti sebe dvoma spôsobmi. Po prvé, míňa tokeny. Súbor pokynov s 800 riadkami sa načíta do každého okna a v každej relácii spotrebuje niekoľko tisíc tokenov z vášho limitu. Pri predplatnom Pro s denným limitom to citeľne znižuje počet dostupných relácií. Po druhé, model začína pravidlá ignorovať.

Dokumentácia odporúča cieliť pod 200 riadkov, aby sa znížila spotreba kontextu a zlepšilo dodržiavanie pokynov. Neurčuje ostrú hranicu zlyhania pri riadku 201. Pred presunutím obsahu posúďte relevantnosť, rozpory, objem načítaných tokenov a skutočné výsledky úloh.

Pravidlo 2. Každú reláciu ukončite retrospektívou

Do CLAUDE.md napíšte: „Na konci každej relácie zaznamenaj, čo si urobil a naučil, do retrospectives/YYYY-MM-DD_*.md.“ Keď tento riadok pridáte, Claude začne každú reláciu samo ukončovať retrospektívou; nemusíte o ňu žiadať.

Prečo robiť retrospektívu:

• O dva týždne môžete otvoriť starú retrospektívu a spomenúť si, prečo ste si zvolili daný postup.
• Keď sa po mesiaci vrátite k projektu, budete mať pripravenú mapu nedávnych rozhodnutí.
• Ak pracujete v tíme, partner si môže retrospektívu prečítať a za 2 minúty pochopiť aktuálny stav bez hovoru.

Pravidlo 3. Po každej dokončenej úlohe vytvorte commit

Moje CLAUDE.md hovorí: „Po každej dokončenej úlohe vytvor git commit so zmysluplnou správou.“ Claude začne samo rozdeľovať prácu na malé samostatné commity.

Prináša vám to dve výhody. Po prvé, ak sa niečo pokazí, môžete vrátiť jednu operáciu, nie „všetko, čo som dnes urobil“. Po druhé, história commitov sa stane pracovným denníkom, ktorý ukazuje, čo sa zmenilo a v akom poradí.

Pravidlo 4. Vždy si pozrite priečinok business/

Pri každej úlohe týkajúcej sa zákazníkov, produktov alebo textov by mal agent najprv otvoriť business/INDEX.md a príslušný súbor, na ktorý odkazuje. Moje CLAUDE.md výslovne hovorí: „Pri práci na UI alebo texte si najprv pozri business/audience/avatar.md a business/assets/brand-guidelines.md.“

Bez tohto pravidla Claude píše texty „vo všeobecnom štýle kvalitného webu“. S ním sú texty vo vašom štýle, pre vášho zákazníka a bez vašich zakázaných slov.

Pravidlo 5. Po každej chybe agenta pridajte pravidlo

Toto je hlavné pravidlo, ktoré udržiava CLAUDE.md živý.

Príklady z môjho CLAUDE.md, ktoré pribudli po konkrétnych chybách:

• „Nikdy necommituj rozpracované súbory WIP niekoho iného pomocou git add . - pridávaj súbory do stagingu podľa názvu.“
• „Pred pushom do main skontroluj git log origin/main..main --oneline - ak výstup nie je prázdny, nepushuj.“
• „Nevymýšľaj si hodnoty - získaj ich z .env alebo z kódu. Najmä URL, používateľské mená a tokeny.“

Každý z týchto riadkov je stopou konkrétneho incidentu. Raz agent commitol nedokončenú vetvu spolupracovníka. Inokedy som zahrnul nepushnuté commity niekoho iného. Ďalší raz si agent vymyslel URL, ktoré neexistuje. Každá chyba sa stáva pravidlom a rovnaká rana, ktorú si spôsobíte sami, sa už neopakuje.

Pravidlo 6. Bezpečnosť vložte do .claude/settings.json, nie do CLAUDE.md

Do CLAUDE.md môžete napísať „nedotýkaj sa .env“, ale je to iba žiadosť; Claude ju môže porušiť, pretože CLAUDE.md sa načítava ako používateľská správa, nie ako zákon. Pri kritickej bezpečnosti použite .claude/settings.json, kde môžete určité príkazy striktne zablokovať.

Zoznam blokovaných príkazov, ktorý pridávam do každého nového projektu:

• rm -rf (rekurzívne mazanie ľubovoľných súborov).
• Čítanie celého .env (Read .env).
• export a curl v tom istom príkaze (vzorec na odoslanie tajných údajov mimo systému).
• git push --force bez výslovného schválenia.

Ďalšie príručky nájdete na Ailoot.

Ako je štruktúrovaný CLAUDE.md v aktívnej firme (anatómia súboru s 280 riadkami)?#

Väčšina príkladov CLAUDE.md na internete sú technické šablóny pre vývojárov: „Používaj TypeScript“, „Nepíš testy dlhšie ako 50 riadkov“. Pre podnikateľa je takýto CLAUDE.md zbytočný - nepokrýva obchodnú stránku.

Nižšie je štruktúra môjho fungujúceho CLAUDE.md. Odstránil som konkrétne pravidlá a cesty, pretože odrážajú moje interné prevádzkové postupy. Štruktúru a logiku sekcií však možno použiť v každom projekte: doplňte vlastné okolnosti a získate funkčný súbor.

1. Stručný opis projektu (15 riadkov). Čo robíme, kto je naše publikum a aké produkty ponúkame. Nie rekapitulácia marketingového webu, ale súhrn pre agenta, aby pochopil „kam smerujeme“.

2. O mne (10 riadkov). Odkaz na priečinok about-me/ - digitálnu projekciu toho, ako premýšľam. Tón, hodnoty, zásady, zakázané slová. Keď Claude píše text „za mňa“, najprv si prečíta tento priečinok, aby zodpovedal môjmu hlasu.

3. Štruktúra repozitára (20 riadkov). Strom s komentármi: kde je kód, kde žije obchodný kontext a kde sú plány a retrospektívy. Bez tejto mapy Claude zakaždým slepo hľadá súbory.

4. Tabuľka „kde čo nájsť“ (25 riadkov). Smerovanie od „otázka → súbor“. Napríklad pre realitnú kanceláriu môže uvádzať „potrebujem podmienky hypotéky → business/products/mortgage.md“ alebo „potrebujem tón hlasu pre príspevky → business/assets/voice.md“. Nahraďte ich vlastnými súbormi. Táto tabuľka je srdcom CLAUDE.md. Bez nej agent háda, ktorý súbor obsahuje odpoveď. S ňou ide priamo k zdroju.

5. Zásady projektu (40 riadkov, 10-15 položiek). Táto sekcia sa buduje pomaly a vyžaduje najviac úsilia. Každá položka je stopou konkrétnej chyby. Pravidlá pre internetový obchod by napríklad mohli znieť: „nikdy nevkladaj ceny a dodacie lehoty priamo do kódu“, „nezverejňuj produkt bez výslovného príkazu“ a „pred zverejnením ponuky produktu skontroluj štýl podľa slovníka značky“. Táto sekcia je „ústavou projektu“.

6. Prevádzkové plánovanie (20 riadkov). Tabuľka spúšťačov, ktorá mapuje „fráza používateľa → akcia“. Napríklad: „Keď poviem ‚naplánuj týždeň‘, otvor ops/monthly.md a vytvor súbor pre daný týždeň.“ Vďaka tomu sa Claude stane prevádzkovým asistentom, ktorý rozumie kontextu príkazov.

7. Nástroje (5 riadkov). Technológie. Stručne, bez zbytočností.

8. Publikovanie (15 riadkov). Postup krok za krokom na publikovanie zmien do produkcie: ktoré príkazy spustiť, v akom poradí a čo skontrolovať. Kedysi som to vysvetľoval zakaždým. Teraz to Claude vie.

9-12. Bezpečnosť (35 riadkov). Štyri samostatné podsekcie: pravidlá práce s .env, prístup k produkčnej databáze, bezpečné príkazy pre ukážky (nahrávanie obrazovky, streamy, snímky obrazovky, aby nedošlo k náhodnému odhaleniu tokenov) a pravidlá rotácie tajných údajov.

13. Priečinok plans/ (10 riadkov). Štandard plánov: názov súboru, štruktúra fáz a čo uviesť v súhrnnom bloku.

14. Priečinok retrospectives/ (5 riadkov). Štandard retrospektívy: šablóna, názov súboru a jeho obsah.

15. Živé údaje databázy (15 riadkov). Pravidlo na označovanie „čerstvých údajov“: keď súbor uvádza, že údaje musia byť aktuálne, agent ich získa zo zdroja namiesto použitia starých údajov. Znižuje sa tým riziko, že Claude použije včerajšie čísla.

16. Jazyk (3 riadky). „Vždy odpovedaj v jazyku, ktorý používateľ uprednostňuje. Používaj iba pomlčky, nie pomlčky em.“

Celkovo približne 280 riadkov. To prekračuje cieľ stručnosti, ale nerobí súbor neplatným. V tomto príklade zostal užitočný; o jeho ponechaní majú rozhodovať nameraná spotreba kontextu a skúšky na reprezentatívnych úlohách. Tabuľky automaticky nespotrebujú menej tokenov než próza.

Čo robí príkaz /init a prečo nestačí?#

Anthropic opisuje tento príkaz vo svojej dokumentácii takto:

Čo /init robí dobre:

• Identifikuje nástroje z package.json, Cargo.toml a pyproject.toml.
• Vypíše príkazy na zostavenie a testovanie.
• Zachytí konvencie z existujúcich súborov (.eslintrc, .prettierrc).
• Všimne si existujúce pravidlá Cursor (.cursorrules, .cursor/rules/) a pravidlá Copilot a zahrnie relevantné časti. Režim CLAUDE_CODE_NEW_INIT=1 dokáže zachytiť aj AGENTS.md.

Čo /init neurobí:

• Nebude vedieť, kto je váš zákazník.
• Nezahrnie zakázané slová pre vaše texty.
• Nepridá pravidlá týkajúce sa chýb agenta (pretože zatiaľ k žiadnym nedošlo).
• Nevytvorí tabuľku „kde čo nájsť“ pre štruktúru vášho podnikania.

Správny pracovný postup je teda takýto:

1. Spustite /init v Claude Code

   Získate úvodný CLAUDE.md s 30-50 riadkami obsahujúcimi nástroje a príkazy. To je technický základ.

2. Pridajte navrch šablónu z tohto článku

   Použite sekciu „Minimálny CLAUDE.md za 5 minút“. Pridajte sekcie pre navigáciu, smerovanie a zásady.

3. Vyplňte polia v hranatých zátvorkách

   Zadajte Claude výzvu „prečítaj môj projekt a vyplň šablónu“. Ak priečinky business/ a about-me/ ešte neexistujú, Claude sa opýta na doplňujúce informácie.

4. Vykonajte záťažovú skúšku

   Povedzte Claude: „Prečítaj môj CLAUDE.md a nájdi 10 nejednoznačností, ktoré by ťa ako agenta mohli viesť k nesprávnemu pochopeniu.“ Dostanete zoznam úprav.

5. Potom so súborom pracujte

   Po každej chybe agenta pridajte riadok. Za mesiac budete mať živý CLAUDE.md prispôsobený vašej firme.

Výzva pre štvrtý krok:

Mám súbor CLAUDE.md. Zajtra budem podľa neho vytvárať funkciu.

Tvojou úlohou je otestovať jeho odolnosť. Nájdi 10 dôvodov, prečo by sme mohli zlyhať:

kde je CLAUDE.md nejednoznačný a ty ako agent by si si ho mohol nesprávne vyložiť

kde sú medzery, ktoré by ťa nútili niečo si vymýšľať

kde si pravidlá navzájom odporujú

kde preceňujem, koľko sa dá stihnúť za jeden deň

kde veci podceňujem (to je ešte horšie)

Nič nezjemňuj. Kritizuj ho tvrdo. Chcem tieto problémy nájsť teraz, nie v produkcii. Na konci mi daj zoznam konkrétnych zmien: čo zmeniť a ako, aby sa tieto problémy neopakovali.

CLAUDE.md, AGENTS.md a MEMORY.md: kto čo číta v roku 2026?#

Hlavná otázka, ktorá mätie nováčikov, znie: číta Claude Code súbor AGENTS.md? Pred septembrom 2026 bola odpoveď „nie“: dokumentácia Anthropic odporúčala vytvoriť CLAUDE.md, ktorý importuje AGENTS.md. Od verzie 2.1.277 (vydanej 18. septembra 2026) Claude Code číta AGENTS.md priamo, ale iba vtedy, ak v pracovnom priečinku ani v nadradených priečinkoch nie je CLAUDE.md, .claude/CLAUDE.md ani CLAUDE.local.md.

Ak projekt obsahuje CLAUDE.md, Claude Code štandardne číta iba tento súbor a AGENTS.md preskočí. Môžete to zmeniť v /config v časti Project instructions: napríklad nastavenie claude-md-and-agents-md spôsobí, že bude čítať oba súbory. Ďalší spôsob funguje vo všetkých verziách: pridajte import do CLAUDE.md:

@AGENTS.md

## Claude Code

Additional rules for Claude Code that other agents don’t need.

Syntax @filename importuje ďalší súbor. Claude ho prečíta a načíta do kontextu spolu s CLAUDE.md. Import nespôsobí druhé načítanie súboru, ani keď Claude Code dokáže čítať AGENTS.md samostatne.

Kedy potrebujete AGENTS.md. Ak pracujete súčasne s Claude Code a Codex CLI, Cursor alebo Copilot, vytvorte AGENTS.md ako jediný zdroj pravdy, vložte @AGENTS.md do CLAUDE.md a doplňte pravidlá špecifické pre Claude. Ak také pravidlá nemáte, CLAUDE.md vytvárať nemusíte: od verzie 2.1.277 Claude Code prečíta samotné AGENTS.md. Ak pracujete iba v Claude Code, AGENTS.md nepotrebujete; používajte len jeden CLAUDE.md. Podrobný postup pre všetky možnosti nájdete v príručke o používaní AGENTS.md a CLAUDE.md v jednom projekte.

Čo je MEMORY.md? Od nedávnej aktualizácie Claude Code automaticky uchováva poznámky o vás v ~/.claude/projects/<project-name>/memory/MEMORY.md. Obsahujú komunikačné návyky („používateľ uprednostňuje krátke odpovede“), opakujúce sa frázy („zakázal emoji v kóde“) a pozorovania o správaní („pracuje v macOS, používa zsh“).

Je to samostatný systém pamäte, nie CLAUDE.md. Nepíšete ho ručne; Claude ho vytvára na základe vašich rozhovorov. Ak MEMORY.md obsahuje niečo, čo sa má stať pravidlom, presuňte to do CLAUDE.md. Ak obsahuje niečo zbytočné alebo nesprávne, môžete to ručne vymazať; je to textový súbor.

Aká veľkosť CLAUDE.md je užitočná a ako posúdiť dlhý súbor?#

V každom okne Claude Code sa do kontextu načíta niekoľko vrstiev: systémový prompt Anthropic (odhaduje sa na desiatky tisíc tokenov), vaše CLAUDE.md, súbory importované pomocou @, MEMORY.md, história aktuálneho chatu a obsah súborov, ktoré Claude otvára. To všetko sa musí zmestiť do kontextového okna modelu (200K tokenov pre Sonnet, 1M pre Opus).

Čím je CLAUDE.md väčší, tým menej miesta zostáva na aktuálnu prácu. Súbor s 1,000 riadkami má približne 8,000 tokenov a opakuje sa v každej relácii. Pri predplatnom Pro (podľa mojich skúseností približne 10-12 „náročných“ výziev denne) to znižuje kapacitu o štvrtinu.

Cena je iba jedna otázka. Dodržiavanie pokynov môže slabnúť, keď sú dlhé, nerelevantné alebo protichodné; univerzálny počet spoľahlivo dodržiavaných pokynov neexistuje. Otestujte niekoľko reprezentatívnych úloh využívajúcich kritické pravidlá, zaznamenajte zlyhania a po cielenej úprave porovnajte správanie.

Tu je teda praktické pravidlo pre veľkosť:

• 80-120 riadkov - vhodný začiatočný rozsah stručnej mapy projektu, nie zaručené skóre dodržiavania pravidiel.
• 150-200 riadkov - užitočný podnet na kontrolu relevantnosti a presunutie podrobných postupov do prepojených súborov.
• 200-300 riadkov - posúďte objem tokenov, duplicity a výsledky úloh; vyššie uvedený firemný príklad s 280 riadkami môže stále fungovať dobre.
• 400+ riadkov - silný dôvod na cielenú kontrolu, nie dôkaz nepoužiteľnosti. Ponechajte podstatné obmedzenia a detaily presúvajte až po overení funkčnosti odkazov a pravidiel.

Samotný počet riadkov nedokazuje úspech ani zlyhanie. Po úprave zopakujte rovnaké reprezentatívne úlohy a overte dôležité pravidlá namiesto vymysleného percenta dodržiavania.

Anthropic uvádza v dokumentácii priamy test:

Použite ho na každý riadok. Ak je odpoveď „aj tak by to urobilo správne“, riadok odstráňte. CLAUDE.md nie je miesto na dokumentáciu, históriu rozhodnutí ani filozofiu. Obsahuje iba pravidlá, ktoré agent potrebuje, aby nerobil chyby.

Ktorých 7 chýb robí CLAUDE.md zbytočným?#

Chyba 1. „Buď dobrý inžinier“

Najčastejšia chyba. Ľudia píšu do CLAUDE.md všeobecné želania: „píš čistý kód“, „používaj osvedčené postupy“, „premýšľaj ako skúsený inžinier“.

Tieto slová nič neznamenajú. Claude už píše „čistý kód“ vo všeobecnom zmysle. Tieto riadky zaberajú kontext bez toho, aby ovplyvnili nejaké rozhodnutie.

Nahraďte „píš čistý kód“ pokynmi „používaj odsadenie 2 medzerami“, „v TypeScript nepoužívaj any“ alebo „funkcie nesmú byť dlhšie než 30 riadkov“. Konkrétne a overiteľné.

Chyba 2. Opakovanie toho, čo Claude už vie

Opisy štandardných jazykových konvencií („v JavaScript sú funkcie prvotriedne objekty“, „TypeScript má statické typovanie“). Vysvetlenia toho, ako fungujú npm, git alebo docker.

Claude sa to všetko naučilo počas tréningu. Opakovaním v CLAUDE.md nič nepridáte; iba ukrojíte z kontextu.

Chyba 3. Dlhé podrobné pokyny v CLAUDE.md

Dlhé pokyny typu „ako nasadiť projekt“, „ako napísať migráciu databázy“ alebo „ako nastaviť nový komponent“. Desiatky krokov v jednotlivých riadkoch.

Toto nie je miesto pre dlhé postupy krok za krokom. Je určené pre jednovetové pravidlá. Dlhé pokyny vložte do skills/ (samostatného mechanizmu Claude Code, ktorý sa načíta podľa potreby) alebo do docs/. V CLAUDE.md použite jednovetový odkaz: „Pri vytváraní novej migrácie otvor docs/migrations.md.“

Chyba 4. Pravidlá, ktoré už kontroluje automatický analyzátor kódu

„Používaj bodkočiarky“, „nenechávaj nepoužité importy“, „nepoužívaj var“. ESLint, Prettier a Biome toto všetko zachytia - sú to lintery (nástroje na automatickú kontrolu kódu).

Linter je deterministický: spustí sa, nájde chybu a opraví ju. Pravidlo v CLAUDE.md je pravdepodobnostné; agent naň môže zabudnúť. Netreba ho duplikovať - jednoduchšie je nastaviť linter.

Chyba 5. Tajomstvá v CLAUDE.md

Videl som heslá k testovacím účtom, API tokeny sandboxu a odkazy na autentifikované administrátorské panely. Všetko to bolo v súbore commitnutom do git a načítanom do kontextu modelu Anthropic.

Nikdy. Tajomstvá patria do .env, ktorý je uvedený v .gitignore. CLAUDE.md môže nanajvýš uvádzať: „Nečítaj celý .env; na konkrétnu premennú použi grep.“

Chyba 6. Súbor so 500+ riadkami, do ktorého sa hádže všetko možné a ktorý sa šesť mesiacov nečistil

CLAUDE.md narástol, duplikuje polovicu priečinka docs/, na viacerých miestach si protirečí a nikto si nepamätá, čo obsahuje. Agent začne väčšinu pokynov ignorovať. Tím sa sťažuje, že „Claude nedodržiava pokyny“, a pridáva ďalšie pravidlá, čím situáciu zhoršuje.

Znaky zanedbaného CLAUDE.md: viac než 300 riadkov, opakované pravidlá v rôznych sekciách, zastarané odkazy na súbory, ktoré už neexistujú, a „historické“ poznámky typu „v roku 2024 sme sa rozhodli robiť to takto, potom sme si to rozmysleli“.

Riešenie: každé dva týždne požiadajte Claude, aby súbor skontrolovalo podľa testu Anthropic: „Ak by sa tento riadok odstránil, urobil by agent chybu?“ Vymažte všetko, pri čom je odpoveď „nie“.

Chyba 7. Vytvorenie CLAUDE.md a následné zabudnutie

Je to opak predchádzajúcej chyby. Súbor sa zostavil raz pred dvoma mesiacmi a odvtedy sa ho nikto nedotkol. Medzitým sa zmenili nástroje, pribudli nové priečinky a objavili sa nové chyby agenta. CLAUDE.md o tom nič nevie, pretože ho nikto neaktualizoval.

Typickým znakom je opakovanie rovnakého pokynu v každej relácii. „Nerob X“, „nedotýkaj sa Y“, „pamätaj na Z“. Ak ste to zopakovali viac než dvakrát, pravidlo patrí do CLAUDE.md, nie do vašej hlavy.

Ako dosiahnuť, aby sa CLAUDE.md samo učilo pomocou pravidla „aktualizácia na konci relácie“?#

Moje CLAUDE.md má krátku sekciu:

## Self-learning

At the end of every session, check:
- Have I learned anything new about the user or how to work with them?
- Did I break any rule that should now be recorded?

If so, create or update a file in `about-me/feedback/` in this format:
Rule (one-line rule) → Why (why it was added)
→ How to apply (when it applies).

I don’t write the rules by hand - I say, “not like that, because this is how,”
and you put it into a file.

Po pridaní tejto sekcie do CLAUDE.md sa Claude začalo na konci každej relácie pýtať: „Bolo tu niečo nové, čo stojí za zaznamenanie?“ Ak áno, navrhlo koncept pravidla, ja som ho spresnil a vytvoril sa súbor.

Po dvoch mesiacoch práce týmto spôsobom mám v about-me/feedback/ viac než dva tucty súborov - pravidiel odvodených od konkrétnych chýb. Každý súbor je jedna strana vo formáte Pravidlo → Prečo → Ako. Priečinok sa stal „druhou pamäťou“, ktorá zaznamenáva moje osobné preferencie a tabu.

Každá chyba sa už neopakuje, pretože sa z nej stane pravidlo, a pravidlá sa hromadia a navzájom posilňujú. Po šiestich mesiacoch Claude pozná môj projekt lepšie, než si ho pamätám ja po mesačnej prestávke.

Ako do CLAUDE.md pridať právne pravidlá, marketing a prevádzkové postupy?#

Pre väčšinu tímov je CLAUDE.md čisto technický dokument: nástroje, príkazy na zostavenie, konvencie kódovania. Je to užitočné, ale predstavuje len tretinu hodnoty.

Ak sa podnikateľ stará o CLAUDE.md, dáva zmysel pridať obchodné sekcie. Najdôležitejšie sú tri:

Právne pravidlá (pre regulované trhy)

Ak publikujete texty v regulovanom odvetví (financie, medicína, reklama liekov, produkty pre deti), zakázané slová majú právnu váhu a patria do CLAUDE.md ako výslovné pravidlá. Nie do niečej hlavy, ani na snímku obrazovky editora - do súboru, ktorý agent vidí v každej relácii.

Príklad pre fintech projekt bez bankovej licencie:

Redakčná poznámka: Nasledujúci príklad ukazuje formát interného pravidla pre konkrétny projekt. Nejde o univerzálne povolenie používať uvedené výrazy: prípustnosť tvrdenia závisí od platného práva a postavenia spoločnosti.

🚨 KRITICKÉ - finančné formulácie sú zakázané. V materiáloch určených zákazníkom nepoužívaj: „vklad“, „garantovaný výnos“ ani „investičný produkt“. Používaj: „sporiaci účet“, „očakávaný výnos“ a „produkt s variabilnou sadzbou“. Dôvodom sú právne požiadavky na reklamu finančných služieb, ktoré sa vzťahujú na tento projekt.

Tento blok v CLAUDE.md robí jednoduchú vec: zakaždým, keď požiadate Claude o text pre zákazníkov, agent ho porovná s týmito zákazmi. Bez pravidla sa zakázané slová objavia v každej tretej kampani. S ním zabudnete, že existujú.

Rovnaký prístup funguje pre:

• Zdravotnícke projekty (žiadne tvrdenia, že niečo „lieči“ alebo „vylieči“).
• Reklamu liekov (žiadne tvrdenia o „najvyššej účinnosti“; povinné upozornenia).
• Každé regulované odvetvie s vlastnými reklamnými pravidlami.

Marketingový štýl a formát textov

Ak pravidelne publikujete texty (sociálne siete, newslettery, webové stránky), oplatí sa ich formát opísať v jednom odseku v CLAUDE.md. Tu je príklad, čo by mohol napísať influencer alebo agentúra spravujúca kanál na posielanie správ:

Pri písaní príspevkov do kanála si pozri style/posts.md. Používaj povolené formátovacie značky kanála a vyhýbaj sa „nebezpečným“ špeciálnym znakom. Ukonči text výzvou CTA s označením UTM podľa tejto konvencie: utm_source=<channel>&utm_medium=<type>&utm_campaign=<slug>.

Claude kedysi písalo príspevky „vo všeobecnom štýle marketingového webu“. Teraz sa riadi vaším formátom, používa vaše UTM a neprezrádza, že text napísala AI.

Prevádzkové zvyklosti

Tabuľky spúšťačov. Keď vyslovíte konkrétnu frázu, agent vie, ktoré súbory má otvoriť a aké kroky vykonať. Tu je príklad pre tím, ktorý plánuje po týždňoch:

„Naplánuj týždeň“ → otvor ops/monthly.md, vytvor YYYY-WNN.md v tom istom priečinku a presuň úlohy z ops/backlog.md pod príslušné dni. „Čo je v nevybavených úlohách?“ → prečítaj ops/backlog.md a zobraz ho ako zoznam. „Uzavri týždeň“ → vyplň sekciu „Súhrn týždňa“ v súbore pre aktuálny týždeň.

S takýmito tabuľkami sa Claude z „pomocníka, ktorý píše kód“ zmení na „operátora“, ktorý pozná rutinu vašej firmy. Každý pondelok poviem „naplánujme týždeň“ a Claude otvorí správne súbory, prečíta mesačné ciele a navrhne, ako rozdeliť prácu.

Ako skontrolovať CLAUDE.md podľa 12-bodového zoznamu za 5 minút?#

1. Veľkosť. Je súbor stručný, s približne 200 riadkami ako cieľom kontroly, nie hranicou úspechu a zlyhania?
2. Názov. Volá sa presne CLAUDE.md s veľkými písmenami, nie claude.md?
3. Umiestnenie. Je v koreňovom priečinku projektu alebo v ./.claude/CLAUDE.md?
4. Opis projektu. Je z prvých 5 riadkov jasné, čo je projekt a komu slúži?
5. Nástroje. Sú technológie výslovne uvedené a bez zbytočností?
6. Štruktúra. Obsahuje diagram repozitára s vysvetlivkami?
7. Smerovanie. Obsahuje tabuľku „otázka → súbor“, ktorá ukazuje, kde nájsť odpovede?
8. Zásady. Obsahuje sekciu s pravidlami začínajúcimi slovami „nikdy“ a „vždy“?
9. Konkrétnosť. Je každé pravidlo overiteľné? („Používaj 2 medzery“, nie „píš krásne“.)
10. Samostatná aktualizácia. Obsahuje pravidlo „na konci relácie skontroluj, čo pridať“?
11. Retrospektíva. Obsahuje pravidlo „zaznamenaj súhrn relácie do retrospectives/“?
12. Bezpečnosť. Sú kritické zákazy (.env, rm -rf) uvedené aj v .claude/settings.json?

Ak máte viac než päť odpovedí „nie“, otvorte Claude a zadajte mu túto výzvu:

Prečítaj môj CLAUDE.md a porovnaj ho s nasledujúcim kontrolným zoznamom. Pri každej položke uveď: áno / nie / čiastočne a čo konkrétne treba opraviť.

Kontrolný zoznam:

Dostatočne stručný pre úlohu; pri približne 200 riadkoch ho skontrolovať, nie považovať číslo za pevný strop

Opis projektu v prvých 5 riadkoch

Nástroje uvedené výslovne

Obsahuje diagram štruktúry repozitára

Obsahuje tabuľku „Otázka → súbor“

Obsahuje sekciu zásad s pravidlami

Každé pravidlo je konkrétne a overiteľné

Obsahuje pravidlo „Aktualizovať na konci relácie“

Obsahuje pravidlo „Urobiť retrospektívu na konci relácie“

Kritické zákazy sú uvedené v .claude/settings.json

Rovnaké pravidlo sa neopakuje v rôznych sekciách

Neobsahuje nefunkčné odkazy na súbory, ktoré už neexistujú

Po audite mi daj zoznam konkrétnych zmien, ktoré zo súboru urobia živý dokument.

Čo použiť po CLAUDE.md: Plan Mode, Skills alebo sub-agents?#

CLAUDE.md je základ. Keď funguje, môžete pridať tri mechanizmy Claude Code, ktoré sa navzájom posilňujú.

Plan Mode. Režim, v ktorom Claude najprv vytvorí plán zmien, počká na vaše schválenie a až potom začne pracovať. Aktivujte ho pomocou Shift+Tab alebo príkazom /plan. Rieši hlavný problém vibe codingu: „Požiadal som Claude o opravu jednej veci a ono prepísalo polovicu projektu.“ V Plan Mode sa to nestane - plán uvidíte skôr, než sa agent dotkne akéhokoľvek súboru.

Skills. Samostatné súbory .md v priečinku .claude/skills/, ktoré obsahujú znalosti pre konkrétny typ úlohy. Napríklad skill „ako napísať migráciu databázy“ obsahuje konkrétny postup, šablónu a príklady. Tieto znalosti nie sú v CLAUDE.md, pretože sú príliš rozsiahle. Keď však Claude narazí na úlohu typu „napíš migráciu“, načíta príslušný skill a riadi sa ním.

Sub-agents. Keď úloha vyžaduje veľa kontextu (napríklad kontrolu veľkej funkcie), Claude môže spustiť samostatný sub-agent s vlastným čistým kontextom. Sub-agent vykoná prácu a vráti výsledok bez zahltenia kontextu hlavného chatu.

Všetky tri mechanizmy používajú CLAUDE.md ako vstupný bod: na začiatku práce ho čítajú, aby pochopili kontext projektu. Aj preto tieto funkcie bez živého CLAUDE.md fungujú zle. Najprv základ, potom nadstavba.

Ďalší krok. Vytvorte súbor CLAUDE.md v koreňovom priečinku projektu, skopírujte šablónu zo začiatku článku a pomocou pomocnej výzvy vyplňte polia v hranatých zátvorkách. Potom súbor používajte: každú chybu agenta premeňte na nový riadok. Po dvoch alebo troch týždňoch CLAUDE.md prestane byť „dokumentom, ktorý sme napísali a zabudli naň“ a stane sa niečím, s čím Claude skutočne pracuje v každej relácii.

Ak chcete vybudovať kompletný rámec okolo CLAUDE.md - priečinok business/ pre druhý mozog, priečinok about-me/ ako digitálnu projekciu vás, základné skills a nakonfigurovaný Plan Mode - použite kroky a príklady z tohto článku. Sprievodcovia Ailoot.

Pokračujte s Ailoot.