CLAUDE.md’ni 2026-yilda qanday sozlash kerak: shablon va 6 qoida

Vibe coding bo‘yicha materiallar: vositalar, amaliy misollar, xatolar. Ailoot qo‘llanmalari.

Nega CLAUDE.md kerak va usiz Claude loyihani nega unutadi?#

Seshanba kuni Claude Code’ni ochib, unga shunday tushuntirasiz: “Men shu loyiha ustida ishlayapman, vositalar mana bular, buni qilma.” Hammasi ishlaydi.

Payshanba kuni o‘sha chat allaqachon tugagan bo‘ladi, shuning uchun hammasini yana takrorlaysiz. Shanba kuni yana, dushanba kuni esa yana bir marta.

CLAUDE.md’siz agent bilan ishlash shunday ko‘rinadi: har bir yangi oyna — xuddi shu gaplarni qayta-qayta aytishingiz kerak bo‘lgan, hamma narsani noldan boshlaydigan stajyor. Men har bir seansda shu kirish tushuntirishlarini yozishga 5-10 daqiqa sarflardim. Barcha kontekstni qo‘lda kiritishim kerak bo‘lgani uchun so‘rovlar uzayib ketardi. Natija esa baribir umumiy bo‘lardi: agent auditoriyamni, iqtisodiy modelimni yoki tamoyillarimni bilmasdi.

Doimiy yangilanib turadigan CLAUDE.md bo‘lsa, kirish tushuntirishlari kerak bo‘lmay qoladi. Har bir chatda takrorlaydigan barcha qoidalaringiz bitta faylda turadi va har bir seans boshida avtomatik ko‘rinadi. So‘rov qisqaradi: “X ni bajar”, deysiz, “Men Y loyihada ishlayapman, vositalar Z, A yoki B ni qilma, aytgancha, C ni ham eslab qol”, deyish o‘rniga.

Shunda takroriy xatolar ham yo‘qoladi.

Agentning har bir xatosi CLAUDE.md’ga bir qator qo‘shish uchun sababdir. Bir oydan keyin sizda doimiy yangilanib turadigan “loyiha konstitutsiyasi” bo‘ladi va Claude tanish tuzoqlarga qayta-qayta tushmaydi.

Yana bir jihati bor: agent bo‘shliq ichida yozmay qo‘yadi. CLAUDE.md orqali men Claude’ni kontekstli papkalarga yo‘naltiraman: auditoriya, narxlar va brending haqidagi ma’lumotlarni qayerdan topishni ko‘rsataman. Bu yo‘naltirishsiz agent iqtisodiy modelimni bilmay turib “yuqori sifatli yechimlar” yozadi, natijada ular mavhum, qolipli va “boshqalarnikiga o‘xshash” bo‘lib chiqadi.

CLAUDE.md nima va Claude uni qaysi tartibda o‘qiydi?#

Anthropic o‘zining rasmiy hujjatlarida CLAUDE.md’ni shunday ta’riflaydi:

Claude Code CLAUDE.md’ni qidiradigan to‘rt joy, ustuvorlik darajasi o‘sib borish tartibida:

To‘rtta fayl ham bir vaqtda kontekstga yuklanadi. Qoidalar o‘zaro zid bo‘lsa, Anthropic hujjatlarida qaysi biri ustuvor bo‘lishi noma’lumligi bevosita aytilgan; Claude ulardan birini tasodifiy tanlashi mumkin. Shuning uchun barcha muhim ma’lumotlarni loyiha CLAUDE.md faylida saqlash va dublikat yaratmaslik osonroq.

Deyarli hech kim yozmaydigan, ammo ko‘p g‘alati xatti-harakatlarni tushuntiradigan bir texnik jihat bor.

Boshqacha aytganda, CLAUDE.md qat’iy ma’noda “tizim so‘rovi” emas. Bu Claude ko‘radigan birinchi foydalanuvchi xabaridir. Demak, undagi qoidalar qonun emas, kuchli tavsiyalardir. Majburiy bajarish kerak bo‘lsa, qamralgan hodisaga sinalgan hook, keng kirish chegarasiga ruxsat yoki muhit izolyatsiyasi qo‘llang. Avtomatik hook tekshiruvi to‘liq ekanini bildirmaydi. hooks va CLAUDE.md o‘rtasidagi chegarani quyida tushuntiraman.

Minimal CLAUDE.md’ni 5 daqiqada qanday yozish mumkin (tayyor shablon)?#

Quyida o‘nlab loyihalarimda sinab ko‘rgan shablon keltirilgan. U faylni 80-120 qator atrofida saqlaydi, bu Anthropic’ning 200 qatordan kamga intilish tavsiyasiga mos. Bu shablon bilan agent eng maqbul natijalarni beradi.

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

Claude’ga loyiha uchun ushbu shablonni avtomatik to‘ldirishga imkon berish uchun, unga mana shu so‘rovni bering. U kontekstni o‘qib, kvadrat qavs ichidagi maydonlarni to‘ldiradi:

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.

CLAUDE.md’ni 200 qatordan kam saqlashga intiling. Uzun bo‘lsa, takrorni ko‘rib, batafsil tartibni havolali faylga ko‘chiring. Muhim rejalash, reflection va repo qoidalarini saqlab, namunaviy vazifalarda sinang.

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

Always respond in the user’s preferred language.

Agar sizda hali about-me/ va business/ papkalari bo‘lmasa, bu muammo emas. Claude aniqlashtiruvchi savollar beradi va mavjud ma’lumotlar asosida minimal CLAUDE.md tuzadi. Papkalarga nimalar kiritishni bilib olganingizdan keyin ularni yaratishingiz mumkin.

CLAUDE.md’ni doimiy hujjatga aylantiradigan 6 qoida qaysilar?#

1-qoida. 200 qatordan kamga intilib, muhim qoidalarni sinang

Anthropic rasmiy hujjatlarida buni qisqa ifodalaydi:

Uzun CLAUDE.md ikki jihatdan o‘ziga qarshi ishlaydi. Birinchidan, tokenlarni sarflaydi. 800 qatorli ko‘rsatmalar fayli har bir oynaga yuklanadi va har bir seansda limitingizdan bir necha ming tokenni oladi. Kunlik limiti bor Pro obunasida bu mavjud seanslar sonini sezilarli kamaytiradi. Ikkinchidan, model qoidalarni e’tiborsiz qoldira boshlaydi.

Hujjat kontekstni kamaytirish va ko‘rsatmaga amal qilish uchun 200 qatordan kamga intilishni tavsiya qiladi. 201-qatorda keskin buzilish chegarasini bermaydi. Nimani chiqarishdan oldin tegishlilik, ziddiyat, yuklangan token va haqiqiy natijani ko‘ring.

2-qoida. Har bir seansni fikr yuritish bilan yakunlang

CLAUDE.md’da shunday yozing: “Har bir seans oxirida nima qilganingizni va nimani o‘rganganingizni retrospectives/YYYY-MM-DD_*.md fayliga qayd eting.” Bu qatorni qo‘shganingizdan keyin Claude har bir seansni o‘zi yakunlay boshlaydi; so‘rashingiz shart bo‘lmaydi.

Nega fikr yuritish kerak:

• Ikki haftadan keyin eski retrospektivani ochib, nima uchun shu yo‘lni tanlaganingizni eslashingiz mumkin.
• Bir oy o‘tib loyihaga qaytganingizda, yaqindagi qarorlar xaritasi tayyor bo‘ladi.
• Jamoada ishlasangiz, hamkasbingiz qo‘ng‘iroqsiz ikki daqiqada retrospektivani o‘qib, hozirgi holatni tushunishi mumkin.

3-qoida. Har bir tugallangan vazifadan keyin commit qiling

CLAUDE.md’imda shunday yozilgan: “Har bir tugallangan vazifadan keyin mazmunli xabar bilan git commit yarating.” Claude ishni o‘zi kichik, alohida commitlarga ajrata boshlaydi.

Bu sizga ikki narsa beradi. Birinchidan, nimadir buzilsa, bugun qilgan “hamma ishingizni” emas, bitta amalni ortga qaytarasiz. Ikkinchidan, commit tarixi nima va qachon o‘zgarganini ko‘rsatuvchi ish jurnaliga aylanadi.

4-qoida. Doimo business/ papkasiga murojaat qiling

Mijozlar, mahsulotlar yoki matn bilan bog‘liq har qanday vazifada agent avval business/INDEX.md va unda ko‘rsatilgan tegishli faylni ochishi kerak. CLAUDE.md’imda bu aniq yozilgan: “UI yoki matn ustida ishlaganda avval business/audience/avatar.md va business/assets/brand-guidelines.md fayllarini tekshir.”

Bu qoidasiz Claude “sifatli veb-saytning umumiy uslubida” matn yozadi. Qoida bo‘lsa, matn sizning uslubingizda, mijozingiz uchun va taqiqlangan so‘zlarsiz yoziladi.

5-qoida. Agent har safar xato qilganda qoida qo‘shing

Bu CLAUDE.md’ni doimo yangilanib turadigan qilib saqlaydigan bosh qoida.

Muayyan xatolardan keyin o‘z CLAUDE.md’imga qo‘shgan qoidalarimdan misollar:

• “Boshqa birovning WIP fayllarini git add . bilan hech qachon commit qilmang — fayllarni nomi bilan stage qiling.”
• “main’ga push qilishdan oldin git log origin/main..main --oneline buyrug‘ini tekshiring — natija bo‘sh bo‘lmasa, push qilmang.”
• “Qiymatlarni o‘ylab topmang — ularni .env yoki koddan oling. Ayniqsa URL, foydalanuvchi nomi va tokenlarni.”

Bu qatorlarning har biri muayyan voqeaning izidir. Bir safar agent hamkorimning tugallanmagan tarmog‘ini commit qilgan. Boshqa safar birovning hali push qilinmagan commitlarini o‘zimnikiga qo‘shib yuborganman. Yana bir safar agent mavjud bo‘lmagan URL’ni o‘ylab topgan. Har bir xato qoidaga aylanadi va o‘zingizga o‘zingiz yetkazgan o‘sha jarohat qayta takrorlanmaydi.

6-qoida. Xavfsizlik qoidalarini CLAUDE.md’da emas, .claude/settings.json’da saqlang

CLAUDE.md’da “.env’ga tegma” deb yozishingiz mumkin, ammo bu iltimos xolos; Claude uni buzishi mumkin, chunki CLAUDE.md qonun emas, foydalanuvchi xabari sifatida yuklanadi. Muhim xavfsizlik qoidalari uchun .claude/settings.json’dan foydalaning — u yerda ayrim buyruqlarni qat’iy bloklash mumkin.

Har bir yangi loyihaga qo‘shadigan bloklash ro‘yxatim:

• rm -rf (fayllarni rekursiv o‘chirish).
• .env faylini to‘liq o‘qish (Read .env).
• Bir buyruqda export va curl (sirlarni tashqariga chiqarish usuli).
• Aniq ruxsatsiz git push --force.

Boshqa qo‘llanmalarni Ailoot saytidan toping.

Faol biznesda CLAUDE.md qanday tuzilgan (280 qatorli fayl anatomiyasi)?#

Internetdagi CLAUDE.md misollarining aksariyati dasturchilar uchun texnik shablonlar: “TypeScript’dan foydalan”, “50 qatordan uzun test yozma.” Tadbirkor uchun bunday CLAUDE.md foydasiz — unda biznes tomoni yoritilmagan.

Quyida men ishlatadigan CLAUDE.md tuzilmasi keltirilgan. Ichki ish jarayonlarimni aks ettirgani uchun muayyan qoidalar va yo‘llarni olib tashladim. Ammo bo‘limlar tuzilmasi va mantiqini har qanday loyihaga tatbiq etish mumkin: o‘z sharoitingizga moslang, shunda ishchi faylga ega bo‘lasiz.

1. Loyiha haqida qisqacha tavsif (15 qator). Nima ish qilamiz, auditoriyamiz kim, qanday mahsulotlar taklif qilamiz. Bu marketing sayti mazmunining qayta hikoyasi emas, agent “qayerga ketayotganimizni” anglashi uchun qisqa ma’lumot.

2. Men haqimda (10 qator). Men qanday fikrlashimning raqamli tasviri bo‘lgan about-me/ papkasiga havola. Ohang, qadriyatlar, tamoyillar va taqiqlangan so‘zlar. Claude matnni “mening nomimdan” yozganda, ovozimga moslashish uchun avval shu papkani o‘qiydi.

3. Repozitoriy tuzilmasi (20 qator). Izohlar qo‘shilgan daraxt ko‘rinishi: kod, biznes konteksti, rejalar va fikr-mulohazalar qayerda. Bu xaritasiz Claude har safar fayllarni ko‘r-ko‘rona qidiradi.

4. “Kerakli ma’lumotni qayerdan topish mumkin” jadvali (25 qator). “Savol → fayl” yo‘nalishi. Masalan, ko‘chmas mulk agentligi uchun: “ipoteka shartlari kerak → business/products/mortgage.md” yoki “postlar uchun ohang kerak → business/assets/voice.md.” Fayllaringizni shunga moslang. Bu jadval CLAUDE.md’ning eng muhim qismidir. Usiz agent javob qaysi faylda ekanini taxmin qiladi. Jadval bo‘lsa, to‘g‘ri manbaga boradi.

5. Loyihaning asosiy tamoyillari (40 qator, 10-15 band). Bu bo‘lim sekin to‘planadi va eng ko‘p mehnat talab qiladi. Har bir band muayyan xatoning izidir. Masalan, onlayn do‘kon qoidalari: “narx va yetkazib berish muddatlarini hech qachon kodga qotirib yozma”, “aniq buyruqsiz mahsulotni e’lon qilma” va “mahsulot e’lonini chop etishdan oldin uslubni brend lug‘ati bilan tekshir.” Bu bo‘lim — “loyiha konstitutsiyasi.”

6. Operatsion rejalashtirish (20 qator). “Foydalanuvchi iborasi → harakat” bog‘lanishlarini ko‘rsatuvchi jadval. Masalan: “Haftani rejalashtir” deganimda ops/monthly.md faylini och va haftalik fayl yarat. Bu Claude’ni buyruqlarning kontekstini tushunadigan operatsion yordamchiga aylantiradi.

7. Vositalar (5 qator). Texnologiyalar. Qisqa, ortiqcha gaplarsiz.

8. Nashr qilish (15 qator). O‘zgarishlarni ishlab chiqarish muhitiga chiqarish bo‘yicha bosqichma-bosqich jarayon: qaysi buyruqlarni, qaysi tartibda bajarish va nimalarni tekshirish. Avvallari buni har safar tushuntirardim. Endi Claude buni biladi.

9-12. Xavfsizlik (35 qator). To‘rtta alohida kichik bo‘lim: .env bilan ishlash qoidalari, ishlab chiqarish ma’lumotlar bazasiga kirish, namoyishlar uchun xavfsiz buyruqlar (ekran yozuvlari, translatsiyalar, skrinshotlar — tokenlar tasodifan oshkor bo‘lmasligi uchun) va sirlarni yangilash qoidalari.

13. plans/ papkasi (10 qator). Reja standarti: fayl nomi, bosqichlar tuzilmasi va xulosa blokiga nima yozish kerakligi.

14. retrospectives/ papkasi (5 qator). Fikr-mulohaza standarti: shablon, fayl nomi va unda nima bo‘lishi kerakligi.

15. Faol ma’lumotlar bazasi ma’lumotlari (15 qator). “Yangi ma’lumot”ni belgilash qoidasi: faylda raqamlar joriy bo‘lishi kerakligi aytilsa, agent eskilaridan foydalanmay, ma’lumotni manbadan oladi. Bu Claude’ning kechagi raqamlardan foydalanish xavfini bartaraf etadi.

16. Til (3 qator). “Doimo foydalanuvchi afzal ko‘rgan tilda javob ber. Faqat defis ishlat, uzun tire ishlatma.”

Jami taxminan 280 qator. Ixchamlik maqsadidan yuqori, lekin fayl yaroqsiz emas. Misolda foydali qolgan; saqlash qarori kontekst o‘lchovi va namunaviy testga bog‘liq. Jadval matndan avtomatik arzon tokenli emas.

/init buyrug‘i nima qiladi va nega u yetarli emas?#

Anthropic hujjatlarida buyruq shunday ta’riflanadi:

/init nimalarni yaxshi bajaradi:

• package.json, Cargo.toml va pyproject.toml fayllaridan vositalarni aniqlaydi.
• Yig‘ish va test buyruqlarini sanaydi.
• Mavjud fayllardagi qoidalarni (.eslintrc, .prettierrc) aniqlaydi.
• Mavjud Cursor qoidalarini (.cursorrules, .cursor/rules/) va Copilot qoidalarini topib, tegishli qismlarini qo‘shadi. CLAUDE_CODE_NEW_INIT=1 rejimida AGENTS.md faylini ham topadi.

/init nimalarni qilmaydi:

• Mijozingiz kimligini bilmaydi.
• Matn uchun taqiqlangan so‘zlaringizni kiritmaydi.
• Agent xatolari bo‘yicha qoidalar qo‘shmaydi, chunki hali bunday xatolar bo‘lmagan.
• Biznes tuzilmasi bo‘yicha “ma’lumotni qayerdan topish mumkin” jadvalini yaratmaydi.

Shuning uchun to‘g‘ri ish tartibi quyidagicha:

1. Claude Code’da /init buyrug‘ini bajaring

   Siz vositalar va buyruqlardan iborat 30-50 qatorli boshlang‘ich CLAUDE.md olasiz. Bu texnik asosdir.

2. Ushbu maqoladagi shablonni ustiga qo‘shing

   “Minimal CLAUDE.md’ni 5 daqiqada yozish” bo‘limidagi shablondan foydalaning. Navigatsiya, yo‘naltirish va tamoyillar bo‘limlarini qo‘shing.

3. Kvadrat qavs ichidagi maydonlarni to‘ldiring

   Claude’ga “loyihamni o‘qi va shablonni to‘ldir” deb so‘rang. Agar business/ va about-me/ papkalari hali bo‘lmasa, Claude aniqlashtiruvchi savollar beradi.

4. Sinovdan o‘tkazing

   Claude’ga “CLAUDE.md faylimni o‘qi va agent sifatida uni noto‘g‘ri tushunishim mumkin bo‘lgan 10 ta noaniqlikni top” deb ayting. Tuzatishlar ro‘yxatini olasiz.

5. So‘ng fayldan foydalaning

   Agent har safar xato qilganda bir qator qo‘shing. Bir oy ichida biznesingizga mos doimiy yangilanib turadigan CLAUDE.md’ga ega bo‘lasiz.

To‘rtinchi qadam uchun so‘rov:

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 vs AGENTS.md vs MEMORY.md: 2026-yilda qaysi faylni kim o‘qiydi?#

Yangi foydalanuvchilarni chalg‘itadigan asosiy savol: Claude Code AGENTS.md’ni o‘qiydimi? 2026-yil sentabrigacha javob “yo‘q” edi: Anthropic hujjatlarida AGENTS.md’ni import qiladigan CLAUDE.md yaratish tavsiya etilgan. 2.1.277 versiyasidan boshlab (2026-yil 18-sentabrda chiqarilgan) Claude Code AGENTS.md’ni o‘zi o‘qiydi, ammo faqat ishchi papkada yoki undan yuqorida CLAUDE.md, .claude/CLAUDE.md yoki CLAUDE.local.md bo‘lmasa.

Loyihada CLAUDE.md bo‘lsa, Claude Code odatda faqat shuni o‘qiydi va AGENTS.md’ni o‘tkazib yuboradi. Buni /config menyusidagi Project instructions bo‘limida o‘zgartirishingiz mumkin: masalan, claude-md-and-agents-md sozlamasi ikkala faylni ham o‘qitadi. Har qanday versiyada ishlaydigan yana bir yo‘l bor: CLAUDE.md’ga import qo‘shing:

@AGENTS.md

## Claude Code

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

@filename sintaksisi boshqa faylni import qiladi. Claude uni o‘qib, CLAUDE.md bilan birga kontekstga yuklaydi. Claude Code AGENTS.md’ni mustaqil o‘qiy olsa ham, import faylning ikki marta o‘qilishiga sabab bo‘lmaydi.

AGENTS.md qachon kerak. Claude Code hamda Codex CLI, Cursor yoki Copilot’ni birgalikda ishlatsangiz, yagona haqiqat manbasi sifatida AGENTS.md yarating, CLAUDE.md’ga @AGENTS.md kiriting va ustiga Claude’ga xos qoidalarni qo‘shing. Bunday maxsus qoidalar bo‘lmasa, CLAUDE.md yaratishingiz shart emas: 2.1.277 versiyasidan boshlab Claude Code AGENTS.md’ni o‘zi o‘qiydi. Faqat Claude Code bilan ishlasangiz, AGENTS.md kerak emas, faqat bitta CLAUDE.md’dan foydalaning. Barcha variantlarning bosqichma-bosqich tavsifi uchun bir loyihada AGENTS.md va CLAUDE.md’dan foydalanish qo‘llanmasini ko‘ring.

MEMORY.md nima? Yaqindagi yangilanishdan beri Claude Code foydalanuvchi haqidagi qaydlarni ~/.claude/projects/<project-name>/memory/MEMORY.md faylida avtomatik saqlaydi. Bular suhbatdagi odatlar (“foydalanuvchi qisqa javoblarni afzal ko‘radi”), takrorlanadigan iboralar (“kodda emojilarni taqiqladi”) va xulq-atvorga oid kuzatuvlar (“macOS’da ishlaydi, zsh’dan foydalanadi”) bo‘lishi mumkin.

Bu CLAUDE.md’dan alohida xotira tizimidir. Uni qo‘lda yozmaysiz; Claude suhbatlaringiz asosida yozadi. MEMORY.md’da qoidaga aylanishi kerak bo‘lgan biror narsa bo‘lsa, uni CLAUDE.md’ga ko‘chiring. Keraksiz yoki noto‘g‘ri ma’lumot bo‘lsa, qo‘lda o‘chirishingiz mumkin; bu oddiy matn fayli.

CLAUDE.md uchun foydali hajm qanday va uzun fayl qanday ko‘riladi?#

Claude Code’ning har bir oynasida kontekstga bir necha qatlam yuklanadi: Anthropic’ning tizim so‘rovi (o‘n minglab token deb taxmin qilinadi), CLAUDE.md, @ bilan import qilingan fayllar, MEMORY.md, joriy chat tarixi va Claude ochadigan fayllar mazmuni. Bularning barchasi model kontekstiga sig‘ishi kerak (Sonnet uchun 200K token, Opus uchun 1M).

CLAUDE.md qanchalik katta bo‘lsa, joriy ish uchun shunchalik kam joy qoladi. 1,000 qatorli fayl taxminan 8,000 token bo‘lib, har bir seansda qayta yuklanadi. Pro obunasida (mening tajribamda, kuniga taxminan 10-12 ta “og‘ir” so‘rov) bu imkoniyatingizni chorakka kamaytiradi.

Narx yagona muammo emas. Uzun, keraksiz yoki zid ko‘rsatmada amal qilish pasayishi mumkin; ishonchli bajariladigan universal qoida soni yo‘q. Kritik qoidalarni ishlatadigan bir nechta namunaviy vazifani sinang, xatolarni yozing va yo‘naltirilgan tahrirdan keyin xulqni solishtiring.

Fayl hajmi bo‘yicha taxminiy qoida:

• 80-120 qator — qisqa loyiha xaritasi uchun qulay boshlanish, kafolatli amal bali emas.
• 150-200 qator — tegishlilikni ko‘rib, batafsil tartibni havolali faylga chiqarish eslatmasi.
• 200-300 qator — token, takror va natijani tekshiring; yuqoridagi 280 qatorli misol ham ishlashi mumkin.
• 400+ qator — maqsadli ko‘rikka kuchli sabab, yaroqsizlik isboti emas. Muhim chegarani saqlang; havola va qoida ishlashi tekshirilgach tafsilotni ko‘chiring.

Qator soni o‘zi muvaffaqiyat yoki xatoni isbotlamaydi. Uydirma rioya foizi o‘rniga tahrirdan keyin ayni vazifalarni takrorlab, muhim qoidani tekshiring.

Anthropic hujjatlarida bevosita sinovni taklif qiladi:

Buni har bir qatorga qo‘llang. “Baribir to‘g‘ri bajarardi” degan javob chiqsa, qatorni olib tashlang. CLAUDE.md hujjatlar, qarorlar tarixi yoki falsafa uchun joy emas. U faqat agent xato qilmasligi uchun kerak bo‘lgan qoidalarga mo‘ljallangan.

Qaysi 7 xato CLAUDE.md’ni foydasiz qiladi?#

1-xato. “Yaxshi muhandis bo‘l”

Eng ko‘p uchraydigan xato. Odamlar CLAUDE.md’da umumiy tilaklarni yozadi: “toza kod yoz”, “eng yaxshi amaliyotlardan foydalan”, “katta muhandisdek fikrla.”

Bu iboralar hech narsani anglatmaydi. Claude umumiy ma’noda allaqachon “toza kod” yozadi. Bunday qatorlar hech bir qarorga ta’sir qilmay, kontekstni egallaydi.

“toza kod yoz” o‘rniga “2 ta bo‘sh joy bilan chekinishdan foydalan”, “TypeScript’da any ishlatma” yoki “funksiyalar 30 qatordan oshmasin” deb yozing. Aniq va tekshirish mumkin bo‘lgan qoida bo‘lsin.

2-xato. Claude allaqachon biladigan narsalarni takrorlash

Dasturlash tillarining odatiy qoidalarini ta’riflash (“JavaScript’da funksiyalar birinchi darajali obyekt”, “TypeScript statik tiplashga ega”). npm, git yoki docker qanday ishlashini tushuntirish.

Claude bularning barchasini o‘qitish jarayonida o‘rgangan. CLAUDE.md’da takrorlash hech narsa qo‘shmaydi, faqat kontekstni kamaytiradi.

3-xato. CLAUDE.md ichida uzun, bosqichma-bosqich ko‘rsatmalar

“Loyihani qanday joylashtirish”, “ma’lumotlar bazasi migratsiyasini qanday yozish” yoki “yangi komponentni qanday sozlash” haqida uzun ko‘rsatmalar. O‘nlab ketma-ket qatorlar.

Bu uzun, bosqichma-bosqich yo‘riqnomalar uchun joy emas. U bir qatorli qoidalarga mo‘ljallangan. Uzun ko‘rsatmalarni skills/ papkasiga (kerak bo‘lganda yuklanadigan Claude Code’ning alohida mexanizmi) yoki docs/ papkasiga joylang. CLAUDE.md’da bir qatorli havola qoldiring: “Yangi migratsiya yaratganda docs/migrations.md faylini och.”

4-xato. Avtomatik kod analizatori allaqachon tekshiradigan qoidalar

“Nuqtali vergul ishlat”, “ishlatilmaydigan importlarni qoldirma”, “var ishlatma.” ESLint, Prettier va Biome bularning barchasini aniqlaydi — ular linterlar (kodni avtomatik tekshiruvchi vositalar).

Linter deterministik ishlaydi: ishga tushadi, xatoni topadi va tuzatadi. CLAUDE.md qoidasi esa ehtimoliy xarakterga ega; agent uni unutishi mumkin. Buni takrorlash shart emas — linter sozlamalarini o‘zgartirish osonroq.

5-xato. CLAUDE.md’da maxfiy ma’lumotlar

Men test hisoblari parollari, sandbox API tokenlari va autentifikatsiyadan o‘tgan administrator panellariga havolalarni ko‘rganman. Bularning hammasi git’ga kiritilgan faylda va Anthropic modeli kontekstiga yuklangan edi.

Hech qachon bunday qilmang. Maxfiy ma’lumotlar .gitignore’ga kiritilgan .env faylida saqlanishi kerak. Eng ko‘pi bilan CLAUDE.md’da shunday yozish mumkin: “.env faylini to‘liq o‘qimang; muayyan o‘zgaruvchini tekshirish uchun grep’dan foydalaning.”

6-xato. Olti oy davomida tozalanmagan, 500+ qatorli chiqindi fayl

CLAUDE.md kattalashgan, docs/’ning yarmini takrorlaydi, bir necha joyida o‘ziga zid va unda nimalar borligini hech kim eslamaydi. Agent ko‘p qoidalarni e’tiborsiz qoldira boshlaydi. Jamoa “Claude ko‘rsatmalarga amal qilmayapti” deb shikoyat qiladi va yana ko‘proq qoida qo‘shib, vaziyatni yomonlashtiradi.

E’tiborsiz qoldirilgan CLAUDE.md belgilari: 300 qatordan ko‘pligi, turli bo‘limlarda takrorlangan qoidalar, endi mavjud bo‘lmagan fayllarga eskirgan havolalar va “2024-yilda shunday qaror qilgandik, keyin fikrimizni o‘zgartirdik” kabi tarixiy qaydlar.

Yechim: har ikki haftada Claude’dan Anthropic sinovi bilan tekshirishni so‘rang: “Bu qator olib tashlansa, agent xato qiladimi?” Javob “yo‘q” bo‘lgan narsalarni o‘chiring.

7-xato. CLAUDE.md’ni yaratib, unutish

Bu avvalgi xatoga teskari holat. Fayl bir marta, ikki oy oldin tuzilgan va shundan beri yangilanmagan. Bu vaqt ichida vositalar o‘zgargan, yangi papkalar qo‘shilgan va yangi agent xatolari yuzaga kelgan. Hech kim yangilamagani uchun CLAUDE.md bularning hech birini bilmaydi.

Aniq belgi: har seansda bir xil ko‘rsatmani takrorlaysiz. “X ni qilma”, “Y ga tegma”, “Z ni eslab qol.” Buni ikki martadan ko‘proq takrorlagan bo‘lsangiz, qoida miyangizda emas, CLAUDE.md’da bo‘lishi kerak.

“Seans oxirida yangilash” qoidasi bilan CLAUDE.md’ni qanday o‘zini o‘rganuvchi qilish mumkin?#

CLAUDE.md’imda qisqa bo‘lim bor:

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

Bu bo‘lim CLAUDE.md’ga qo‘shilgach, Claude har bir seans oxirida “Qayd etishga arziydigan yangi narsa bo‘ldimi?” deb so‘ray boshladi. Agar bo‘lsa, qoida loyihasini taklif qildi, men aniqlik kiritdim va fayl yaratildi.

Ikki oy shu tarzda ishlaganimdan so‘ng, about-me/feedback/ papkasida ikki o‘nlabdan ortiq fayl to‘plandi — muayyan xatolardan o‘rganilgan qoidalar. Har bir fayl Qoida → Sabab → Qo‘llash usuli formatidagi bir sahifadan iborat. Papka shaxsiy afzalliklarim va taqiqlarim yozilgan “ikkinchi xotira”ga aylandi.

Har bir xato qayta takrorlanmaydi, chunki u qoidaga aylanadi; qoidalar esa to‘planib, bir-birini mustahkamlaydi. Olti oydan keyin Claude uzoq tanaffusdan so‘ng o‘zim eslaydiganidan ham ko‘proq loyihamni biladi.

CLAUDE.md’ga huquqiy qoidalar, marketing va operatsion ishlarni qanday qo‘shish mumkin?#

Ko‘pchilik jamoalar uchun CLAUDE.md sof texnik hujjat: vositalar, yig‘ish buyruqlari, kodlash qoidalari. Bu foydali, lekin qiymatining faqat uchdan bir qismi.

Tadbirkor CLAUDE.md’ni yuritganda, unga biznes bo‘limlarini qo‘shish ma’qul. Eng muhimi uchtasi:

Huquqiy qoidalar (tartibga solinadigan bozorlar uchun)

Tartibga solinadigan sohada (moliya, tibbiyot, dori reklamasi, bolalar mahsulotlari) matn chop etsangiz, taqiqlangan so‘zlar huquqiy ahamiyatga ega va CLAUDE.md’da aniq qoida sifatida yozilishi kerak. Birovning xotirasida emas, muharrir skrinshotida emas — agent har bir seansda ko‘radigan faylda.

Bank litsenziyasi bo‘lmagan fintech loyihasi uchun misol:

Tahririy izoh: Quyida muayyan loyiha uchun ichki qoida formati ko‘rsatilgan. Bu sanab o‘tilgan atamalardan foydalanishga berilgan universal ruxsat emas: iboraning maqbulligi amaldagi qonunchilik va kompaniya maqomiga bog‘liq.

🚨 MUHIM — moliyaviy iboralarni ishlatish taqiqlanadi. Mijozlarga mo‘ljallangan materiallarda “depozit”, “kafolatlangan daromad” yoki “investitsiya mahsuloti” iboralarini ishlatmang. Buning o‘rniga “jamg‘arma hisobi”, “kutilayotgan daromad” va “o‘zgaruvchan stavkali mahsulot” iboralarini ishlating. Sababi — ushbu loyiha uchun moliyaviy xizmatlar reklamasiga tatbiq etiladigan huquqiy talablar.

CLAUDE.md’dagi bu blok oddiy vazifani bajaradi: Claude’dan mijozlarga mo‘ljallangan matn yozishni so‘raganingizda, agent uni taqiqlangan iboralarga nisbatan tekshiradi. Qoidalarsiz taqiqlangan so‘zlar har uch kampaniyaning birida paydo bo‘ladi. Qoida bo‘lsa, ular borligini unutib qo‘yasiz.

Xuddi shu yondashuv quyidagilarda ham ishlaydi:

• Tibbiy loyihalarda (“davolaydi” yoki “tuzatadi” degan da’volarsiz).
• Dori reklamasida (“eng samarali” da’volarisiz va majburiy ogohlantirishlar bilan).
• Reklamasi o‘z qoidalariga bo‘ysunadigan har qanday tartibga solinadigan sohada.

Marketing uslubi va matn formati

Muntazam matn chiqarsangiz (ijtimoiy tarmoqlar, xatlar, veb-saytlar), formatni CLAUDE.md’da bir paragrafda hujjatlashtirish foydali. Xabar kanali yuritadigan bloger yoki agentlik yozishi mumkin bo‘lgan misol:

Kanal postlarini yozganda style/posts.md fayliga murojaat qiling. Kanalda ruxsat etilgan formatlash belgilaridan foydalaning va “xavfli” maxsus belgilardan saqlaning. UTM belgisi ushbu andozaga mos CTA bilan yakunlang: utm_source=<channel>&utm_medium=<type>&utm_campaign=<slug>.

Avvallari Claude postlarni “marketing saytidagi umumiy uslubda” yozardi. Endi formatingizga amal qiladi, UTM belgilaringizni ishlatadi va matn AI yozganini bildirmaydi.

Operatsion odatlar

Trigger jadvallari. Muayyan iborani aytsangiz, agent qaysi fayllarni ochish va qanday harakat qilishni biladi. Haftalik reja tuzadigan jamoa uchun misol:

“Haftani rejalashtir” → ops/monthly.md faylini oching, shu papkada YYYY-WNN.md yarating va ops/backlog.md’dagi vazifalarni tegishli kunlarga ko‘chiring. “Backlog’da nimalar bor?” → ops/backlog.md faylini o‘qing va ro‘yxat shaklida ko‘rsating. “Haftani yakunla” → joriy haftaning faylidagi “Hafta xulosasi” bo‘limini to‘ldiring.

Bunday jadvallar yordamida Claude “kod yozadigan yordamchi”dan biznes tartibini biladigan “operator”ga aylanadi. Har dushanba “haftani rejalashtiraylik” deyman, Claude kerakli fayllarni ochadi, oylik maqsadlarni o‘qiydi va vazifalarni qanday bo‘lish mumkinligini taklif qiladi.

CLAUDE.md’ni 12 bandli ro‘yxat bilan 5 daqiqada qanday tekshirish mumkin?#

1. Hajmi. Ixchammi? Taxminan 200 qatorni PASS/FAIL chegarasi emas, ko‘rik maqsadi deb oling.
2. Nomi. Katta harflar bilan aynan CLAUDE.md deb yozilganmi, claude.md emasmi?
3. Joylashuvi. Loyiha ildizidami yoki ./.claude/CLAUDE.md ichidami?
4. Loyiha tavsifi. Dastlabki 5 qatorda loyiha nima ekanligi va kim uchun mo‘ljallangani tushunarlimi?
5. Vositalar. Texnologiyalar ortiqcha gaplarsiz aniq sanab o‘tilganmi?
6. Tuzilma. Izohli repozitoriy diagrammasi bormi?
7. Yo‘naltirish. Javoblarni qayerdan topish ko‘rsatilgan “savol → fayl” jadvali bormi?
8. Tamoyillar. “Hech qachon” va “doimo” bilan boshlanadigan qoidalar bo‘limi bormi?
9. Aniqlik. Har bir qoidani tekshirish mumkinmi? (“2 ta bo‘sh joy ishlat”, “chiroyli yoz” emas.)
10. O‘zini yangilash. “Seans oxirida nimani qo‘shish kerakligini tekshir” qoidasi bormi?
11. Fikr-mulohaza. “Seans xulosasini retrospectives/’ga yoz” qoidasi bormi?
12. Xavfsizlik. Muhim taqiqlar (.env, rm -rf) .claude/settings.json’da ham bormi?

Beshtadan ortiq javob “yo‘q” bo‘lsa, Claude’ni ochib, unga shu so‘rovni bering:

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

Checklist:

Vazifaga yetarli ixcham; 200 qator atrofida ko‘rib chiqing, qat’iy chegara demang

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.

CLAUDE.md’dan keyin nimadan foydalanish kerak: Plan Mode, Skills yoki sub-agents?#

CLAUDE.md — poydevor. U ishlay boshlagach, bir-birini to‘ldiradigan uchta Claude Code mexanizmini qo‘shishingiz mumkin.

Plan Mode. Claude avval o‘zgarish rejasini tuzib, tasdiqlashingizni kutadigan va shundan keyingina ishni boshlaydigan rejim. Uni Shift+Tab yoki /plan buyrug‘i bilan yoqing. U vibe coding’dagi asosiy og‘riqli nuqtani hal qiladi: “Claude’dan bitta narsani tuzatishni so‘radim-u, u loyihaning yarmini qayta yozdi.” Plan Mode’da bunday bo‘lmaydi — agent biror faylga tegishidan oldin uning rejasini ko‘rasiz.

Skills. Muayyan vazifa turiga oid bilimlarni o‘z ichiga olgan .claude/skills/ papkasidagi alohida .md fayllar. Masalan, “ma’lumotlar bazasi migratsiyasini qanday yozish” mahorati aniq tartib, shablon va misollarni o‘z ichiga oladi. Bu bilim CLAUDE.md’da yo‘q, chunki juda batafsil. Ammo Claude “migratsiya yoz” kabi vazifaga duch kelganda, tegishli mahorat faylini yuklab, unga amal qiladi.

Sub-agents. Vazifa ko‘p kontekst talab qilsa (masalan, katta funksiyani ko‘rib chiqish), Claude o‘zining toza kontekstida alohida sub-agentni ishga tushirishi mumkin. Sub-agent ishni bajarib, asosiy chat kontekstini ortiqcha ma’lumot bilan to‘ldirmasdan natijani qaytaradi.

Uchala mexanizm ham CLAUDE.md’ni ishga kirishish nuqtasi sifatida ishlatadi: loyiha kontekstini tushunish uchun ish boshida uni o‘qiydi. Shu sababli doimiy yangilanib turadigan CLAUDE.md’siz bu imkoniyatlar ham yomon ishlaydi. Avval poydevor, keyin uning ustiga qatlamlar.

Keyingi qadam. Loyiha ildizida CLAUDE.md faylini yarating, ushbu maqolaning boshidagi shablonni ko‘chirib, yordamchi so‘rovdan foydalanib kvadrat qavs ichidagi maydonlarni to‘ldiring. Keyin undan foydalanishda davom eting: agentning har bir xatosini yangi qatorga aylantiring. Ikki-uch haftadan keyin CLAUDE.md “yozib, unutib qo‘yadigan hujjat” bo‘lmay, Claude har bir seansda murojaat qiladigan vositaga aylanadi.

Agar CLAUDE.md atrofida to‘liq tizim — ikkinchi miya uchun business/ papkasi, raqamli tasviringiz uchun about-me/ papkasi, asosiy Skills va sozlangan Plan Mode — yaratmoqchi bo‘lsangiz, ushbu maqoladagi qadamlar va misollardan foydalaning. Ailoot qo‘llanmalari.

Ailoot bilan davom eting.