Kaip nustatyti CLAUDE.md 2026 m.: šablonas ir 6 taisyklės

Medžiaga apie vibe coding: įrankiai, atvejų analizės, klaidos. Ailoot vadovai.

Kodėl reikia CLAUDE.md ir kodėl be jo Claude pamiršta projektą?#

Antradienį atidarote Claude Code ir paaiškinate: „Dirbu su šiuo projektu, štai kokie įrankiai, šito nedaryk.“ Jis veikia.

Ketvirtadienį tas pokalbis jau būna pasibaigęs, todėl viską kartojate. Šeštadienį – vėl, pirmadienį – dar kartą.

Taip atrodo darbas su agentu be CLAUDE.md: kiekvienas naujas langas – tuščias lapas ir praktikantas, kuriam vis iš naujo tenka aiškinti tuos pačius dalykus. Anksčiau kiekvieną sesiją pradėdavau 5-10 minučių įvesdamas tokią įžangą. Užklausos vis ilgėjo, nes visą kontekstą turėjau pateikti rankiniu būdu. O rezultatas vis tiek būdavo bendro pobūdžio: agentas nežinojo mano auditorijos, ekonomikos ar principų.

Kai CLAUDE.md nuolat atnaujinamas, įžanga tampa nebereikalinga. Visos taisyklės, kurias anksčiau kartodavote kiekviename pokalbyje, yra viename faile ir automatiškai pateikiamos kiekvienos sesijos pradžioje. Užklausa sutrumpėja iki „padaryk X“, o ne „dirbu su projektu Y, įrankiai yra Z, nedaryk A ar B ir, beje, nepamiršk C“.

Tada liaujamasi kartoti tas pačias klaidas.

Kiekviena agento klaida yra priežastis įrašyti į CLAUDE.md vieną eilutę. Po mėnesio turite nuolat atnaujinamą „projekto konstituciją“, o Claude nustoja vėl pakliūti į tas pačias gerai pažįstamas pinkles.

Yra ir trečias sluoksnis: agentas nustoja rašyti vakuume. Naudodamas CLAUDE.md, nukreipiu Claude į aplankus, kuriuose yra kontekstas: kur ieškoti informacijos apie auditoriją, kainodarą ir prekės ženklą. Be šio maršrutizavimo agentas kuria „kokybiškus sprendimus“ nežinodamas mano ekonomikos, todėl jie būna abstraktūs, šabloniški ir „kaip visi“.

Kas yra CLAUDE.md ir kokia tvarka Claude jį perskaito?#

Anthropic oficialioje dokumentacijoje CLAUDE.md apibūdina taip:

Keturios vietos, kuriose Claude Code ieško CLAUDE.md failų, išvardytos didėjančia prioriteto tvarka:

Visi keturi failai įkeliami į kontekstą vienu metu. Jei taisyklės prieštarauja viena kitai, Anthropic dokumentacijoje tiesiai teigiama, kad neaišku, kuri turės pirmenybę; Claude gali pasirinkti bet kurią savo nuožiūra. Todėl paprasčiau viską, kas svarbiausia, laikyti projekto CLAUDE.md ir vengti dublikatų.

Yra viena techninė detalė, apie kurią beveik niekas nerašo, bet ji paaiškina daug keisto elgesio.

Kitaip tariant, griežtąja prasme CLAUDE.md nėra „sistemos užklausa“. Tai pirmasis Claude matomas naudotojo pranešimas. Todėl jo taisyklės yra stiprios rekomendacijos, o ne įstatymai. Jei taisyklę reikia privalomai užtikrinti, naudokite išbandytą hook konkrečiam įvykiui, o platesnei prieigos ribai — leidimus ar aplinkos izoliaciją. Automatinis hook vykdymas nereiškia, kad jo patikros yra išsamios. Toliau paaiškinsiu ribą tarp hooks ir CLAUDE.md.

Kaip per 5 minutes parašyti minimalų CLAUDE.md (paruoštas šablonas)?#

Toliau pateikiamas šablonas, kurį išbandžiau dešimtyse savo projektų. Jis padeda išlaikyti maždaug 80-120 eilučių failą – laikantis Anthropic rekomendacijos siekti mažiau nei 200 eilučių. Naudodamas šį šabloną, agentas pateikia protingiausius rezultatus.

# [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.

Kad Claude automatiškai užpildytų šį šabloną jūsų projektui, pateikite jam šią užklausą. Jis perskaitys kontekstą ir užpildys laužtiniuose skliaustuose esančius laukus:

Create a CLAUDE.md file at the project root using this template:

[INSERT THE ENTIRE TEMPLATE FROM ABOVE]

Proceed as follows:

Read about-me/INDEX.md and business/INDEX.md to understand the project context and me as the author.

Fill in all the square-bracketed fields in the template based on what you find in those folders.

If some information is missing, ask me clarifying questions one at a time, with 3-4 answer options.

Stenkitės, kad gautas CLAUDE.md būtų trumpesnis nei 200 eilučių. Jei jis ilgesnis, peržiūrėkite pasikartojimus ir išsamias procedūras perkelkite į susietus failus. Išlaikykite esmines planavimo, refleksijos ir saugyklos taisykles, tada išbandykite jas su būdingomis užduotimis.

Show me the final file and ask what should be revised.

Always respond in the user’s preferred language.

Jei dar neturite aplankų about-me/ ir business/, nieko tokio. Claude užduos patikslinamųjų klausimų ir pagal tai, kas prieinama, parengs minimalų CLAUDE.md. Aplankus galėsite sukurti vėliau, kai žinosite, ką į juos įtraukti.

Kokios 6 taisyklės paverčia CLAUDE.md nuolat atnaujinamu dokumentu?#

1 taisyklė. Siekite glaustumo; 200 eilučių laikykite peržiūros orientyru

Anthropic tai glaustai pasako oficialioje dokumentacijoje:

Ilgas CLAUDE.md veikia priešingai, nei norėtumėte, dėl dviejų priežasčių. Pirma, jis eikvoja žetonus. 800 eilučių instrukcijų failas įkeliamas į kiekvieną langą ir kiekvienoje sesijoje sunaudoja kelis tūkstančius jūsų limito žetonų. Turint Pro prenumeratą su dienos limitu, tai pastebimai sumažina prieinamų sesijų skaičių. Antra, modelis ima ignoruoti taisykles.

Dokumentacijoje rekomenduojama siekti mažiau nei 200 eilučių, kad būtų naudojama mažiau konteksto ir geriau laikomasi instrukcijų. Ji nenustato staigaus gedimo ties 201 eilute. Prieš nuspręsdami, ką iškelti kitur, peržiūrėkite aktualumą, prieštaravimus, įkeltų žetonų kiekį ir tikruosius užduočių rezultatus.

2 taisyklė. Kiekvieną sesiją užbaikite apmąstymais

CLAUDE.md įrašykite: „Kiekvienos sesijos pabaigoje užrašyk, ką nuveikei ir ko išmokai, faile retrospectives/YYYY-MM-DD_*.md.“ Pridėjus šią eilutę, Claude pats ims užbaigti kiekvieną sesiją apmąstymais – jums nebereikės prašyti.

Kodėl verta apmąstyti:

• Po dviejų savaičių atidarę seną apžvalgą prisiminsite, kodėl pasirinkote tą kelią.
• Po mėnesio grįžę prie projekto turėsite paruoštą naujausių sprendimų žemėlapį.
• Jei dirbate komandoje, kolega galės perskaityti apžvalgą ir per 2 minutes, be skambučio, suprasti dabartinę padėtį.

3 taisyklė. Atlikę kiekvieną užduotį, sukurkite commit

Mano CLAUDE.md parašyta: „Atlikęs kiekvieną užduotį, sukurk git commit su prasmingu pranešimu.“ Claude pats ima skaidyti darbą į atskirus commit.

Taip gaunate du dalykus. Pirma, jei kas nors sugenda, galite atšaukti vieną operaciją, o ne „viską, ką šiandien padariau“. Antra, commit istorija tampa darbų žurnalu, kuriame matyti, kas ir kokia tvarka pasikeitė.

4 taisyklė. Visada peržiūrėkite aplanką business/

Atlikdamas bet kokią užduotį, susijusią su klientais, produktais ar tekstais, agentas pirmiausia turi atverti business/INDEX.md ir atitinkamą ten nurodytą failą. Mano CLAUDE.md aiškiai parašyta: „Dirbdamas su UI ar tekstais, pirmiausia patikrink business/audience/avatar.md ir business/assets/brand-guidelines.md.“

Be šios taisyklės Claude kuria tekstus „bendru kokybiškos svetainės stiliumi“. Laikydamasis jos, jis rašo jūsų stiliumi, jūsų klientui ir nevartoja draudžiamų žodžių.

5 taisyklė. Po kiekvienos agento klaidos pridėkite taisyklę

Tai pagrindinė taisyklė, padedanti nuolat atnaujinti CLAUDE.md.

Pavyzdžiai iš mano CLAUDE.md, pridėti po konkrečių klaidų:

• „Niekada neįtrauk kito žmogaus nebaigtų WIP failų naudodamas git add . – įtrauk failus pagal pavadinimą.“
• „Prieš siųsdamas į main, patikrink git log origin/main..main --oneline – jei rezultatas netuščias, nesiųsk.“
• „Neišgalvok reikšmių – gauk jas iš .env arba kodo. Ypač URL, naudotojų vardų ir žetonų.“

Kiekviena tokia eilutė yra konkretaus incidento pėdsakas. Kartą agentas įtraukė partnerio nebaigtą šaką. Kartą įtraukiau kito žmogaus neišsiųstus commit. Kartą agentas išgalvojo neegzistuojantį URL. Kiekviena klaida virsta taisykle, ir ta pati savęs paties padaryta žala nepasikartoja.

6 taisyklė. Saugumą nustatykite faile .claude/settings.json, o ne CLAUDE.md

CLAUDE.md galite parašyti „neliesk .env“, bet tai tik prašymas; Claude gali jo nepaisyti, nes CLAUDE.md įkeliamas kaip naudotojo pranešimas, o ne kaip įstatymas. Kritiniam saugumui naudokite .claude/settings.json, kuriame galima griežtai uždrausti tam tikras komandas.

Blokavimo sąrašas, kurį įtraukiu į kiekvieną naują projektą:

• rm -rf (rekursinis bet kokių failų ištrynimas).
• Viso .env turinio skaitymas (Read .env).
• export ir curl toje pačioje komandoje (slaptos informacijos nutekinimo išorėn šablonas).
• git push --force be aiškaus leidimo.

Kitus vadovus rasite Ailoot.

Kaip CLAUDE.md sudarytas veikiančiame versle (280 eilučių failo anatomija)?#

Dauguma CLAUDE.md pavyzdžių internete yra techniniai šablonai kūrėjams: „Naudok TypeScript“, „Nerašyk ilgesnių nei 50 eilučių testų.“ Verslininkui toks CLAUDE.md nenaudingas – jame neaptariama verslo pusė.

Toliau pateikiama mano veikiančio CLAUDE.md struktūra. Pašalinau konkrečias taisykles ir kelius, nes jie atskleidžia mano vidinę veiklą. Tačiau skyrių struktūrą ir logiką galima pritaikyti bet kokiam projektui: įrašykite savo aplinkybes ir turėsite veikiantį failą.

1. Trumpas projekto aprašymas (15 eilučių). Ką darome, kas mūsų auditorija, kokius produktus siūlome. Ne rinkodaros svetainės aprašymas, o agentui skirta santrauka, padedanti suprasti, „kur link judame“.

2. Apie mane (10 eilučių). Nuoroda į aplanką about-me/ – skaitmeninį mano mąstymo atspindį. Tonas, vertybės, principai, draudžiami žodžiai. Kai Claude rašo „mano vardu“, pirmiausia perskaito šį aplanką, kad tekstas atitiktų mano balsą.

3. Saugyklos struktūra (20 eilučių). Medžio pavidalo schema su komentarais: kur yra kodas, kur – verslo kontekstas, kur – planai ir apžvalgos. Be šio žemėlapio Claude kaskart aklai ieško failų.

4. Lentelė „Kur ko ieškoti“ (25 eilutės). Maršrutizavimas „klausimas → failas“. Pavyzdžiui, nekilnojamojo turto agentūrai gali būti parašyta: „reikia hipotekos sąlygų → business/products/mortgage.md“ arba „reikia įrašų tono → business/assets/voice.md“. Pritaikykite savo failams. Ši lentelė yra CLAUDE.md esmė. Be jos agentas spėlioja, kuriame faile yra atsakymas. Su ja jis eina tiesiai prie šaltinio.

5. Pagrindiniai projekto principai (40 eilučių, 10-15 punktų). Šis skyrius pildomas pamažu ir pareikalauja daugiausia pastangų. Kiekvienas punktas yra konkrečios klaidos pėdsakas. Pavyzdžiui, internetinės parduotuvės taisyklės galėtų būti: „niekada nerašyti kainų ir pristatymo laiko tiesiai į kodą“, „neskelbti produkto be aiškaus nurodymo“ ir „prieš skelbiant produkto aprašymą patikrinti stilių pagal prekės ženklo žodyną“. Šis skyrius yra „projekto konstitucija“.

6. Veiklos planavimas (20 eilučių). Sąlygų ir veiksmų lentelė „naudotojo frazė → veiksmas“. Pavyzdžiui: „Kai pasakau „suplanuok savaitę“, atidaryk ops/monthly.md ir sukurk savaitės failą.“ Taip Claude tampa veiklos asistentu, suprantančiu komandų kontekstą.

7. Įrankiai (5 eilutės). Technologijos. Trumpai, be perteklinių žodžių.

8. Publikavimas (15 eilučių). Žingsnis po žingsnio aprašytas pakeitimų publikavimo gamybinėje aplinkoje procesas: kokias komandas vykdyti, kokia tvarka ir ką patikrinti. Anksčiau kaskart turėdavau tai aiškinti. Dabar Claude žino.

9-12. Saugumas (35 eilutės). Keturi atskiri poskyriai: darbo su .env taisyklės, prieiga prie gamybinės duomenų bazės, saugios demonstravimo komandos (ekrano įrašai, transliacijos, ekrano kopijos, kad žetonai netyčia nebūtų atskleisti) ir slaptų duomenų keitimo taisyklės.

13. Aplankas plans/ (10 eilučių). Planų standartas: failo pavadinimas, etapų struktūra ir tai, kas turi būti santraukos bloke.

14. Aplankas retrospectives/ (5 eilutės). Apžvalgų standartas: šablonas, failo pavadinimas ir turinys.

15. Tiesioginiai duomenų bazės duomenys (15 eilučių). Taisyklė, kaip pažymėti „šviežius duomenis“: kai faile nurodyta, kad skaičiai turi būti atnaujinti, agentas juos gauna iš šaltinio, o ne naudoja senus. Taip Claude nerizikuoja remtis vakarykščiais duomenimis.

16. Kalba (3 eilutės). „Visada atsakykite naudotojo pageidaujama kalba. Naudokite tik brūkšnelius, ne ilgą brūkšnį.“

Iš viso – apie 280 eilučių. Tai viršija glaustumo orientyrą, bet nedaro failo negaliojančio. Šiame pavyzdyje jis liko naudingas; sprendimą jį išlaikyti turėtų lemti išmatuotas konteksto naudojimas ir būdingų užduočių patikros. Lentelės savaime nenaudoja mažiau žetonų nei proza.

Ką daro komanda /init ir kodėl jos nepakanka?#

Anthropic dokumentacijoje komandą apibūdina taip:

Ką /init atlieka gerai:

• Aptinka įrankius pagal package.json, Cargo.toml ir pyproject.toml.
• Išvardija kūrimo ir testavimo komandas.
• Perima esamų failų (.eslintrc, .prettierrc) susitarimus.
• Aptinka esamas Cursor taisykles (.cursorrules, .cursor/rules/) ir Copilot taisykles bei įtraukia aktualias jų dalis. AGENTS.md failą aptinka režimu CLAUDE_CODE_NEW_INIT=1.

Ko /init neatliks:

• Nežinos, kas jūsų klientas.
• Neįtrauks jūsų tekstams draudžiamų žodžių.
• Nepridės agento klaidų taisyklių, nes klaidų dar nebuvo.
• Nesukurs jūsų verslo struktūros lentelės „kur ko ieškoti“.

Todėl rekomenduojama darbo eiga tokia:

1. Paleiskite /init Claude Code aplinkoje

   Gausite pradinį 30-50 eilučių CLAUDE.md su įrankiais ir komandomis. Tai techninis pagrindas.

2. Pridėkite prie jo šio straipsnio šabloną

   Naudokite skyrių „Minimalus CLAUDE.md per 5 minutes“. Pridėkite navigacijos, maršrutizavimo ir principų skyrius.

3. Užpildykite laužtiniuose skliaustuose esančius laukus

   Pateikite Claude užklausą „perskaityk mano projektą ir užpildyk šabloną“. Jei aplankų business/ ir about-me/ dar nėra, Claude užduos patikslinamųjų klausimų.

4. Atlikite atsparumo testą

   Pasakykite Claude: „Perskaityk mano CLAUDE.md ir rask 10 neaiškių vietų, dėl kurių tu, kaip agentas, galėtum mane neteisingai suprasti.“ Gausite pataisymų sąrašą.

5. Tada kurį laiką naudokite failą

   Po kiekvienos agento klaidos pridėkite eilutę. Po mėnesio turėsite jūsų verslui pritaikytą, nuolat atnaujinamą CLAUDE.md.

Ketvirto žingsnio užklausa:

I have a CLAUDE.md. Tomorrow I’ll be building a feature based on it.

Your task is to stress-test it. Find 10 reasons we could potentially fail:

where CLAUDE.md is ambiguous and you, as an agent, might misunderstand it

where there are gaps that would force you to make things up

where rules contradict one another

where I overestimate how much can be done in one day

where I underestimate things (this is even worse)

Don’t hold back. Criticize it harshly. I want to find these issues now, not in production.
At the end, give me a list of specific changes: what to change and how, so these problems don’t happen.

CLAUDE.md ir AGENTS.md, ir MEMORY.md: kas ką skaito 2026 m.?#

Pagrindinis klausimas, gluminantis naujokus: ar Claude Code skaito AGENTS.md? Iki 2026 m. rugsėjo atsakymas buvo „ne“: Anthropic dokumentacijoje buvo rekomenduojama sukurti CLAUDE.md, importuojantį AGENTS.md. Nuo 2.1.277 versijos (išleistos 2026 m. rugsėjo 18 d.) Claude Code skaito patį AGENTS.md, bet tik tada, jei darbiniame aplanke ar aukščiau jo nėra CLAUDE.md, .claude/CLAUDE.md arba CLAUDE.local.md.

Jei projekte yra CLAUDE.md, Claude Code pagal numatytuosius nustatymus skaito tik jį ir praleidžia AGENTS.md. Tai galite pakeisti nuėję į /config, skiltyje Project instructions: pavyzdžiui, nustačius claude-md-and-agents-md, jis skaitys abu failus. Dar vienas būdas veikia visose versijose: į CLAUDE.md įtraukti importą:

@AGENTS.md

## Claude Code

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

Sintaksė @filename importuoja kitą failą. Claude jį perskaito ir kartu su CLAUDE.md įkelia į kontekstą. Failas neskaitomas dukart, net jei Claude Code gali pats skaityti AGENTS.md.

Kada reikia AGENTS.md. Jei lygiagrečiai naudojate Claude Code ir Codex CLI, Cursor ar Copilot, sukurkite AGENTS.md kaip vienintelį tiesos šaltinį, į CLAUDE.md įrašykite @AGENTS.md ir pridėkite visas tik Claude būdingas taisykles. Jei tokių taisyklių nėra, CLAUDE.md kurti nereikia: nuo 2.1.277 versijos Claude Code pats perskaitys AGENTS.md. Jei naudojate tik Claude Code, AGENTS.md nereikia – užtenka vienintelio CLAUDE.md. Visas galimybes nuosekliai rasite vadove, kaip viename projekte naudoti AGENTS.md ir CLAUDE.md.

Kas yra MEMORY.md? Neseniai atnaujinus Claude Code, jis automatiškai saugo pastabas apie jus faile ~/.claude/projects/<project-name>/memory/MEMORY.md. Tarp jų gali būti pokalbio įpročiai („naudotojas teikia pirmenybę trumpiems atsakymams“), pasikartojančios frazės („uždraudė naudoti jaustukus kode“) ir elgesio pastebėjimai („naudoja macOS ir zsh“).

Tai atskira atminties sistema, o ne CLAUDE.md. Jūs jos nerašote rankiniu būdu – ją, remdamasis pokalbiais, rašo Claude. Jei MEMORY.md yra informacija, kuri turėtų tapti taisykle, perkelkite ją į CLAUDE.md. Jei jame yra nereikalingos ar neteisingos informacijos, galite ją ištrinti rankiniu būdu – tai tekstinis failas.

Kokio dydžio CLAUDE.md naudingas ir kaip peržiūrėti ilgą failą?#

Kiekviename Claude Code lange į kontekstą įkeliami keli sluoksniai: Anthropic sistemos užklausa (manoma, kad joje yra dešimtys tūkstančių žetonų), jūsų CLAUDE.md, naudojant @ importuoti failai, MEMORY.md, dabartinio pokalbio istorija ir Claude atvertų failų turinys. Visa tai turi tilpti į modelio kontekstą (200K žetonų Sonnet atveju, 1M – Opus atveju).

Kuo didesnis CLAUDE.md, tuo mažiau vietos lieka dabartiniam darbui. 1,000 eilučių failas sudaro maždaug 8,000 žetonų, kurie kartojami kiekvienoje sesijoje. Turint Pro prenumeratą (mano patirtimi, maždaug 10-12 „sudėtingų“ užklausų per dieną), pajėgumas sumažėja ketvirtadaliu.

Kaina yra tik vienas rūpestis. Instrukcijų laikymasis gali prastėti, kai jos ilgos, neaktualios ar prieštaringos; nėra visuotinio patikimai vykdomų instrukcijų skaičiaus. Išbandykite kelias būdingas užduotis, tikrinančias svarbiausias taisykles, užfiksuokite nesėkmes ir palyginkite elgseną po tikslingo pakeitimo.

Štai praktinė dydžio taisyklė:

• 80-120 eilučių – patogus pradinis glaustos projekto schemos dydis, o ne garantuotas instrukcijų laikymosi rodiklis.
• 150-200 eilučių – naudingas priminimas peržiūrėti aktualumą ir išsamias procedūras perkelti į susietus failus.
• 200-300 eilučių – tikrinkite žetonų kiekį, pasikartojimus ir užduočių rezultatus; pirmiau pateiktas 280 eilučių verslo pavyzdys vis dar gali veikti gerai.
• 400+ eilučių – svarus pagrindas tikslinei peržiūrai, o ne įrodymas, kad failas nenaudojamas. Išlaikykite esminius apribojimus, o detales perkelkite tik patikrinę, kad nuorodos ir taisyklės vis dar veikia.

Vien eilučių skaičius nepatvirtina sėkmės ar nesėkmės. Po pakeitimo pakartokite tas pačias būdingas užduotis ir patikrinkite svarbias taisykles, užuot priskyrę išgalvotą atitikties procentą.

Anthropic dokumentacijoje pateikiamas tiesioginis testas:

Pritaikykite šį testą kiekvienai eilutei. Jei atsakymas „vis tiek susitvarkytų teisingai“, eilutę pašalinkite. CLAUDE.md nėra dokumentacijos, sprendimų istorijos ar filosofijos vieta. Jame turi būti tik taisyklės, padedančios agentui neprisidaryti bėdų.

Kokios 7 klaidos paverčia CLAUDE.md nenaudingu?#

1 klaida. „Būk geras inžinierius“

Dažniausia klaida. Žmonės CLAUDE.md rašo bendrus pageidavimus: „rašyk švarų kodą“, „taikyk geriausias praktikas“, „mąstyk kaip vyresnysis inžinierius“.

Šie žodžiai nieko nereiškia. Claude ir taip bendrąja prasme rašo „švarų kodą“. Tokios eilutės užima kontekstą, bet nekeičia jokių sprendimų.

Vietoj „rašyk švarų kodą“ nurodykite „naudok 2 tarpų įtrauką“, „TypeScript nenaudok any“ arba „funkcijos turi būti ne ilgesnės nei 30 eilučių“. Konkrečiai ir patikrinamai.

2 klaida. Kartojama tai, ką Claude jau žino

Standartinių kalbos ypatybių aprašymai („JavaScript funkcijos yra pirmos klasės objektai“, „TypeScript turi statinę tipizaciją“). Aiškinimai, kaip veikia npm, git ar docker.

Claude visa tai išmoko per mokymą. Kartoti tai CLAUDE.md faile nieko neduoda – tik mažina jūsų kontekstui skirtą vietą.

3 klaida. Ilgos nuoseklios instrukcijos CLAUDE.md faile

Ilgos instrukcijos, kaip „įdiegti projektą“, „sukurti duomenų bazės migraciją“ ar „parengti naują komponentą“. Dešimtys žingsnis po žingsnio pateiktų eilučių.

Šis failas ne vieta ilgoms instrukcijoms. Jis skirtas vienos eilutės taisyklėms. Ilgas instrukcijas įrašykite į skills/ (atskirą Claude Code mechanizmą, įkeliamą pagal poreikį) arba docs/ aplanką. CLAUDE.md užtenka vienos eilutės nuorodos: „Kurdami naują migraciją, atverkite docs/migrations.md.“

4 klaida. Taisyklės, kurias jau tikrina automatinis kodo analizatorius

„Naudok kabliataškius“, „nepalik nenaudojamų importų“, „nenaudok var.“ Visa tai aptinka ESLint, Prettier ir Biome – jie yra „linters“ (automatiniai kodo tikrinimo įrankiai).

Linteris veikia deterministiškai: paleidžiamas, randa klaidą ir ją ištaiso. CLAUDE.md taisyklė yra tikimybinė; agentas gali ją pamiršti. Nereikia dubliuoti – paprasčiau sukonfigūruoti linterį.

5 klaida. Paslaptys CLAUDE.md faile

Esu matęs bandomųjų paskyrų slaptažodžių, smėliadėžės API žetonų ir nuorodų į prisijungimą reikalaujančius administravimo skydelius. Visa tai buvo įtraukta į git ir įkelta į Anthropic modelio kontekstą.

Niekada. Paslaptys turi būti .env faile, nurodytame .gitignore. CLAUDE.md daugiausia gali būti parašyta: „Neskaityk viso .env turinio; konkretaus kintamojo ieškok naudodamas grep.“

6 klaida. Daugiau nei 500 eilučių turintis sąvartynas, kurio niekas netvarkė šešis mėnesius

CLAUDE.md išaugo, dubliuoja pusę docs/, keliose vietose pats sau prieštarauja ir niekas nebeprisimena, kas jame parašyta. Agentas ima ignoruoti didžiąją dalį instrukcijų. Komanda skundžiasi, kad „Claude nesilaiko nurodymų“, ir prideda dar daugiau taisyklių, taip tik pablogindama padėtį.

Apleisto CLAUDE.md požymiai: daugiau nei 300 eilučių, skirtinguose skyriuose kartojamos taisyklės, nuorodos į nebeegzistuojančius failus ir „istorinės“ pastabos, tokios kaip „2024 m. taip nusprendėme, paskui persigalvojome“.

Sprendimas: kas dvi savaites paprašykite Claude peržiūrėti failą pagal Anthropic testą: „Jei ši eilutė būtų pašalinta, ar agentas padarytų klaidą?“ Ištrinkite eilutes, kuriose atsakymas „ne“.

7 klaida. CLAUDE.md sukurtas ir pamirštas

Tai priešinga ankstesnei klaidai. Failas buvo sudarytas kartą prieš du mėnesius ir nuo tada nepaliestas. Tuo tarpu pasikeitė įrankiai, atsirado naujų aplankų ir kilo naujų agento klaidų. CLAUDE.md apie visa tai nieko nežino, nes niekas jo neatnaujino.

Aiškus ženklas: kiekvienoje sesijoje kartojate tą pačią instrukciją. „Nedaryk X“, „neliesk Y“, „prisimink Z“. Jei pakartojote daugiau nei du kartus, taisyklė turi būti CLAUDE.md, o ne jūsų galvoje.

Kaip padaryti, kad CLAUDE.md mokytųsi pats, įtraukus taisyklę „atnaujink sesijos pabaigoje“?#

Mano CLAUDE.md yra trumpas skyrius:

## 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.

Pridėjus šį skyrių prie CLAUDE.md, Claude kiekvienos sesijos pabaigoje ėmė klausti: „Ar buvo kas nors naujo, ką verta užrašyti?“ Jei taip, jis pasiūlydavo taisyklės juodraštį, aš jį patikslindavau ir būdavo sukuriamas failas.

Po dviejų mėnesių tokio darbo about-me/feedback/ turiu daugiau nei dvi dešimtis failų – taisyklių, išmoktų iš konkrečių klaidų. Kiekvienas failas yra vienas puslapis „Taisyklė → Kodėl → Kaip“ formatu. Aplankas tapo „antrąja atmintimi“, kurioje užrašyti mano individualūs prioritetai ir tabu.

Klaida nebekartojama, nes virsta taisykle, o taisyklės kaupiasi ir papildo viena kitą. Po šešių mėnesių Claude mano projektą išmano geriau, nei aš jį prisimenu po mėnesio pertraukos.

Kaip į CLAUDE.md įtraukti teisines, rinkodaros ir veiklos taisykles?#

Daugumai komandų CLAUDE.md yra vien techninis dokumentas: įrankiai, kūrimo komandos, programavimo susitarimai. Tai naudinga, bet sudaro tik trečdalį vertės.

Kai verslininkas prižiūri CLAUDE.md, verta pridėti verslui skirtus skyrius. Svarbiausi trys:

Teisinės taisyklės (reguliuojamoms rinkoms)

Jei skelbiate tekstus reguliuojamoje srityje (finansai, medicina, vaistų reklama, vaikams skirti produktai), draudžiami žodžiai turi teisinę reikšmę ir turi būti aiškiai įrašyti į CLAUDE.md. Ne kažkieno galvoje, ne redaktoriaus ekrano kopijoje, o faile, kurį agentas mato kiekvienoje sesijoje.

Pavyzdys finansinių technologijų projektui be banko licencijos:

Redakcinė pastaba: toliau parodytas konkretaus projekto vidinės taisyklės formatas. Tai nėra universalus leidimas vartoti išvardytus terminus: teiginio priimtinumas priklauso nuo taikytinos teisės ir įmonės statuso.

🚨 KRITIŠKA – draudžiama vartoti finansines formuluotes. Klientams skirtuose tekstuose nevartokite: „indėlis“, „garantuota grąža“ ar „investicinis produktas“. Vartokite: „taupomoji sąskaita“, „tikėtina grąža“ ir „kintamos palūkanų normos produktas“. Priežastis – šiam projektui taikomi finansinių paslaugų reklamos teisiniai reikalavimai.

Šis CLAUDE.md blokas atlieka paprastą funkciją: kaskart, kai prašote Claude parašyti klientams skirtą tekstą, agentas patikrina, ar jame nėra draudžiamų žodžių. Be šios taisyklės draudžiami žodžiai atsiranda kas trečioje kampanijoje. Su ja apie juos pamirštate.

Tas pats metodas tinka:

• Medicinos projektams (negalima teigti, kad kas nors „gydo“ ar „išgydo“).
• Vaistų reklamai (negalima teigti „veiksmingiausias“; privalomi įspėjimai).
• Bet kuriai kitai reguliuojamai sričiai, kuriai taikomos reklamos taisyklės.

Rinkodaros stilius ir tekstų formatas

Jei reguliariai skelbiate tekstus (socialiniuose tinkluose, naujienlaiškiuose, svetainėse), verta vienoje pastraipoje aprašyti jų formatą CLAUDE.md faile. Štai pavyzdys, ką galėtų parašyti nuomonės formuotojas arba pranešimų kanalą valdanti agentūra:

Rašydamas kanalo įrašus, žiūrėk style/posts.md. Naudok kanalo leidžiamus formatavimo žymeklius ir venk „pavojingų“ specialiųjų simbolių. Užbaik CTA, turinčia UTM žymą pagal šią tvarką: utm_source=<channel>&utm_medium=<type>&utm_campaign=<slug>.

Anksčiau Claude rašydavo įrašus „bendru rinkodaros svetainės stiliumi“. Dabar jis laikosi jūsų formato, naudoja jūsų UTM žymas ir neišduoda, kad tekstą parašė dirbtinis intelektas.

Veiklos įpročiai

Sąlygų ir veiksmų lentelės. Kai pasakote konkrečią frazę, agentas žino, kuriuos failus atverti ir kokių veiksmų imtis. Štai pavyzdys savaites planuojančiai komandai:

„Suplanuok savaitę“ → atverk ops/monthly.md, sukurk YYYY-WNN.md tame pačiame aplanke ir perkelk užduotis iš ops/backlog.md į atitinkamas dienas. „Kas yra darbų sąraše?“ → perskaityk ops/backlog.md ir pateik sąrašą. „Užbaik savaitę“ → užpildyk dabartinės savaitės failo skiltį „Savaitės apžvalga“.

Naudojant tokias lenteles, Claude iš „pagalbininko, kuris rašo kodą“ tampa „operatoriumi“, išmanančiu jūsų verslo rutiną. Kiekvieną pirmadienį sakau: „suplanuokime savaitę“, o Claude atidaro reikiamus failus, perskaito mėnesio tikslus ir pasiūlo, kaip juos suskaidyti į užduotis.

Kaip per 5 minutes patikrinti CLAUDE.md pagal 12 punktų kontrolinį sąrašą?#

1. Dydis. Ar failas glaustas, maždaug 200 eilučių laikant peržiūros orientyru, o ne tinkamumo riba?
2. Pavadinimas. Ar jis tiksliai vadinasi CLAUDE.md didžiosiomis raidėmis, o ne claude.md?
3. Vieta. Ar jis yra projekto šaknyje arba ./.claude/CLAUDE.md?
4. Projekto aprašymas. Ar iš pirmųjų 5 eilučių aišku, kas tai per projektas ir kam jis skirtas?
5. Įrankiai. Ar technologijos aiškiai išvardytos be perteklinių žodžių?
6. Struktūra. Ar yra saugyklos schema su paaiškinimais?
7. Maršrutizavimas. Ar yra lentelė „klausimas → failas“, nurodanti, kur ieškoti atsakymų?
8. Principai. Ar yra skyrius su taisyklėmis, prasidedančiomis „niekada“ ir „visada“?
9. Konkretumas. Ar kiekvieną taisyklę galima patikrinti? („Naudok 2 tarpus“, o ne „rašyk gražiai“.)
10. Savęs atnaujinimas. Ar yra taisyklė „sesijos pabaigoje patikrink, ką reikėtų pridėti“?
11. Apžvalga. Ar yra taisyklė „įrašyk sesijos santrauką į retrospectives/“?
12. Saugumas. Ar kritiniai draudimai (.env, rm -rf) įtraukti ir į .claude/settings.json?

Jei daugiau nei penki atsakymai yra „ne“, atidarykite Claude ir pateikite jam šią užklausą:

Read my CLAUDE.md and compare it with the checklist below. For each item, say: yes / no / partly, and what specifically to fix.

Checklist:

Glaustas pagal užduotį; ties maždaug 200 eilučių peržiūrėti, nelaikant to griežta riba

Project description in the first 5 lines

Tools listed explicitly

Repository structure diagram included

“Question → file” table included

Principles section with rules included

Every rule is specific and verifiable

“Update at the end of the session” rule included

“Reflect at the end of the session” rule included

Critical prohibitions included in .claude/settings.json

No duplicates of the same rule in different sections

No dangling links to files that no longer exist

After the audit, give me a list of specific changes that will make the file living.

Ką naudoti po CLAUDE.md: Plan Mode, Skills ar sub-agents?#

CLAUDE.md yra pagrindas. Jam pradėjus veikti, galite pridėti tris viena kitą stiprinančias Claude Code priemones.

Plan Mode. Režimas, kuriuo Claude pirmiausia sudaro pakeitimų planą, laukia jūsų patvirtinimo ir tik tada pradeda dirbti. Jį įjunkite naudodami Shift+Tab arba komandą /plan. Jis sprendžia pagrindinį vibe coding skaudulį: „Paprašiau Claude pataisyti vieną dalyką, o jis perrašė pusę projekto.“ Plan Mode režimu taip nenutiks – pamatysite planą dar prieš agentui paliečiant failus.

Skills. Atskiri .md failai aplanke .claude/skills/, kuriuose pateikiamos konkretaus tipo užduočiai skirtos žinios. Pavyzdžiui, „kaip sukurti duomenų bazės migraciją“ įgūdyje aprašoma procedūra, pateikiamas šablonas ir pavyzdžiai. Šių žinių nėra CLAUDE.md, nes jų per daug. Tačiau susidūręs su užduotimi, pavyzdžiui, „sukurk migraciją“, Claude įkelia reikiamą įgūdį ir juo vadovaujasi.

Sub-agents. Kai užduočiai reikia daug konteksto (pavyzdžiui, peržiūrėti didelę funkciją), Claude gali paleisti atskirą sub-agentą su švariu kontekstu. Sub-agentas atlieka darbą ir grąžina rezultatą neužgriozdindamas pagrindinio pokalbio konteksto.

Visos trys priemonės naudoja CLAUDE.md kaip atspirties tašką: prieš pradėdamos darbą jos jį perskaito, kad suprastų projekto kontekstą. Todėl be nuolat atnaujinamo CLAUDE.md šios funkcijos taip pat veikia prastai. Pirmiausia – pagrindas, o tada ant jo dedami kiti sluoksniai.

Kitas žingsnis. Projekto šaknyje sukurkite CLAUDE.md failą, nukopijuokite šio straipsnio pradžioje esantį šabloną ir užpildykite laužtiniuose skliaustuose esančius laukus naudodami pagalbinę užklausą. Tada kurį laiką naudokite failą: kiekvieną agento klaidą paverskite viena nauja eilute. Po dviejų ar trijų savaičių CLAUDE.md nebebus „dokumentas, kurį parašėme ir pamiršome“ – Claude iš tikrųjų skaitys jį kiekvienoje sesijoje.

Jei norite sukurti visą sistemą aplink CLAUDE.md – aplanką business/ antrajam protui, aplanką about-me/ skaitmeniniam jūsų atspindžiui, pagrindinius įgūdžius ir sukonfigūruotą Plan Mode – pasinaudokite šiame straipsnyje pateiktais žingsniais ir pavyzdžiais. Ailoot vadovai.

Toliau skaitykite Ailoot vadovus.