Blog

Claude Code’da ikkinchi miya: tuzilmani bir soatda qanday qurish

Markdown

Claude Code uchun ikkinchi miyani qanday qurish: xotira ierarxiyasi, besh qismli papka tuzilmasi va agent loyihangiz haqidagi hamma narsani sessiyalar oralig‘ida eslab qolishi uchun git.

Maqolani to‘liq o‘qish

Asosiy xulosa

Claude Code’dagi ikkinchi miya bitta fayldan iborat emas; u beshta papkadan va git’dan tuzilgan. CLAUDE.md qoidalar va yo‘nalishlarni belgilaydi, business/ loyiha haqidagi bilimlarni saqlaydi, ai-clone/ qaror qabul qiluvchi sifatida siz haqingizdagi ma’lumotlarni saqlaydi, plans/ texnik rejalarni saqlaydi, retrospectives/ esa oldingi sessiyalardan olingan saboqlarni jamlaydi. Agent CLAUDE.md’dan boshlaydi va muayyan so‘rov uchun kerakli papkaga havolalar orqali o‘tadi. Ushbu maqolada Claude Code’ning rasmiy hujjatlaridagi xotira ierarxiyasi, besh qismli tuzilma va uni bir soat ichida bosqichma-bosqich qurish usuli yoritiladi.

Ailoot ma’lumotnomasi: ailoot.ai/docs/.

Nega Claude Code’ga ikkinchi miya kerak va unda nimalar bo‘lishi zarur?

Asosiy xulosa

Bitta CLAUDE.md fayli asosiy qoidalarni qamrab oladi, ammo biznes xotirasining o‘rnini bosa olmaydi. Bir oy o‘tgach, narxni nega oshirganingizni unutib qo‘yasiz. Uch oydan keyin bo‘lib to‘lashni nega rad etganingizni ham eslay olmaysiz. Bilim bir vaqtning o‘zida to‘rt joyda yashaydi: boshingizda, Telegram chatlarida, Google hujjatlarida va xodimlarning xotirasida. Ikkinchi miya bularning barchasini loyiha yonidagi bitta markdown fayllari papkasiga jamlaydi va Claude unga o‘zi murojaat qila oladi.

Seshanba kuni Claude Code’ni ochasiz. Tushuntirasiz: bu loyiha, bu auditoriya, buni qilma. Birga ishlaysiz. Payshanba kuni esa yangi chat ochiladi va yana hammasini boshidan tushuntirishingiz kerak bo‘ladi.

Agar sizda CLAUDE.md bo‘lsa, dastlabki hafsalasizlik muammosini hal qilgansiz. Asosiy qoidalar va loyiha tavsifi bitta faylda turadi va har bir sessiyada yuklanadi. Bu fayl qanday ishlashini CLAUDE.md bo‘yicha qo‘llanmamda tushuntirganman — avval uni o‘qib, poydevorni tayyorlab olishingiz mumkin.

Ammo CLAUDE.md yangi xodim uchun yo‘riqnomaga o‘xshaydi. Qanday kiyinish, mijozlar bilan qanday ohangda gaplashish, nashr qilish uchun qaysi buyruqlardan foydalanish. Loyiha haqida yaxshi qarorlar qabul qilish uchun buning o‘zi yetarli emas. Qarorlar uchun bilim kerak: mahsulot nima, auditoriya kim, iqtisodiyot qanday ishlaydi, nimalarni sinab ko‘rgansiz va nimalar samara bermagan.

Bu yerda bayon qilingan muallif tajribasida, avvallari bu bilimlar to‘rt joyda yashagan: uning xotirasida, Telegram chatlarida, Google hujjatlarida va xodimlarning xotirasida. Qarordan bir oy o‘tgach, hech kim uning nega qabul qilinganini eslay olmasdi. Yangi xodim ishga kirishib ketish uchun jamoadan bir soat savol so‘rardi. Claude esa bu kontekstning bir qismi ham emasdi.

Muallif bayon qilgan tajribada, ikkinchi miya bo‘lmasidan oldin har bir sessiyada mijoz kimligini, taklif qanday tuzilganini va to‘lovlarni qaysi provayder amalga oshirishini qaytadan tushuntirish kerak bo‘lardi. business/ bo‘lgach, chatni ochib: “yangi narx rejasiga moslab taklifni yangila”, deyman — Claude o‘zi business/company/legal.md fayliga o‘tib, talablarni o‘qiydi, so‘ng business/products/pricing.md fayliga o‘tib, yangi narx rejasini ko‘radi va bir urinishda tahrir taklif qiladi. Ish boshidagi tushuntirishlarga ehtiyoj qolmaydi; kontekst avtomatik yuklanadi.

Izoh

Bu Claude xotirasidagi muammo emas. Bu arxitektura masalasi. Agentning kontekst oynasi uning ishchi xotirasidir. U faqat o‘zingiz ko‘rsatgan narsalarni yuklaydi. Qolgan hamma narsa oynadan tashqarida bo‘ladi va kerak bo‘lgandagina yuklanadi. Ikkinchi miya shu “qolgan narsalar”ni Claude yo‘l topa oladigan tartibli shaklda saqlaydi.

Anthropic muhandislik blogida bu muammoni “kontekstning buzilishi” (context rot) deb ataydi:

Kontekst oynasidagi tokenlar qancha ko‘p bo‘lsa, model o‘sha kontekstdagi ma’lumotni aniq eslashda shuncha qiynaladi.
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents

Boshqacha aytganda, oynaga qancha ko‘p narsa joylasangiz, agent aniq ma’lumotlar bilan ishlashda shuncha qiynaladi. Yechim — Claude muayyan so‘rovga javoban o‘zi ochib ko‘ra oladigan tashqi fayllar tuzilmasini saqlash. Ikkinchi miya aynan shudir.

Ikkinchi miya nima va u Claude’ga qanday tatbiq etiladi?

Asosiy xulosa

G‘oya oddiy: ong fikrlash uchun, narsalarni saqlash uchun emas. Tashqi raqamli arxivdagi qaydlar Claude Code uchun unumdorlik usulidan agent arxitekturasiga aylanadi: agent ularga fayl tizimi orqali bevosita kira oladi.

Odatda, ikkinchi miya unumdorlikni oshirish uchun ishlatiladi: odamlar Obsidian omborini yaratib, kitoblardan parchalar, qo‘ng‘iroqlardan qaydlar va loyiha g‘oyalarini qo‘shadilar.

Muallif bu g‘oyani Claude Code bilan ishlashga tatbiq etgach, u unumdorlik masalasi bo‘lmay, agent arxitekturasiga aylandi.

An’anaviy yondashuvda ikkinchi miya sizniki bo‘ladi va unga qo‘lda murojaat qilasiz. Claude Code bilan ishlaganda esa u ikki tomonlama bo‘ladi: unga siz ham, agent ham murojaat qiladi. Bu uning formatiga qo‘yiladigan talablarni o‘zgartiradi.

Agent unga o‘zi murojaat qilgani uchun fayllar alohida integratsiyasiz tushunadigan formatda bo‘lishi kerak. Markdown juda mos: matn, sarlavhalar ierarxiyasi va fayllar orasidagi havolalar. Notion va Google Docs mos kelmaydi. Ularni MCP orqali ulash mumkin, ammo bu yana bir qatlam, har bir so‘rov uchun yana bir token xarajati va yana bir nosozlik nuqtasini qo‘shadi.

Fayllar loyiha yonidagi fayl tizimida turgani uchun ular avtomatik ravishda Claude Code’ning ixtiyorida bo‘ladi. Hech qanday sozlash kerak emas. Agentni loyiha papkasida ishga tushiring, shunda u ichidagi barcha fayllarni ko‘ra oladi. Bu bepul va darhol ishlaydi.

Maslahat

Ikkinchi miyangizni Obsidian’da saqlashingiz mumkin — aloqalar grafigini ko‘rish oson bo‘lgani uchun men ham uni u yerda ochaman. Ammo fayllarning o‘zi kod yonidagi oddiy papkada bo‘ladi. Obsidian — markdown fayllar uchun qulay qobiq, xolos. Claude ularni Obsidiansiz ham ko‘ra oladi. Istalgan muharrirdan foydalanishingiz mumkin; muhimi, fayllar o‘z formatiga ega bulut xizmatida emas, diskda bo‘lsin.

Claude Code’da tayyor holda qanday xotira ierarxiyasi mavjud?

Asosiy xulosa

Claude Code tayyor holda CLAUDE.md’ning to‘rt darajasini (enterprise, user, project va local) o‘qiy oladi. 2.1.59 versiyasidan boshlab u ~/.claude/projects/<project>/memory/ papkasida o‘zining avtomatik xotirasini ham yuritadi. Bu asosiy xotira uchun yetarli, lekin biznes konteksti uchun emas — uni loyiha yonidagi alohida papkaga joylaysiz.

O‘zingizdan biror narsa qo‘shishdan oldin, Claude sizning yordamingizsiz nimalarni eslay olishini ko‘rib chiqaylik. Anthropic o‘zining rasmiy hujjatlarida ikkita mexanizmni tasvirlaydi: CLAUDE.md (siz yozadigan qoidalar) va avtomatik xotira (Claude o‘zi yozadigan saboqlar). Ikkalasi ham har bir sessiya boshida yuklanadi.

CLAUDE.md bir vaqtning o‘zida to‘rt joydan qidiriladi:

DarajaJoylashuviMaqsadi
Enterprise/Library/Application Support/ClaudeCode/CLAUDE.md (macOS), /etc/claude-code/CLAUDE.md (Linux), C:\Program Files\ClaudeCode\CLAUDE.md (Windows)Administrator MDM orqali butun jamoaga joriy qiladigan qoidalar. Alohida foydalanuvchilarga bu kerak emas.
User~/.claude/CLAUDE.mdBarcha loyihalarda amal qiladigan shaxsiy qoidalar. “Menga ma’qul tilda javob ber”, “uzun tire ishlatma”.
ProjectLoyiha ildizidagi ./CLAUDE.mdMuayyan loyiha uchun qoidalar: stek, papkalar tuzilmasi, biznes qoidalari. Git’ga qo‘shiladi.
Local./CLAUDE.local.mdBu loyiha haqidagi, git’ga qo‘shilmaydigan shaxsiy qaydlaringiz. .gitignore ichida.

To‘rtta faylning barchasi kontekstga yuklanadi. Daraja qanchalik aniq bo‘lsa, ustuvorligi shunchalik yuqori bo‘ladi. Local fayl oxirida o‘qiladi, shu sabab undagi qoidalar qolganlaridan ustun keladi.

CLAUDE.md fayli loyihaning istalgan ichki papkasida ham bo‘lishi mumkin. Claude ichki papkadagi faylni o‘qiyotganda o‘sha papkaning CLAUDE.md faylini kerak bo‘lganda yuklaydi. Bu monorepo’da foydali: frontend qoidalari frontend/CLAUDE.md faylida, backend qoidalari backend/CLAUDE.md faylida bo‘ladi va agent tegishli qismda ishlagandagina yuklanadi.

Avtomatik xotira Claude Code 2.1.59’da paydo bo‘lgan. Bular Claude siz haqingizda yozadigan fayllardir:

~/.claude/projects/<project-name>/memory/
├── MEMORY.md          # Indeks, har bir sessiyada yuklanadi (200 satr yoki 25KB)
├── debugging.md       # Batafsil qaydlar (talab bo‘lganda yuklanadi)
├── api-conventions.md
└── ...

Anthropic buni rasmiy hujjatlarda quyidagicha izohlaydi:

Claude har bir sessiyada biror narsani saqlamaydi. U ma’lumot kelajakdagi suhbatda foydali bo‘lishi mumkinligiga qarab, nimani eslab qolishga arziydiganini o‘zi hal qiladi.
— Anthropic, code.claude.com/docs/en/memory

Avtomatik xotira ~/.claude/settings.json ichidagi autoMemoryEnabled bayrog‘i bilan yoqiladi. U yerga nima yozishni Claude hal qiladi. MEMORY.md’ni o‘qish va qo‘lda tahrirlash mumkin — bu oddiy markdown.

Ogohlantirish

Avtomatik xotira foydali, ammo ikkinchi miya o‘rnini bosa olmaydi. Claude u yerda vositalar va kod andozalari haqidagi amaliy xulosalarni yozadi: “bu skript X bayrog‘isiz ishlamaydi”, “ma’lumotlar bazasi jadvali shunday ataladi”. U yerga biznes strategiyasini yozmaydi. Agent auditoriyangiz kimligini va muayyan narxni nega tanlaganingizni eslab qolishini istasangiz, buni alohida kontekst papkasiga o‘zingiz joylashingiz kerak.

CLAUDE.md yoki ikkinchi miya — ular orasidagi chegarani qayerda belgilash kerak?

Asosiy xulosa

CLAUDE.md yangi xodim uchun yo‘riqnoma: o‘zini qanday tutish, qaysi buyruqlardan foydalanish va nimalarni qilmaslik kerakligi haqida. Ikkinchi miya esa kompaniya vikisi: nima qilasiz, kim uchun, iqtisodiyot qanday ishlaydi va nimalarni sinab ko‘rgansiz. Xulq-atvor qoidalarini belgilaydigan bitta fayl va tashqi bilimlar tuzilmasi. CLAUDE.md — indeks, ikkinchi miya — arxiv. Indekssiz agent arxiv borligini bilmaydi. Arxivsiz esa biznes kontekstini emas, faqat qoidalarni biladi.

Chiqishlarimda ishlatadigan qiyos quyidagicha: yangi xodimni ishga oldingiz, deb tasavvur qiling. Birinchi kuni unga nima berasiz?

Yo‘riqnoma: qanday kiyinish, qachon kelish, mijozlar bilan qanday ohangda gaplashish, qaysi tizim orqali nashr qilish. Bu qisqa hujjat. U nima qilishingizni yoki nega bunday qilishingizni tushuntirmaydi. Faqat qanday tutish kerakligini aytadi.

Bundan tashqari, kompaniya vikisidan foydalanish imkonini berasiz. Unda mahsulot nima, kim uchun, auditoriya kim, narxi qancha va nega shunday, raqobatchilar kim, qanday xatolarga yo‘l qo‘yganingiz tushuntiriladi. Bu keng arxiv. Hech kim uning hammasini o‘qimaydi — muayyan savol bo‘lsa, unga murojaat qilasiz.

CLAUDE.md = yo‘riqnoma. Ikkinchi miya = viki. Ikkalasi ham kerak.

Farq oddiy. Har bir vazifa uchun tegishli bo‘lgan hamma narsani CLAUDE.md’ga joylang:

  • Bu loyihadagi agent kim (yordamchi, yetakchi, assistent)
  • Qaysi tilda javob berish
  • Vositalar steki
  • Nashr qilish buyruqlari
  • Taqiqlar (uzun tire ishlatma, git push --force buyrug‘ini bajarma)
  • Yo‘naltirish: biznes konteksti va tamoyillarni qayerdan izlash

Faqat kerak bo‘lganda zarur bo‘ladigan hamma narsani ikkinchi miyaga joylang:

  • Mahsulot, auditoriya, iqtisodiyot va maqsadlar
  • Raqobatchilar va bozor
  • Oldingi qarorlar va ularning sabablari
  • Mijozlar misollari va sharhlar
  • Tamoyillar va metodologiya

Anthropic o‘z hujjatlarida ham xuddi shunday farqni ta’kidlaydi:

CLAUDE.md har bir sessiyada yuklanadi, shuning uchun unga faqat keng qo‘llanadigan narsalarni kiriting. Faqat ba’zida kerak bo‘ladigan soha bilimlari yoki ish jarayonlari uchun ko‘nikmalardan foydalaning. Claude ularni suhbatni ortiqcha yuklamasdan, talab bo‘lganda yuklaydi.
— Anthropic, code.claude.com/docs/en/best-practices

Ko‘nikmalar mavsumiy bilimlarni saqlash usullaridan biri. Loyiha yonidagi business/ papkasi esa boshqasi. Men ikkalasidan ham foydalanaman va quyida batafsilroq tushuntiraman.

Loyiha miyasi nimalardan iborat — 5 qism va vaqt mashinasi

Asosiy xulosa

Loyiha miyasi — git qo‘shilgan beshta papka. CLAUDE.md qoidalar va yo‘nalishlarni belgilaydi. ai-clone/ sizning raqamli aksingizni — tamoyillaringiz, ohangingiz va xatolardan keyingi fikr-mulohazalaringizni — saqlaydi. business/ loyiha haqidagi bilimlarni saqlaydi. plans/ bosqichlar bo‘yicha texnik rejalarni jamlaydi. retrospectives/ sessiyalardan keyingi tahlillarni saqlaydi. Git bularning barchasini vaqt mashinasiga aylantiradi: bir yildan keyin istalgan faylni ochib, qaror qabul qilingan paytda unda nima borligini ko‘rishingiz mumkin.

Muallif bayon qilgan tajribadagi arxitektura namunasi:

PapkaIchida nimalar borMaqsadi
CLAUDE.mdLoyiha qoidalari, stek, fayl tuzilmasi, papkalarga yo‘naltirish, muloqot tiliBu agentning yo‘riqnomasi. Har bir sessiyada yuklanadi. 200 satrdan kam, ideal holatda 80-120 satr.
ai-clone/Men kimman, tamoyillarim, ohangim, qaror qabul qilish uslubim, xatolardan keyingi fikr-mulohazalarQaror qabul qiluvchi sifatidagi mening raqamli aksim. U men nimani darhol rad etishimni, takliflarni qanday uslubda berishimni va xatolardan o‘rgangan qoidalarimni biladi.
business/Mahsulot, auditoriya, maqsadlar, iqtisodiyot, marketing, oldingi qarorlar, misollarVikilinklardan foydalangan, o‘zaro bog‘langan markdown fayllar. Har bir fayl boshqalarga [[...]] havolalari bilan ulanadi. Agent muayyan savol bo‘lsa, shu yerga murojaat qiladi.
plans/Har bir funksiya uchun bittadan reja. Bosqichlar va belgilash kataklari bo‘lgan YYYY-MM-DD-feature.md fayliReja rejimi bitta suhbat doirasida mavjud bo‘ladi va /clear buyrug‘idan keyin yo‘qoladi. plans/ papkasi repozitoriyda turadi — istalgan agent rejani istalgan paytda davom ettira oladi.
retrospectives/Har bir sessiyadan keyingi tahlillar: nima qilindi, nimani eslab qolish kerak, nimani yaxshiroq qilish mumkinTizimning o‘zini o‘zi o‘rganishi. Xatolar ai-clone/feedback/ ichida qoidalarga aylanadi.
+ gitBarcha fayllarning versiya tarixiVaqt mashinasi. Istalgan faylni ochib, qachon va nima sababdan o‘zgarganini git log bilan ko‘ring.

Metodologiyadagi asosiy jihat — ai-clone/ va business/ papkalarini ajratish.

business/ “nima qilamiz?” degan savolga javob beradi. Mahsulot, auditoriya, narxlar, raqobatchilar. Bu loyiha haqida. Ertaga loyihani hamkoringizga topshirsangiz, bu papka loyiha bilan birga ketadi.

ai-clone/ “men qanday qaror qabul qilaman?” degan savolga javob beradi. Tamoyillarim, ohangim, kasb mahoratim va taqiqlangan so‘zlar. Bu men haqimda. Ertaga yangi loyiha boshlasam, bu papka men bilan birga boradi.

Birgalikda ular men “Bir kishilik kompaniya” deb ataydigan modelni yaratadi: bir kishi, tartiblangan kontekst va shu kontekstni o‘qiydigan AI.

Faqat ikkinchi papkani sozlash emas, Claude’ni izchil ishlaydigan tizimni ham qurmoqchimisiz? Buning o‘zi yetarli emas. ai-clone/ bo‘lmasa, agent siz uchun emas, hamma uchun javob beradi. Kontekst muhandisligisiz esa u butun papkani kezib, tokenlarni sarflaydi. Uchalasini bog‘lash foydali: ikkinchi miya + AI klon + kontekst muhandisligi. Bular AI’ning gallyutsinatsiya qilishiga yo‘l qo‘ymaydigan uchta ustun.

business/ ichiga nimalarni joylash va nimalarni joylamaslik kerak?

Asosiy xulosa

business/ ichiga haftada bir marta yoki undan kam o‘zgaradigan loyiha faktlarini joylang: pozitsiyalash, auditoriya, mahsulotlar va narxlar, choraklik maqsadlar hamda muhim qarorlar. Chat yozishmalarini, qayta ishlanmagan xom materiallarni, kodda allaqachon bor ma’lumotlarni, skrinshotlarni va dinamik raqamlarni kiritmang. Raqamlarni LIVE belgisi va SQL so‘roviga havola bilan almashtiring — buni quyida alohida bo‘limda tushuntiraman.

Muallif bayon qilgan loyihadagi yuqori darajadagi business/ tuzilmasi:

business/
├── INDEX.md              ← papkalar xaritasi, avval o‘qing
├── company/              ← missiya, yuridik shaxs, qadriyatlar, huquqiy siyosatlar
├── products/             ← mahsulotlar, dasturlar, narxlar
├── audience/              ← mijoz profili, segmentlar, e’tirozlar
├── goals/                ← yillik, choraklik, oylik maqsadlar, ko‘rsatkichlar
├── economics/            ← birlik iqtisodiyoti, daromad, xarajatlar, prognoz
├── marketing/             ← kanallar, voronka, materiallar, raqobatchilar
├── execution/            ← haftalik rejalashtirish, ishlar navbati
└── assets/               ← dizayn tizimi, sharhlar, matnlar ombori

Bu muallif bayon qilgan loyihadan olingan namuna, qat’iy qoida emas. Papkalarni kerak bo‘lganda yarataman. Dastlab uchta papkadan (products/, audience/, goals/) boshladim; yangilarini 2-3 oy o‘tgach, yangi narsalarni qayerga joylash noaniq bo‘la boshlaganida qo‘shdim.

Papkaning asosiy fayli — INDEX.md. Bu xarita. Unda “savol → fayl” jadvali bo‘ladi, Claude undan qayerga o‘tishni bilib oladi. Usiz agent har bir faylni ketma-ket o‘qib, token sarflaydi.

INDEX.md faylidan namuna:

### Kerakli narsani qayerdan topish mumkin

| Sizga nima kerak | Qayerdan izlash kerak |
|---|---|
| Mijozimiz kimligi va uning muammolari | `business/audience/avatar.md` |
| Mahsulotlar, rejalar va narxlar | `business/products/` |
| Maqsadlar va ko‘rsatkichlar | `business/goals/` |
| Iqtisodiyot (daromad, xarajatlar, birlik iqtisodiyoti) | `business/economics/` |
| Targ‘ibot kanallari va materiallari | `business/marketing/` |

Shundan so‘ng CLAUDE.md’ga bitta satr qo‘shish kifoya: “Biznesga oid savollar uchun business/INDEX.md faylini o‘qing va undagi xaritaga amal qiling.” Agent butun papkani kontekstga yuklamaydi. U xaritani yuklaydi, tegishli faylni tanlaydi va faqat o‘shani o‘qiydi.

business/ ichiga joylamaslik kerak bo‘lgan narsalar ro‘yxati:

  • Qayta ishlanmagan chat yozishmalari. Agar ichida biror xulosa bo‘lsa, uni saralab yozib qo‘ying. Bo‘lmasa, kiritmang.
  • Kodda takrorlangan ma’lumotlar. “To‘lovlar CloudPayments orqali amalga oshiriladi” degan ma’lumot kerak emas; agent buni koddan ko‘ra oladi.
  • Skrinshotlar va rasmlar. Ular papkani kattalashtiradi va qo‘shimcha bosqichsiz matn modelida tahlil qilinmaydi.
  • Dinamik raqamlar. “Bugun mahsulot uchun 423 ta to‘lov bor” ma’lumoti bir haftadan keyin eskiradi. LIVE belgisini va ma’lumotlar bazasi so‘roviga havolani ishlating.
  • Maxfiy yoki shubhali ma’lumotlar. Repozitoriy ertaga YouTube’da 100 ming notanish odam oldida e’lon qilinsa, faqat ko‘rsatishga tayyor bo‘lgan ma’lumotlaringizni qoldiring. Papkani xodimlar, agentlar va ba’zan tashqi pudratchilar o‘qiydi.

Ogohlantirish

Repozitoriy ochiq bo‘lsa, business/ papkasi ham ochiq bo‘ladi. Hozir yopiq bo‘lsa ham, repozitoriy ertaga hammaga ochilishi mumkin, deb hisoblab ikkinchi miyani shunga mos yuritaman. Roziliksiz mijozlarning ismlarini, oylik daromad raqamlarini va parollarni kiritmayman. Bu odat ko‘p tashvishning oldini oladi.

Nega alohida ai-clone papkasi kerak va nega uni business bilan aralashtirmaslik lozim?

Asosiy xulosa

ai-clone/ sizning raqamli aksingizni saqlaydi: tamoyillar, ohang, taqiqlangan so‘zlar va xatolardan keyingi fikr-mulohazalar. Agentning har bir xatosi “qoida → sabab → qanday qo‘llash kerak” formulasi asosida ai-clone/feedback/ ichida qoidaga aylanadi. Bu papka loyihadan loyihaga siz bilan birga boradi. business/ esa loyiha bilan qoladi. Ularni ajrating: yangi loyihada business/ yangidan tuziladi, ammo tamoyillaringiz va uslubingiz o‘zgarmaydi.

G‘oya oddiy: biznes nima qilishimizni biladi. Klon esa men qanday qaror qabul qilishimni biladi.

Muallif bayon qilgan loyihadagi ai-clone/ tuzilmasi:

ai-clone/
├── INDEX.md           ← papkalar xaritasi
├── role.md            ← men kimman, tajribam, nimalar muhim
├── identity/          ← qadriyatlar, qarashlar, missiya
├── thinking/          ← chiqishlardan olingan fikrlash modellari
├── voice/             ← ohang, lug‘at, uslub
├── principles/        ← mahsulot, kod, biznes haqidagi e’tiqodlar
├── feedback/          ← xatolardan o‘rganilgan qoidalar ← asosiy papka
├── style/             ← taqiqlangan so‘zlar, Telegram formati
└── reference/         ← vositalar, muhit

Eng foydali papka — feedback/. Unda agent xatolari orqali o‘rgangan aniq qoidalarim saqlanadi. Har bir qoida alohida faylda, quyidagi formatda yoziladi:

---
name: short-name
description: one line - what’s in the file and when to apply it
type: feedback
---

Bitta qisqa jumlada qoida.

**Nega:** bu qoida nega kerak. Kontekst, hodisa, kuzatuv.

**Qanday qo‘llash kerak:** qoida qachon amal qilishini ko‘rsatuvchi aniq holatlar.

“Nega” bo‘lmasa, qoida foydasiz — agent uni o‘xshash vaziyatga tatbiq eta olmaydi. “Qanday qo‘llash kerak” bo‘lmasa, qoidani qachon ishlatish noaniq bo‘ladi.

Papkamdan misol: “defis ishlat, uzun tire emas” qoidasi. U uzun tire — hosil qilingan matnning muhim vizual belgisi bo‘lgani uchun kiritilgan. Bu qoida ommaga ko‘rsatiladigan barcha matnlarga tegishli. Fayl manzili: ai-clone/feedback/no-em-dashes.md.

Men buni biroz boshqacha qilaman: qoidalarni CLAUDE.md’da emas, ai-clone/feedback/ ichida yozaman. CLAUDE.md — loyiha fayli, ohang va uslub qoidalari esa shaxsiy. Ular men bilan keyingi loyihaga o‘tadi. CLAUDE.md loyiha bilan qoladi.

Izoh

Bu yondashuvning qay darajada yetukligini haftada necha marta agentga ayni bir narsa haqida “yo‘q, bunday emas” deyishingizdan bilsa bo‘ladi. Yetuk tizimda javob — nol. Har bir xato feedback/ ichida qoidaga aylanadi va agent keyingi safar uni takrorlamaydi.

Live Metrics nima va raqamlarni fayllarga nega qat’iy kiritmaslik kerak?

Asosiy xulosa

Ikkinchi miya fayllaridagi raqamlar bir necha kun ichida eskiradi. Bugungi “1,000 mijoz” ertaga 1,050, bir oyda esa 2,000 bo‘lishi mumkin. Raqamni faylga qat’iy kiritsangiz, bir oy o‘tgach agent kechagi ma’lumotlarga asoslangan takliflar beradi. Yechim — faylda LIVE belgisi va tayyor SQL so‘rovlari bo‘lgan alohida live-metrics.md hujjati. Agent LIVE belgisini ko‘rganda, ma’lumotlar bazasiga murojaat qilib, joriy raqamni oladi va yangilangan ma’lumot asosida xulosa qiladi.

Ikkinchi miyani boshlashdagi asosiy xatolardan biri — unga eskirgan raqamlarni to‘ldirish. “Bizda 320 ta mijoz bor” deb yozasiz, ikki haftadan keyin esa 410 ta bo‘ladi. “Oylik daromad 4.7 million” deb yozasiz, bir oy o‘tib esa bu raqam maqsadmi, haqiqiy natijami yoki prognozmi, noma’lum bo‘lib qoladi.

Muallif misolida bu quyidagicha ishlaydi. business/products/practicum.md faylida raqam o‘rniga belgi turadi:

## Guruhlar

> **LIVE** - joriy guruhlar bo‘yicha to‘lovlarni ko‘rish uchun `live-metrics.md` faylining “Sales” bo‘limidagi so‘rovlarni bajaring.

| Guruh | Sanalar | To‘lov qilganlar |
|-------|------|------------|
| 1 | 2026-yil 10-12-mart | LIVE |
| 2 | 2026-yil 24-26-mart | LIVE |

Alohida live-metrics.md faylida tayyor SQL so‘rovlari va ular qaytaradigan natijalar tavsifi bo‘ladi:

## Sotuvlar (guruhlar bo‘yicha to‘lovlar)

```sql
SELECT c.name, COUNT(p.id) AS paid, SUM(p.amount) AS revenue
FROM purchases p
JOIN cohorts c ON c.id = p.cohort_id
WHERE p.status = 'paid'
GROUP BY c.name
ORDER BY c.starts_at DESC;
```

Agentdan “ikkinchi guruh uchun nechta to‘lov bor?” deb so‘rasam, u:

  1. business/products/practicum.md faylini o‘qiydi
  2. Raqam yonidagi LIVE belgisini ko‘radi
  3. live-metrics.md faylini ochadi
  4. “Sales” bo‘limini topadi
  5. So‘rovni ishlab turgan ma’lumotlar bazasida bajaradi
  6. Yangi ma’lumotlardan foydalanib javob beradi

Bu bir vaqtning o‘zida ikkita muammoni hal qiladi. Raqamlar eskirmaydi. Qarorlar ham o‘tgan yilgi emas, joriy vaziyatga asoslanib qabul qilinadi.

Ogohlantirish

Muallif bayon qilgan yondashuvda ishlab turgan ma’lumotlar bazasiga faqat ishonchli agentlar kira oladi. Ularga bunday kirish huquqi so‘rovlarni qayd etadigan va parollarni oshkor qilmaydigan o‘rama orqali beriladi. live-metrics.md fayliga oddiy matn ko‘rinishidagi parolli bevosita psql buyrug‘ini yozish yomon fikr. Parolni muhit o‘zgaruvchisidan oladigan va uni chiqishda ko‘rsatmaydigan o‘rama yarating. Bu alohida texnik qatlam, ammo usiz LIVE xavfsizlik teshigiga aylanadi.

Bitta so‘rov uchun AI ikkinchi miya bo‘ylab qanday yo‘l topadi?

Asosiy xulosa

So‘rov yo‘li doim bir xil: Claude CLAUDE.md’ni o‘qiydi, xaritalarni (business/INDEX.md, ai-clone/INDEX.md) ko‘radi, kerakli INDEX fayliga o‘tadi, u yerdagi havolalar orqali tegishli faylni ochadi va zarur bo‘lsa LIVE orqali raqam oladi. Butun papkani kontekstga joylash o‘rniga 5-6 ta o‘qish amali bajariladi. Oyna fikrlash uchun bo‘sh qoladi, aloqasiz fayllarga token sarflanmaydi.

Masalan, aniq so‘rov: “Yangi guruh ishtirokchilariga elektron xat loyihasini yoz.”

  1. Claude bo‘sh oyna bilan boshlaydi. CLAUDE.md’ni yuklaydi (qoidalar, stek, yo‘naltirish).
  2. CLAUDE.md’dagi yo‘naltirishdan “ai-clone/INDEX.md — sessiya boshida doim o‘qilsin” degan qoidani ko‘radi. Faylni ochib, men kimligimni, ohangim qandayligini va qaysi taqiqlangan so‘zlardan foydalanishimni bilib oladi.
  3. Yo‘naltirishda “elektron xat shablonlari — src/lib/email/layout.ts” deb yozilganini ko‘radi. Faylni ochib, formatni tushunadi.
  4. “Mahsulot konteksti — business/products/practicum.md” deb yozilganini ko‘radi. Faylni ochib, mahsulot haqidagi ma’lumotni o‘qiydi.
  5. Faylda LIVE belgisini va live-metrics.md fayliga havolani ko‘radi. Faylni ochib, tayyor SQL’ni topadi. Joriy raqam kerak bo‘lsa, so‘rovni bajaradi. Kerak bo‘lmasa, “bu raqamni jo‘natish vaqtida ol” deb belgilaydi.
  6. ai-clone/style/telegram-format.md faylidagi ohang qoidalarini, ai-clone/feedback/no-em-dashes.md faylidagi uzun tire taqiqini va business/marketing/funnel.md faylidagi voronka konversiya ko‘rsatkichlarini ko‘radi.

U xatni mening ohangimda, yangi raqamlar bilan va uzun tiresiz hamda AI belgilarisiz yozadi.

Anthropic muhandislik blogida bu yondashuv “kerakli paytda kontekst” (just-in-time context) deb ataladi:

“Kerakli paytda” yondashuvi asosida qurilgan agentlar yengil identifikatorlarni (fayl yo‘llari, saqlangan so‘rovlar, havolalar va hokazo) saqlaydi va ish vaqtida vositalar yordamida shu havolalar orqali ma’lumotlarni dinamik tarzda kontekstga olib kiradi.
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents

Boshqacha aytganda, Claude ma’lumotning o‘zini emas, unga yo‘llovchi ko‘rsatkichlarni olib yuradi. Bu tokenlardan ancha tejamkor va aniqroq, chunki kontekstga faqat tegishli ma’lumot kiradi. Oyna fikrlash uchun ochiq qoladi.

Ikkinchi miyadagi 5 ta noto‘g‘ri yondashuv — nimalardan qochish kerak?

Asosiy xulosa

Yangi boshlovchilarning ikkinchi miya bilan ishlashdagi asosiy xatolari: 1) qisqa yo‘naltiruvchi fayl o‘rniga 500+ satrli kattalashib ketgan CLAUDE.md; 2) tartibsiz omborga aylanadigan barcha narsalar uchun bitta papka; 3) Claude til yoki koddan allaqachon biladigan narsalarni takrorlash; 4) LIVE belgisiz, tez eskiradigan raqamlarni qat’iy yozish; 5) bir repoda yoki alohida xususiy omborda bo‘lishidan qat’i nazar, kontekstga agent kira olmasligi yoki unga yo‘l ko‘rsatilmasligi.

Noto‘g‘ri yondashuv 1. Haddan tashqari kattalashgan CLAUDE.md. “Hamma narsani bitta joyga joylash” uchun 500 satr ko‘rsatma. Anthropic bu borada aniq aytadi:

Qisqa yozing. Har bir satrni ko‘rib: “Buni olib tashlasam, Claude xato qila boshlaydimi?” deb so‘rang. Yo‘q bo‘lsa, o‘chiring. Ortiqcha kattalashgan CLAUDE.md fayllari Claude’ning haqiqiy ko‘rsatmalaringizni e’tiborsiz qoldirishiga sabab bo‘ladi!
— Anthropic, code.claude.com/docs/en/best-practices

Maqsadli uzunlik — 80-120 satr. Qolgan hamma narsani alohida fayllarga joylab, ularga yo‘naltiring.

Noto‘g‘ri yondashuv 2. Barcha narsalar uchun bitta papka. Ikkinchi miyaga hamma narsani tashlaysiz: qayta ishlanmagan chat yozishmalari, keraksiz skrinshotlar, hech kim o‘qimaydigan hisobotlar. Bir oy o‘tgach, papka shishib ketadi, agent keraksiz narsalarni o‘qib token sarflaydi, siz esa nimani qayerga qo‘yganingizni eslay olmaysiz. Qoida: ikkinchi miyadagi har bir fayl muayyan savolga javob berishi kerak. Olti oy davomida hech kim ochmagan bo‘lsa, o‘chiring yoki arxivga ko‘chiring.

Noto‘g‘ri yondashuv 3. Takrorlash. “To‘lovlar src/lib/payment/cloudpayments.ts ichidagi CloudPayments orqali amalga oshiriladi; provayder .env faylida sozlangan.” Agent bularning barchasini koddan ko‘ra oladi. business/ ichida takrorlamang. Takroriy ma’lumotlar eskiradi: kod o‘zgaradi, business/ yangilanmaydi va agent eskirgan ma’lumotga tayanadi.

Noto‘g‘ri yondashuv 4. Raqamlarni qat’iy yozish. “Bizda 1,247 ta mijoz, konversiya darajasi esa 6.3%” — tasavvur qiling, bu qandaydir mavhum fintech startapining raqamlari. Bunday raqamlarning barchasi bir haftada eskiradi. LIVE belgisi va live-metrics.md faylidan foydalaning. Bu haqdagi bo‘lim yuqorida.

Noto‘g‘ri yondashuv 5. Kontekstga ochiq yo‘l yo‘q. Ikkinchi miya boshqa joyda bo‘lib, agentda ruxsat ham, yo‘naltiruvchi havola ham bo‘lmasa, kod papkasidan boshlash yetmaydi. Maxfiy bo‘lmagan umumiy qaydlar uchun business/ va ai-clone/ ni repo ichida saqlash qulay. Xususiy kontekstni alohida boshqariladigan joyda saqlab, ruxsatli kirish va yo‘naltirishni aniq sozlang. Papka qulayligi maxfiylik talabidan ustun emas.

Maslahat

Alohida branch (context yoki business-context) ishni tartiblaydi, lekin kirish chegarasi emas: fayllar o‘sha repo Git obyektlari bo‘lib, branch yoki tarix bilan e’lon qilinishi mumkin. Xususiy biznes kontekstiga aniq kirish nazorati va ruxsatli agent yo‘li bor alohida yopiq repo yoki tashqi ombor tanlang. Submodule xususiy repoga ishora qilishi mumkin, ammo maxfiylikni submodule emas, o‘sha repo ruxsatlari beradi. Yana bir yo‘l — ataylab ignore qilingan mahalliy papka va uning zaxirasi. Ignore allaqachon Git kuzatayotgan fayl yoki e’lon qilingan tarixni olib tashlamaydi. Kod bilan faqat ulashish mumkin bo‘lgan kontekstni saqlang.

Bir soatda ikkinchi miyani qurish — bosqichma-bosqich yo‘riqnoma

Asosiy xulosa

Bir soatda minimal ikkinchi miyani sozlash mumkin: business/ va ai-clone/ ildiz papkalarini yarating, har birida INDEX.md xaritasini tuzing, business/products/ ichida mahsulotning qisqa tavsifini, audience/ ichida mijoz tavsifini va ai-clone/role.md ichida o‘zingiz haqingizdagi tavsifni qo‘shing. CLAUDE.md’da shu papkalarga yo‘naltirishni kiriting. Keyin ishlash jarayonida kengaytiring: agent har bir xato qilganidan so‘ng ai-clone/feedback/ ichiga qoida qo‘shing; har bir qarordan so‘ng business/ ichiga qayd yozing.

  1. Ikkita ildiz papka yarating

    Loyiha ildizida, src/ yonida:

    mkdir -p business/{products,audience,goals,economics,marketing}
    mkdir -p ai-clone/{identity,voice,principles,feedback,style}
    
  2. Papkalar xaritasi sifatida INDEX.md yarating

    business/INDEX.md — “savol → fayl” jadvali. Kamida 5 satrdan boshlang va kerak bo‘lganda yana qo‘shing. Xuddi shuni ai-clone/INDEX.md ichida ham qiling.

  3. Mahsulot va mijozning qisqa tavsiflarini qo‘shing

    business/products/main.md — mahsulot nima, kim uchun, narxi qancha va nimasi bilan farq qilishi. 30-50 satr. business/audience/avatar.md — mijoz kimligi, muammolari va nimalarni sotib olishi. 30-50 satr. Ideal mijozni emas, haqiqiy mijozni tasvirlang. Biror narsani bilmasangiz, “aniqlashtirish kerak” deb belgilang va davom eting.

  4. ai-clone/role.md faylida o‘zingizni tasvirlang

    Kimligingiz, nima qilishingiz va siz uchun nimalar muhimligi. 20-30 satr. Boshlash uchun shu yetarli. Agent sizga xos bo‘lmagan uslubda yoza boshlaganini sezganingizda ohang, tamoyillar va taqiqlangan so‘zlarni qo‘shing.

  5. CLAUDE.md fayliga yo‘naltirishlarni qo‘shing

    CLAUDE.md faylini ochib, bo‘lim qo‘shing:

    ## Loyiha xaritasi
    
    - Biznes konteksti → `business/INDEX.md`
    - Men haqimdagi kontekst → `ai-clone/INDEX.md`
    - Texnik rejalar → `plans/YYYY-MM-DD-*.md`
    - Oldingi sessiyalar tahlili → `retrospectives/`
    
    Sessiya boshida doim `ai-clone/INDEX.md` va `business/INDEX.md` fayllarini o‘qing.
    
  6. Claude Code’ni ishga tushiring va tekshiring

    Agentni oching. “Mahsulotim va auditoriyam haqida aytib ber” deb so‘rang. Papkadagi kontekst asosida javob bersa, demak ishlayapti. Uydirma ma’lumot bersa, papkalar loyiha yonida joylashganini, fayllarning nomi to‘g‘ri yozilganini va CLAUDE.md ichidagi yo‘naltirish aniq ifodalanganini tekshiring.

Shundan keyin ikkinchi miya ikki tamoyil asosida rivojlanadi.

Birinchisi: agent har safar xato qilganda qoida qo‘shing. 3-4 haftadan keyin ai-clone/feedback/ ichida 15-20 ta qoida fayli bo‘ladi va agent keng tarqalgan xatolarning ko‘pini takrorlamaydi.

Ikkinchisi: har bir biznes qaroringizni business/ ichida qayd eting. Narxni oshirsangiz, sabab va sanani yozib business/products/pricing.md fayliga qayd qo‘shing. Pozitsiyalashni o‘zgartirsangiz, business/company/about.md fayliga yozing. Olti oy o‘tgach, sizda “nega”ni eslab qoladigan arxiv bo‘ladi.

So‘rov matni: ikkinchi miyani kechqurun yangilash uchun tayyor so‘rov

Bu hafta birgalikda ancha ish qildik.

Shu haftadagi barcha kod o‘zgarishlari va qilgan barcha commitlarimizni tahlil qil.
Bundan olingan qanday qimmatli ma’lumotlar business/ ichida bo‘lishi kerak? Ularni
kontekst yo‘qolmasligi uchun qo‘shni fayllarga wiki havolalari bilan tegishli fayllarga yoz.

Agar kodda men izohlamagan qarorlar bo‘lsa, sababini mendan so‘ra
va sababini sanasini ko‘rsatgan holda tegishli faylga yoz.

Koddan allaqachon ayon bo‘lgan narsalarni takrorlama. Faqat keyingi sessiyada agent
business/ bo‘lmasa bilmaydigan ma’lumotlarni kirgiz.

Keyingi qadam — Skills, Subagents va kontekst muhandisligi

Asosiy xulosa

Ikkinchi miya va CLAUDE.md — poydevor. Uning ustiga Skills (vazifa tavsifiga qarab, kerak bo‘lganda yuklanadigan amaliy bilimlar), Subagents (og‘ir vazifalar uchun o‘z kontekst oynalariga ega alohida Claude nusxalari) va kontekst muhandisligini (oynaga nimalar kirishini boshqarish) qo‘shing. Bular yuqoridagi uch qavat. Poydevorsiz ular ishlamaydi — agent o‘qiydigan narsa bo‘lmaydi.

Ikkinchi miya tayyor bo‘lgach, Anthropic kontekstni optimallashtirishning uch xil darajasi deb ta’riflaydigan yana uchta vosita bor.

Skills — amaliy bilimlar. Agar takrorlaydigan ish jarayoningiz bo‘lsa (o‘quv qo‘llanmasi yozish, Telegram posti tayyorlash, veb-saytni tekshirish), uni vazifa tavsifi bilan SKILL.md faylida ifodalashingiz mumkin. Sessiya boshida Claude ko‘nikmalarning nomi va tavsiflarini ko‘rib chiqadi hamda joriy vazifaga moslarini yuklaydi. Bu tokenlarni tejaydi va diqqatni kerakli narsaga qaratadi.

Subagents — o‘z kontekst oynalariga ega alohida Claude nusxalari. Murakkab vazifa uchun subagentni ishga tushiring (30 ta faylni o‘qib, xulosa tayyorlash kabi), u o‘z oynasida ishlaydi va faqat natijani qaytaradi. Asosiy oynangiz esa bo‘sh qoladi. Anthropic shunday yozadi:

Ixtisoslashgan subagentlar alohida, toza kontekst oynalarida aniq vazifalarni hal qila oladi. [...] Har bir subagent o‘n minglab yoki undan ko‘proq token sarflab, keng qamrovli izlanishi mumkin, ammo ishidan faqat ixcham va saralangan xulosani qaytaradi (ko‘pincha 1,000-2,000 token).
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents

Kontekst muhandisligi — oynaga nimalar kirishini boshqarish. Anthropic buni prompt muhandisligidan bir daraja yuqoridagi, agentlar bilan ishlashning asosiy ko‘nikmasi deb atagan. Prompt muhandisligi — so‘zlarni tanlash. Kontekst muhandisligi esa fayllar, yo‘nalishlar, ko‘nikmalar va subagentlarni tanlashdir.

Ikkinchi miya — kontekst muhandisligining birinchi qurilish bloki. Usiz Skills bo‘sh joyni o‘qiydi, Subagents boradigan joy topolmaydi, agent oynasi esa tartibsiz ma’lumotlar bilan to‘ladi. Ikkinchi miya bo‘lsa, uchala vosita ham ishlay boshlaydi.

Keyingi qadam. Loyiha yonida ikkita papka yarating: business/ va ai-clone/. Har biriga xarita vazifasini bajaruvchi 5 satrli INDEX.md qo‘shing. CLAUDE.md’ga to‘rtta yo‘naltirish satri kiriting. Bir soat ichida ishlaydigan ikkinchi miya asosiga ega bo‘lasiz. Keyin uni “agent har bir xato qilganidan so‘ng ai-clone/feedback/ ichiga bitta satr qo‘sh” qoidasi bilan kengaytiring. Ikkinchi miyaga yo‘naltirish uchun kerak bo‘ladigan to‘liq CLAUDE.md shablonini CLAUDE.md’ni to‘g‘ri sozlash qo‘llanmasida tushuntiraman.

Manbalar

Ailoot’ni ailoot.ai saytida o‘rganishda davom eting.

Batafsil

Ko‘p beriladigan savollar

Biznes kontekstini boshqa Git branch’ga qo‘yish maxfiy saqlaydimi?

Yo‘q. Branch o‘sha repozitoriyga tegishli; fayllari obyekt va tarix bilan ulashilishi mumkin. Alohida boshqariladigan xususiy ombor yoki ongli ravishda ignore qilingan zaxirali mahalliy papka ishlating. Ignore avval kuzatilgan tarixni o‘chirmaydi.

Agent kod reposidan tashqaridagi xususiy kontekstni qanday topadi?

Aniq yo‘naltiruvchi havola va vazifaga kerakli ruxsatnigina bering. Tegishli hujjatga olib boradigan qisqa indeks tuting va agent ruxsatli faylni o‘qishini tekshiring. Yo‘naltirilmagan xususiy joy kontekstni avtomatik bermaydi.

Barcha maqolalar