Блог

Claude Code-тағы екінші ми: құрылымды бір сағатта қалай жасауға болады

Markdown

Claude Code үшін екінші миды қалай құруға болады: жад иерархиясы, бес бөлімнен тұратын қалта құрылымы және агент жобаны сессиялар арасында ұмытпауы үшін git.

Мақаланы толық оқу

Негізгі түйін

Claude Code-тағы екінші ми — бір файл емес, git-пен бірге қолданылатын бес қалтадан тұратын құрылым. CLAUDE.md ережелер мен бағыттарды белгілейді, business/ жоба туралы білімді сақтайды, ai-clone/ шешім қабылдайтын сіз туралы ақпаратты сақтайды, plans/ техникалық жоспарларды, ал retrospectives/ өткен сессиялардан алынған сабақтарды сақтайды. Агент CLAUDE.md файлынан бастап, нақты сұрауға сай қалтаға сілтемелер арқылы өтеді. Бұл мақалада Claude Code-тың ресми құжаттамасындағы жад иерархиясы, бес бөлімнен тұратын құрылым және оны бір сағат ішінде кезең-кезеңімен жасау жолы қарастырылады.

Ailoot анықтамалық құжаттамасы: ailoot.ai/docs/.

Claude Code-қа екінші ми не үшін керек және онда не болуы қажет?

Негізгі түйін

Бір CLAUDE.md файлы негізгі ережелерді қамтиды, бірақ бизнес жадын сақтай алмайды. Бір айдан кейін бағаны неге көтергеніңізді ұмытасыз. Үш айдан кейін бөліп төлеуден неге бас тартқаныңыз есіңізде болмайды. Білім бір мезгілде төрт жерде жатады: өз ойыңызда, Telegram чаттарында, Google құжаттарында және қызметкерлердің жадында. Екінші ми осының бәрін жоба жанындағы бір қалтаға жинайды. Ондағы markdown файлдарын Claude өзі аша алады.

Сейсенбі күні Claude Code-ты ашасыз. Жобаның не екенін, аудиториясын түсіндіресіз, нені істемеу керегін айтасыз. Бірге жұмыс істейсіздер. Бейсенбі күні жаңа чат ашылады, сонда бәрін қайта түсіндіруіңіз керек.

Егер CLAUDE.md файлыңыз бар болса, бухимдлын бірінші кезеңін шешкен боласыз. Негізгі ережелер мен жобаның сипаттамасы бір файлда сақталып, әр сессияда жүктеледі. Бұл файл қалай жұмыс істейтінін мен CLAUDE.md туралы нұсқаулығымда түсіндірдім — негізін қалау үшін алдымен соны оқи аласыз.

Бірақ CLAUDE.md — жаңа қызметкерге арналған нұсқаулық. Қалай киіну керек, клиенттермен қандай үнде сөйлесу керек, жариялау үшін қандай командаларды қолдану керек. Жоба туралы дұрыс шешім қабылдауға бұл жеткіліксіз. Шешім қабылдау үшін білім қажет: өнім не екенін, аудитория кім екенін, экономика қалай жұмыс істейтінін, нені сынап көріп, ненің нәтиже бермегенін білу керек.

Мұнда сипатталған автор тәжірибесінде бұл білім бұрын төрт жерде жататын: өз ойында, Telegram чаттарында, Google құжаттарында және қызметкерлердің жадында. Шешім қабылданғаннан кейін бір ай өткенде оның неге қабылданғанын ешкім есіне түсіре алмады. Жаңа адам істің мән-жайына қанығу үшін командадан бір сағат бойы сұрақ сұрайтын. Claude бұл контекстің ешбір бөлігіне қол жеткізе алмайтын.

Автор сипаттаған тәжірибеде екінші ми болмаған кезде әр сессияда клиенттің кім екенін, ұсыныстың қалай құрылғанын және төлемді қай провайдер өңдейтінін қайта-қайта түсіндіруге тура келетін. business/ қалтасы бар кезде мен чат ашып: «жаңа баға жоспарына сай ұсынысты жаңарт» деймін. Claude өздігінен business/company/legal.md файлына өтіп, талаптарды оқиды, содан соң business/products/pricing.md файлын ашып, жаңа баға жоспарын көреді де, бір әрекетте түзету ұсынады. Алдын ала түсіндірудің қажеті жоқ; контекст автоматты түрде жүктеледі.

Ескертпе

Бұл Claude жадының мәселесі емес. Бұл — архитектура мәселесі. Агенттің контекст терезесі — оның жұмыс жады. Ол тек өзіңіз көрсеткен нәрселерді жүктейді. Қалғанының бәрі терезеден тыс қалады және қажет кезде жүктеледі. Екінші ми сол «қалғанның бәрін» Claude өз жолын таба алатындай құрылыммен сақтайды.

Anthropic инженерлік блогында бұл мәселені context rot деп атайды:

Контекст терезесіндегі токендер неғұрлым көп болса, модель сол контекстегі ақпаратты дәл еске түсіруде соғұрлым нашар жұмыс істейді.
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents

Басқаша айтқанда, терезеге неғұрлым көп ақпарат тықпаласаңыз, агент нақты деректермен соғұрлым нашар жұмыс істейді. Шешімі — Claude нақты сұрауға жауап бергенде өзі аша алатын сыртқы файлдар құрылымын сақтау. Екінші ми дегеніміз — осы.

Екінші ми деген не және оны Claude-қа қалай қолдануға болады?

Негізгі түйін

Идеясы қарапайым: ақыл ойлауға арналған, сақтауға емес. Claude Code үшін екінші ми өнімділік әдісінен агент архитектурасына айналады: агент файлдық жүйе арқылы тікелей кіре алатын сыртқы жазбалар қалтасы.

Екінші ми әдетте жалпы өнімділікке қатысты: адамдар Obsidian қоймасын жасап, оған кітаптардан үзінділерді, қоңыраулардан жазбаларды және жоба идеяларын қосады.

Автор бұл идеяны Claude Code-пен жұмысқа қолданғанда, ол өнімділік туралы болудан қалып, агент архитектурасына айналды.

Классикалық тәсілде екінші ми сіздікі, оған қолмен кіресіз. Claude Code-пен жұмыс істегенде, екінші ми екі бағытты болады: оған сіз де, агент те кіре алады. Бұл оның пішіміне қойылатын талаптарды өзгертеді.

Агент оған өздігінен кіретіндіктен, файлдар қосымша интеграциясыз түсіне алатын пішімде болуы керек. Markdown өте қолайлы: мәтін, тақырып иерархиясы және файлдар арасындағы сілтемелер. Notion мен Google Docs жарамайды. Оларды MCP арқылы қосуға болады, бірақ бұл тағы бір қабат, әр сұрауға тағы бір токен және тағы бір істен шығу нүктесі деген сөз.

Файлдар жоба жанындағы файлдық жүйеде болғандықтан, олар Claude Code қол жеткізе алатын ортаға автоматты түрде кіреді. Ештеңе баптаудың қажеті жоқ. Агентті жоба қалтасында іске қосыңыз — ол ішіндегі барлық файлды көре алады. Бұл тегін және бірден жұмыс істейді.

Кеңес

Екінші миды Obsidian ішінде сақтауға болады — байланыстар графигін көру оңай болсын деп мен де оны сонда ашамын. Бірақ файлдардың өзі кодпен бірге кәдімгі қалтада жатады. Obsidian — markdown файлдарының ыңғайлы қабығы ғана. Claude оларды Obsidian-сыз да көре алады. Кез келген редакторды қолдана аласыз; бастысы — файлдардың өз пішімі бар бұлттық қызметте емес, дискіде болуы.

Claude Code әдепкіде қандай жад иерархиясымен келеді?

Негізгі түйін

Claude Code әдепкіде CLAUDE.md файлының төрт деңгейін (enterprise, user, project және local) оқи алады, ал 2.1.59 нұсқасынан бастап ~/.claude/projects/<project>/memory/ ішінде өзінің авто жадын сақтайды. Бұл негізгі жадқа жеткілікті, бірақ бизнес контексті үшін жеткіліксіз — оны жоба жанындағы бөлек қалтада сақтаңыз.

Өзіңіз бірдеңе қоспас бұрын, Claude сіздің көмегіңізсіз нені есте сақтай алатынын қарастырайық. Anthropic өзінің ресми құжаттамасында екі тетікті сипаттайды: CLAUDE.md (сіз жазатын ережелер) және авто жад (Claude өзі жазатын сабақтар). Екеуі де әр сессия басталғанда жүктеледі.

CLAUDE.md бір мезгілде төрт жерден ізделеді:

ДеңгейОрналасуыМақсаты
Enterprise/Library/Application Support/ClaudeCode/CLAUDE.md (macOS), /etc/claude-code/CLAUDE.md (Linux), C:\Program Files\ClaudeCode\CLAUDE.md (Windows)Әкімші MDM арқылы бүкіл командаға енгізетін ережелер. Жеке пайдаланушыларға бұл қажет емес.
User~/.claude/CLAUDE.mdБарлық жобаға ортақ жеке ережелер. «Мен қалаған тілде жауап бер», «ұзын тире қолданба».
ProjectЖоба түбіріндегі ./CLAUDE.mdБелгілі бір жобаға арналған ережелер: стек, қалта құрылымы, бизнес ережелері. Git-ке жіберіледі.
Local./CLAUDE.local.mdОсы жобаға арналған, git-ке жіберілмейтін жеке жазбаларыңыз. .gitignore ішінде.

Төрт файлдың бәрі контекстке жүктеледі. Деңгей неғұрлым нақты болса, басымдығы соғұрлым жоғары. Local файлы соңынан оқылады, сондықтан оның ережелері басқаларының бәрін басып озады.

CLAUDE.md файлы жобаның ішіндегі кез келген қалтада да болуы мүмкін. Claude ішкі қалтадан файл оқығанда, сол қалтадағы CLAUDE.md файлын қажет кезінде жүктейді. Бұл монорепода пайдалы: фронтенд ережелері frontend/CLAUDE.md ішінде, бэкенд ережелері backend/CLAUDE.md ішінде болады да, агент тиісті бөлікпен жұмыс істегенде ғана жүктеледі.

Авто жад Claude Code 2.1.59 нұсқасында пайда болды. Бұл — Claude сіз туралы жазатын файлдар:

~/.claude/projects/<project-name>/memory/
├── MEMORY.md          # Индекс, әр сессияда жүктеледі (200 жол немесе 25KB)
├── debugging.md       # Толық жазбалар (қажет кезде жүктеледі)
├── api-conventions.md
└── ...

Anthropic мұны ресми құжаттамасында былай сипаттайды:

Claude әр сессияда бірдеңені сақтай бермейді. Ол ақпарат болашақ әңгімеде пайдалы болуы мүмкін бе дегенге қарап, нені есте сақтау керегін өзі шешеді.
— Anthropic, code.claude.com/docs/en/memory

Авто жад ~/.claude/settings.json ішіндегі autoMemoryEnabled жалаушасы арқылы қосылады. Оған не жазатынын Claude шешеді. MEMORY.md файлын ашып, қолмен өңдеуге болады — бұл кәдімгі markdown.

Ескерту

Авто жад пайдалы, бірақ екінші миды алмастыра алмайды. Claude оған құралдар мен код үлгілері туралы тактикалық қорытындыларды жазады. «Бұл скрипт X жалаушасынсыз бұзылады», «бұл дерекқор кестесі осылай аталады». Ал бизнес стратегиясын жазбайды. Агент аудиторияңыздың кім екенін және белгілі бір бағаны неге таңдағаныңызды есте сақтасын десеңіз, оны өзіңіз бөлек контекст қалтасына жазуыңыз керек.

CLAUDE.md пен екінші мидың шекарасын қай жерден белгілеу керек?

Негізгі түйін

CLAUDE.md — жаңа қызметкерге арналған нұсқаулық: өзін қалай ұстау керек, қандай командаларды қолдану керек және нені істемеу керек. Екінші ми — компанияның викиі: немен айналысатыныңыз, кімге арналғаны, экономика қалай жұмыс істейтіні және нені сынап көргеніңіз. Мінез-құлық ережелері жазылған бір файл және сыртқы білім құрылымы. CLAUDE.md — индекс, ал екінші ми — мұрағат. Индекс болмаса, агент мұрағат бар екенін білмейді. Мұрағат болмаса, ол тек ережелерді біледі, бірақ бизнес контекстін білмейді.

Сөздерімде қолданатын ұқсастық мынадай: жаңа қызметкерді жалдадыңыз делік. Бірінші күні оған не бересіз?

Нұсқаулық: қалай киіну керек, қашан келу керек, клиенттермен қандай үнде сөйлесу керек, қандай жүйе арқылы жариялау керек. Бұл қысқа құжат. Онда немен айналысатыныңыз және неліктен екені түсіндірілмейді. Тек өзін қалай ұстау керегі айтылады.

Ал компанияның викиіне бөлек қол жеткізу беріледі. Онда өнімнің не екені, кімге арналғаны, аудиториясы кім екені, бағасы қанша және неге дәл сондай екені, бәсекелестері кім екені және қандай қателіктер жіберілгені түсіндіріледі. Бұл — ауқымды мұрағат. Оны ешкім басынан аяғына дейін оқымайды; нақты сұрақ туғанда соған жүгінесіз.

CLAUDE.md = нұсқаулық. Екінші ми = вики. Екеуі де керек.

Айырмашылығы қарапайым. Әр тапсырмаға қатысты нәрсенің бәрін CLAUDE.md ішіне жазыңыз:

  • Агенттің осы жобадағы рөлі (көмекші, жетекші, ассистент)
  • Қай тілде жауап беру керек
  • Құралдар стегі
  • Жариялау командалары
  • Тыйымдар (ұзын тире қолданбау, git push --force орындамау)
  • Бағыттар: бизнес контексті үшін қайда, қағидаттар үшін қайда бару керек

Қажет кезде ғана керек нәрсенің бәрін екінші миға салыңыз:

  • Өнім, аудитория, экономика және мақсаттар
  • Бәсекелестер мен нарық
  • Бұрын қабылданған шешімдер және олардың себептері
  • Клиент мысалдары мен пікірлері
  • Қағидаттар мен әдістеме

Anthropic құжаттамасында да дәл осындай айырмашылық жасайды:

CLAUDE.md әр сессияда жүктеледі, сондықтан оған тек кеңінен қолданылатын ақпаратты қосыңыз. Кейде ғана қажет болатын салалық білім немесе жұмыс ағындары үшін skills пайдаланыңыз. Claude оларды әр әңгімені үлкейтпей, қажет кезде жүктейді.
— Anthropic, code.claude.com/docs/en/best-practices

Skills — эпизодтық білімді сақтаудың бір жолы. Жоба жанындағы business/ қалтасы — тағы бір жол. Мен екеуін де қолданамын, төменде толығырақ түсіндіремін.

Жоба миы неден тұрады: 5 бөлік және уақыт машинасы

Негізгі түйін

Жоба миы — үстінен git қосылған бес қалта. CLAUDE.md ережелер мен бағыттарды белгілейді. ai-clone/ цифрлық бейнеңізді: қағидаттарыңызды, үніңізді және қателерден кейінгі кері байланысты сақтайды. business/ жоба туралы білімді сақтайды. plans/ әр кезеңдегі техникалық жоспарларды ұстайды. retrospectives/ сессиядан кейінгі ой-толғамдарды сақтайды. Git мұның бәрін уақыт машинасына айналдырады: бір жылдан кейін кез келген файлды ашып, шешім қабылданған кезде оның ішінде не болғанын көре аласыз.

Автор сипаттаған тәжірибедегі архитектура мысалы:

ҚалтаІшіндегісіМақсаты
CLAUDE.mdЖоба ережелері, стек, файл құрылымы, қалталарға бағыттау, байланыс тіліБұл — агенттің нұсқаулығы. Әр сессияда жүктеледі. 200 жолдан аз, дұрысы — 80-120.
ai-clone/Мен кіммін, қағидаттарым, үнім, шешім қабылдау мәнерім, қателерден кейінгі кері байланысШешім қабылдайтын менің цифрлық бейнем. Ол нені бірден қабылдамайтынымды, қалай ұсыныс жасайтынымды және қателерден қандай ережелер үйренгенімді біледі.
business/Өнім, аудитория, мақсаттар, экономика, маркетинг, бұрынғы шешімдер, мысалдарWiki сілтемелері бар байланысқан markdown файлдары. Әр файл басқаларына [[...]] сілтемелері арқылы жалғанады. Агент нақты сұраққа жауап іздеп сол жерге барады.
plans/Әр мүмкіндікке арналған бір жоспар. Кезеңдері мен құсбелгілері бар YYYY-MM-DD-feature.md файлдарыPlan Mode бір әңгіме ішінде ғана болады; /clear командасынан кейін жоғалады. plans/ қалтасы репозиторийде сақталады, сондықтан кез келген агент жоспарды кез келген уақытта жалғастыра алады.
retrospectives/Әр сессиядан кейінгі ой-толғамдар: не істелді, нені есте сақтау керек, нені жақсартуға боладыЖүйенің өзін-өзі үйренуі. Қателер ai-clone/feedback/ қалтасындағы ережелерге айналады.
+ gitБарлық файлдың нұсқалар тарихыУақыт машинасы. Кез келген файлды ашып, git log орындасаңыз, оның қашан және неге өзгергенін көресіз.

Әдістемедегі негізгі тұс — ai-clone/ мен business/ қалталарын бөлек ұстау.

business/ қалтасы «немен айналысамыз?» деген сұраққа жауап береді. Өнім, аудитория, бағалар, бәсекелестер. Бұл — жоба туралы. Ертең жобаны серіктеске берсеңіз, бұл қалта да онымен бірге кетеді.

ai-clone/ қалтасы «шешімді қалай қабылдаймын?» деген сұраққа жауап береді. Қағидаттарым, үнім, кәсіби шеберлігім және қолданбайтын сөздерім. Бұл — мен туралы. Ертең жаңа жоба бастасам, бұл қалта да менімен бірге барады.

business/ қалтасына нені салу керек, ал нені салмау керек?

Негізгі түйін

business/ қалтасына аптасына бір реттен сирек өзгеретін жоба деректерін салыңыз: позициялау, аудитория, өнімдер мен бағалар, тоқсандық мақсаттар және маңызды шешімдер. Чат хат-хабарын, өңделмеген бастапқы материалдарды, кодта қайталанатын ақпаратты, скриншоттарды және динамикалық сандарды қоспаңыз. Сандардың орнына LIVE белгісін және SQL сұрауына сілтемені пайдаланыңыз — оны төмендегі бөлек бөлімде түсіндіремін.

Автор сипаттаған жобадағы business/ қалтасының жоғарғы деңгейдегі құрылымы:

business/
├── INDEX.md              ← қалталар картасы, алдымен осыны оқыңыз
├── company/              ← миссия, заңды тұлға, құндылықтар, құқықтық саясаттар
├── products/             ← өнімдер, хөтөлбөрүүд, бағалар
├── audience/             ← клиенттің профилі, сегменттер, қарсылықтар
├── goals/                ← жылдық, тоқсандық, айлық мақсаттар, метрикалар
├── economics/            ← бірлік экономикасы, кіріс, шығыс, болжам
├── marketing/             ← арналар, воронка, материалдар, бәсекелестер
├── execution/            ← апталық жоспарлау, backlog
└── assets/               ← дизайн жүйесі, пікірлер, мәтіндер қоры

Бұл — автор сипаттаған жобадан алынған мысал, қатаң ереже емес. Қалталарды қажеттілікке қарай жасаймын. Алғашында үш қалтадан бастадым (products/, audience/, goals/); 2-3 айдан кейін жаңа нәрселерді қайда салу керегі түсініксіз болғанда, қалғандарын қостым.

Қалтаның басты файлы — INDEX.md. Бұл карта. Онда Claude қайда бару керегін түсіну үшін қолданатын «сұрақ → файл» кестесі бар. Онсыз агент әр файлды ретімен оқып, токен жұмсайды.

INDEX.md файлының мысал үзіндісі:

### Қажетті ақпаратты қайдан табуға болады

| Не керек | Қайдан қарау керек |
|---|---|
| Клиентіміз кім және оның қиындықтары қандай | `business/audience/avatar.md` |
| Өнімдер, жоспарлар және бағалар | `business/products/` |
| Мақсаттар мен метрикалар | `business/goals/` |
| Экономика (кіріс, шығыс, бірлік экономикасы) | `business/economics/` |
| Жарнама арналары мен материалдар | `business/marketing/` |

CLAUDE.md ішіндегі бір жол жеткілікті: «Бизнес туралы сұрақтар үшін business/INDEX.md файлын оқып, картадағы сілтемелерді қолданыңыз». Агент бүкіл қалтаны контекстке жүктемейді. Алдымен картаны оқиды, тиісті файлды таңдайды да, тек соны ашады.

business/ қалтасына салмау керек нәрселердің тізімі:

  • Өңделмеген чат хат-хабары. Егер маңызды ой болса, оны қорытып, жазып қойыңыз. Болмаса, қоспаңыз.
  • Кодта қайталанатын ақпарат. «Төлемдер CloudPayments арқылы өтеді» деп жазудың қажеті жоқ: агент оны кодтан көре алады.
  • Скриншоттар мен суреттер. Олар қалтаның көлемін арттырады, әрі қосымша қадамсыз мәтіндік модель оларды талдай алмайды.
  • Динамикалық сандар. «Бүгін өнім үшін 423 төлем түсті» деген дерек бір аптада ескіреді. LIVE белгісін және дерекқор сұрауына сілтемені пайдаланыңыз.
  • Құпия немесе күмәнді ақпарат. Ертең репозиторий YouTube-та жүз мың бейтаныс адамның алдында жария болса, көрсетуге дайын емес нәрсені сақтамаңыз. Қалтаны қызметкерлер, агенттер және кейде сыртқы мердігерлер оқиды.

Ескерту

Егер репозиторий ашық болса, business/ қалтасы да ашық. Қазір жеке болса да, екінші миымды ертең репозиторий ашық болып кетуі мүмкін дегендей қарастырамын. Клиенттердің рұқсатынсыз аттарын, айлық кіріс сандарын немесе құпиясөздерді қоспаймын. Бұл әдет көп уайымнан сақтайды.

Неліктен ai-clone қалтасы бөлек болуы керек және оны неге business-пен араластырмау керек?

Негізгі түйін

ai-clone/ қалтасы цифрлық бейнеңізді сақтайды: қағидаттарды, үнді, қолданбайтын сөздерді және қателерден кейінгі кері байланысты. Агенттің әр қатесі «ереже → себебі → қалай қолдану керек» формуласы бойынша ai-clone/feedback/ ішіндегі ережеге айналады. Бұл қалта жобадан жобаға сізбен бірге көшеді. business/ жобамен бірге қалады. Екеуін бөлек ұстаңыз: жаңа жобада business/ жаңа болады, ал қағидаттарыңыз бен стиліңіз өзгермейді.

Идеясы қарапайым: бизнес немен айналысатынымызды біледі. Клон менің қалай шешім қабылдайтынымды біледі.

Автор сипаттаған жобадағы ai-clone/ қалтасының құрылымы:

ai-clone/
├── INDEX.md           ← қалталар картасы
├── role.md            ← мен кіммін, тәжірибем, мен үшін маңызды нәрселер
├── identity/          ← құндылықтар, көзқарас, миссия
├── thinking/          ← баяндамалардан алынған ойлау модельдері
├── voice/             ← үн, сөздік қор, стиль
├── principles/        ← өнім, код, бизнес туралы сенімдер
├── feedback/          ← қателерден үйренген ережелер ← басты қалта
├── style/             ← қолданбайтын сөздер, Telegram пішімі
└── reference/         ← құралдар, орта

Ең пайдалы қалта — feedback/. Онда агент қателерінен үйренген нақты ережелерім сақталады. Әр ереже мына пішім бойынша жеке файлда тұрады:

---
name: short-name
description: бір жол - файлда не бар және оны қашан қолдану керек
type: feedback
---

Бір сөйлемнен тұратын қысқа ереже.

**Неге:** бұл ереже не үшін бар. Контекст, оқиға, байқау.

**Қалай қолдану керек:** ереже қолданылатын нақты жағдайлар.

«Неге» деген бөлік болмаса, ереже жансыз болады — агент оны ұқсас жағдайға қолдана алмайды. «Қалай қолдану керек» болмаса, ережені қашан пайдалану керегі түсініксіз.

Қалтамдағы мысал — «ұзын тире емес, дефис». Ұзын тире — жасанды мәтіннің негізгі көрнекі белгісі болғандықтан, бұл ереже пайда болды. Ол көпшілікке арналған кез келген мәтінге қатысты. Файл мына жерде: ai-clone/feedback/no-em-dashes.md.

Мен мұны сәл басқаша істеймін: ережелерді CLAUDE.md ішіне емес, ai-clone/feedback/ ішіне жазамын. CLAUDE.md — жоба файлы, ал үн мен стиль ережелері жеке сипатқа ие. Олар менімен бірге келесі жобаға көшеді. CLAUDE.md жобамен бірге қалады.

Ескертпе

Бұл тәсілдің қаншалықты жетілгенін аптасына агентке бір нәрсе туралы неше рет «жоқ, олай емес» дейтініңізден байқауға болады. Жетілген жүйеде жауап — нөл. Әр қате feedback/ ішіндегі ережеге айналады да, агент оны келесі жолы қайталамайды.

Live Metrics деген не және файлдарға сандарды неге тікелей жазбау керек?

Негізгі түйін

Екінші ми файлдарындағы сандар бірнеше күн ішінде ескіреді. Бүгінгі «1,000 клиент» ертең 1,050, бір айдан кейін 2,000 болады. Санны файлға тікелей жазсаңыз, бір айдан кейін агент кешегі дерекке сүйеніп ұсыныс жасайды. Шешімі — файлдағы LIVE белгісі және SQL сұраулары дайын live-metrics.md құжаты. Агент LIVE белгісін көргенде, дерекқорға өтіп, қазіргі санды алады да, жаңартылған дерекке сүйенеді.

Екінші миды бастағандағы негізгі қателіктің бірі — оған ескірген сандарды толтыру. «Бізде 320 клиент бар» деп жазасыз, екі аптадан кейін 410 болып шығады. «Айлық кіріс 4.7 миллион» деп жазасыз, бір айдан кейін контекст жоғалады: бұл мақсат па, нақты нәтиже ме, әлде болжам ба?

Автор мысалында бұл былай жұмыс істейді. business/products/practicum.md файлында санның орнына белгі тұрады:

## Топтар

> **LIVE** - топтар бойынша ағымдағы төлемдерді көру үшін `live-metrics.md` файлының
> «Сату» бөліміндегі сұрауларды орындаңыз.

| Топ | Күндер | Төлем жасағандар |
|-------|------|------------|
| 1 | 2026 жылғы 10-12 наурыз | LIVE |
| 2 | 2026 жылғы 24-26 наурыз | LIVE |

Бөлек live-metrics.md файлында орындауға дайын SQL сұраулары және олардың қай дерек қайтаратынының сипаттамасы болады:

## Сату (топтар бойынша төлемдер)

```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;
```

Агенттен «екінші топта қанша төлем бар?» деп сұрасам, ол:

  1. business/products/practicum.md файлын оқиды
  2. Санның жанындағы LIVE белгісін көреді
  3. live-metrics.md файлын ашады
  4. «Сату» бөлімін табады
  5. Сұрауды өндірістік дерекқорға жібереді
  6. Жаңа деректерді қолданып жауап береді

Бұл екі мәселені бірдей шешеді. Сандар ескірмейді. Шешімдер былтырғы емес, қазіргі жағдайға сүйеніп қабылданады.

Ескерту

Автор сипаттаған тәсілде өндірістік дерекқорға тек сенімді агенттер кіре алады. Олар оған сұрауларды тіркейтін және құпиясөздерді ашпайтын wrapper арқылы ғана қол жеткізеді. live-metrics.md ішіне ашық мәтіндегі құпиясөзі бар тікелей psql командасын жазу — жаман идея. Құпиясөзді орта айнымалысынан алатын және шығыста көрсетпейтін wrapper жасаңыз. Бұл — жеке техникалық қабат, бірақ онсыз LIVE қауіпсіздік саңылауына айналады.

Агент бір сұрауға жауап беру үшін екінші миды қалай шарлайды?

Негізгі түйін

Сұрау жолы үнемі бірдей: Claude CLAUDE.md файлын оқиды, карталарды (business/INDEX.md, ai-clone/INDEX.md) көреді, тиісті INDEX файлына өтеді, сол жерден нақты файлды ашады және қажет болса LIVE арқылы санды алады. Бұл бүкіл қалтаны контекстке тықпалаудың орнына 5-6 оқу әрекеті. Контекст терезесі ой қорытуға бос қалады, ал қатысы жоқ файлдарға токен жұмсалмайды.

Мысалы, нақты сұрау: «жаңа топ қатысушыларына электрондық хаттың жобасын жаз».

  1. Claude бос терезеден бастайды. Ол CLAUDE.md файлын жүктейді (ережелер, стек, бағыттар).
  2. CLAUDE.md ішіндегі бағыттардан «ai-clone/INDEX.md — әр сессияның басында міндетті түрде оқу» дегенді көреді. Файлды ашып, менің кім екенімді, үнім қандай екенін және қандай сөздерді қолданбайтынымды біледі.
  3. Бағыттардан «электрондық хат үлгілері — src/lib/email/layout.ts» дегенді көреді. Файлды ашып, пішімін түсінеді.
  4. «Өнім контексті — business/products/practicum.md» дегенді көреді. Файлды ашып, өнім туралы оқиды.
  5. Файлдағы LIVE белгісін және live-metrics.md файлына сілтемені көреді. Файлды ашып, орындауға дайын SQL сұрауын табады. Қазіргі сан қажет болса, сұрауды орындайды. Қажет болмаса, «жіберер кезде осы санды алу» деп белгілейді.
  6. ai-clone/style/telegram-format.md ішіндегі үн ережелерін, ai-clone/feedback/no-em-dashes.md ішіндегі ұзын тиреге тыйымды және business/marketing/funnel.md ішіндегі воронка конверсиясын көреді.

Ол хатты менің үніммен, жаңа сандармен, ұзын тиресіз және AI белгілерінсіз жазады.

Anthropic инженерлік блогында бұл тәсілді just-in-time context деп атайды:

«Дәл қажет кезде» тәсілімен жасалған агенттер жеңіл идентификаторларды (файл жолдарын, сақталған сұрауларды, сілтемелерді және т.б.) сақтайды да, жұмыс кезінде құралдардың көмегімен осы сілтемелер арқылы деректерді контекстке динамикалық түрде жүктейді.
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents

Басқаша айтқанда, Claude деректердің өзін емес, оларға сілтемелерді сақтайды. Бұл токендерді әлдеқайда үнемді жұмсайды әрі әлдеқайда дәл, өйткені контекстке тек қатысты ақпарат кіреді. Контекст терезесі ой қорытуға бос қалады.

Екінші миды қолданғанда қандай 5 қателіктен аулақ болу керек?

Негізгі түйін

Екінші миды жаңадан бастағандар жіберетін негізгі қателер: 1) қысқа бағыттаушының орнына 500+ жолдық шамадан тыс үлкен CLAUDE.md жасау; 2) бәрін сала беретін қалтаны ретсіз үйіндіге айналдыру; 3) Claude тілден немесе кодтан біліп тұрған нәрсені қайталау; 4) LIVE белгісінсіз ескіретін сандарды тікелей жазу; 5) контекст сол репозиторийде не бөлек жеке қоймада болсын, оны агентке қолжетімсіз қалдыру немесе оған бағыттамау.

Қателік 1. Шамадан тыс үлкен CLAUDE.md. «Бәрін бір жерге салудың» орнына 500 жол нұсқаулық жазу. Anthropic мұны ашық айтады:

Қысқа ұстаңыз. Әр жол бойынша: «Мұны алып тастасам, Claude қате жібере бастай ма?» деп сұраңыз. Жоқ болса, өшіріңіз. Көлемі шамадан тыс үлкен CLAUDE.md файлдары Claude-қа нақты нұсқауларыңызды елемеуге мәжбүр етеді!
— Anthropic, code.claude.com/docs/en/best-practices

Мақсатты ұзындығы — 80-120 жол. Қалғанының бәрін бөлек файлдарға салып, оларға бағыттаңыз.

Қателік 2. Бәрін сала беретін қалта. Екінші миға өңделмеген чат хат-хабарын, қажетсіз скриншоттарды, ешкім оқымайтын есептерді сала бересіз. Бір айдан кейін қалта үлкейіп кетеді, агент қоқысты оқуға токен жұмсайды, ал сіз ештеңенің қайда тұрғанын білмей қаласыз. Ереже: екінші мидағы әр файл нақты бір сұраққа жауап беруі керек. Оны алты ай бойы ешкім ашпаса, өшіріңіз немесе мұрағатқа көшіріңіз.

Қателік 3. Қайталау. «Төлемдер CloudPayments арқылы өтеді, src/lib/payment/cloudpayments.ts ішінде; провайдер .env файлына бапталған». Агент мұның бәрін кодтан көре алады. Мұны business/ ішінде қайталап жазудың қажеті жоқ. Көшірме ақпарат ескіреді: код өзгереді, business/ жаңартылмайды да, агент ескірген ақпаратқа сүйенеді.

Қателік 4. Сандарды тікелей жазу. «Бізде 1,247 клиент бар, конверсия 6.3%» — мұны әлдебір ойдан алынған финтех стартапының сандары деп елестетейік. Мұндай сандардың бәрі бір аптада ескіреді. LIVE белгісі мен live-metrics.md пайдаланыңыз. Бұл туралы жоғарыда айтылды.

Қателік 5. Қолжетімді жолы жоқ контекст. Екінші ми басқа жерде тұрып, агентте оған рұқсат та, сілтеме де болмаса, код қалтасынан бастау жеткіліксіз. Құпия емес ортақ жазбалар үшін business/ пен ai-clone/ қалталарын репозиторий ішінде ұстау ыңғайлы. Жеке контексті бөлек басқарылатын жерде сақтап, рұқсат етілген қолжетімділік пен бағыттауды анық баптаңыз. Қалта ыңғайлылығы құпиялылықтан жоғары тұрмайды.

Кеңес

Бөлек тармақ (context не business-context) жұмысты реттейді, бірақ қолжетімділік шекарасы емес: файлдары сол репозиторийдегі Git объектілері болып қалады және тармақтармен не тарихпен бірге жариялануы мүмкін. Жеке бизнес контекстіне қолжетімділігі анық шектелген бөлек жабық репозиторий не сыртқы қойма және агентке рұқсат етілген бағыттау қолданыңыз. Submodule бөлек жеке репозиторийге сілтей алады, бірақ құпиялылық submodule-дан емес, сол репозиторий рұқсаттарынан келеді. Тағы бір нұсқа — өз сақтық көшірмесі бар әдейі еленбейтін жергілікті қалта; жолды елемеу бұрын бақыланған файлдарды не жарияланған тарихты өшірмейді. Кодпен бірге тек бөлісуге болатын контексті ұстаңыз.

Екінші миды бір сағатта қалай құруға болады: қадамдық нұсқаулық

Негізгі түйін

Бір сағат ішінде қарапайым екінші ми құруға болады: түбірде business/ және ai-clone/ қалталарын жасаңыз, әрқайсысында карта ретінде INDEX.md файлын ашыңыз, business/products/ ішінде қысқа өнім сипаттамасын, audience/ ішінде клиент сипаттамасын және ai-clone/role.md ішінде өзіңіз туралы сипаттаманы қосыңыз. CLAUDE.md файлына осы қалталарға бағыттауды енгізіңіз. Сосын жұмыс барысында дамытыңыз: агент қателескен сайын ai-clone/feedback/ ішіне ереже қосыңыз, шешім қабылдаған сайын business/ ішіне жазба енгізіңіз.

  1. Түбір деңгейінде екі қалта жасаңыз

    Жобаның түбірінде, src/ жанында:

    mkdir -p business/{products,audience,goals,economics,marketing}
    mkdir -p ai-clone/{identity,voice,principles,feedback,style}
    
  2. Қалталар картасы ретінде INDEX.md жасаңыз

    business/INDEX.md — «сұрақ → файл» кестесі. Алдымен кемінде 5 жол қосыңыз да, қажетіне қарай көбейтіңіз. ai-clone/INDEX.md файлына да солай жасаңыз.

  3. Өнім мен клиенттің қысқа сипаттамасын қосыңыз

    business/products/main.md — өнімнің не екенін, кімге арналғанын, қанша тұратынын және оның қандай ерекшелігі барын жазыңыз. 30-50 жол. business/audience/avatar.md — клиенттің кім екенін, қандай мәселесі барын және нені сатып алатынын жазыңыз. 30-50 жол. Мінсіз клиентті сипаттамаңыз — нақты клиентті сипаттаңыз. Бір нәрсені білмесеңіз, «нақтылау керек» деп белгілеп, әрі қарай жалғастырыңыз.

  4. ai-clone/role.md ішінде өзіңізді сипаттаңыз

    Кімсіз, немен айналысасыз және сіз үшін не маңызды. 20-30 жол. Бастау үшін осы жеткілікті. Агенттің өзіңізге ұқсамайтын стильде жазғанын байқасаңыз, үн, қағидаттар мен қолданбайтын сөздерді қосыңыз.

  5. CLAUDE.md файлына бағыттау қосыңыз

    CLAUDE.md файлын ашып, мына бөлімді қосыңыз:

    ## Жоба картасы
    
    - Бизнес контексті → `business/INDEX.md`
    - Мен туралы контекст → `ai-clone/INDEX.md`
    - Техникалық жоспарлар → `plans/YYYY-MM-DD-*.md`
    - Өткен сессиялар туралы ой-толғамдар → `retrospectives/`
    
    Әр сессияның басында міндетті түрде `ai-clone/INDEX.md` және `business/INDEX.md` файлдарын оқыңыз.
    
  6. Claude Code-ты іске қосып, тексеріңіз

    Агентті ашыңыз. Одан «өнімім мен аудиториям туралы айтып бер» деп сұраңыз. Егер қалтадағы контекстке сүйеніп жауап берсе, бәрі жұмыс істеп тұр. Бірдеңені ойдан шығарса, қалталар жобамен қатар орналасқанын, файлдардың дұрыс аталғанын және CLAUDE.md файлындағы бағыттар нақты жазылғанын тексеріңіз.

Одан кейін екінші ми екі қағидат бойынша өседі.

Біріншіден: агент қате жіберген сайын, ереже қосыңыз. 3-4 аптадан кейін ai-clone/feedback/ қалтасында 15-20 ереже файлы болады, сонда агент жиі кездесетін қателердің көбін қайталамайды.

Екіншіден: бизнес шешім қабылдаған сайын, оны business/ қалтасына тіркеңіз. Бағаны көтерсеңіз, күні мен себебін көрсетіп business/products/pricing.md файлына жазба қосыңыз. Позициялауды өзгертсеңіз, business/company/about.md файлына жазыңыз. Алты айдан кейін сізде «неге?» деген сұрақтың жауабын сақтайтын мұрағат болады.

Сұрау мәтіні: кешке екінші миды жаңартуға арналған дайын сұрау

Осы аптада бірге қомақты жұмыс атқардық.

Осы аптадағы барлық код өзгерісін, жасаған барлық коммитімізді талда.
Бұдан алынған қандай құнды ақпарат business/ ішінде сақталуы керек екенін анықтап, контекст жоғалмас үшін көршілес файлдарға wiki сілтемелерін қосып, тиісті файлдарға жаз.

Егер кодта мен түсіндірмеген шешімдер болса, себебін сұрап,
күнін көрсетіп, себебін тиісті файлға жаз.

Кодтан онсыз да анық көрінетін нәрсені қайталама. Келесі сессияда
business/ болмаса, агент біле алмайтын ақпаратты ғана қос.

Одан кейін не істеу керек: Skills, Subagents және context engineering

Негізгі түйін

Екінші ми мен CLAUDE.md — негізі. Оның үстіне Skills (тапсырма сипаттамасына қарай қажет кезде жүктелетін рәсімдік білім), Subagents (ауыр тапсырмаларға арналған, жеке контекст терезелері бар оқшауланған Claude даналары) және context engineering (терезеге не түсетінін басқару) қосылады. Бұл — негіздің үстіндегі үш қабат. Негіз болмаса, агенттің оқитын ештеңесі жоқ.

Екінші ми дайын болған соң, Anthropic контексті оңтайландырудың үш түрлі деңгейі ретінде сипаттайтын тағы үш құрал бар.

Skills — рәсімдік білім. Қайталайтын жұмыс ағыныңыз болса (оқу нұсқаулығын жазу, Telegram жазбасын дайындау, веб-сайтты тексеру), оны тапсырма сипаттамасы бар SKILL.md файлына енгізуге болады. Сессия басында Claude skill атаулары мен сипаттамаларын қарап, ағымдағы тапсырмаға сәйкес келетіндерін ғана жүктейді. Бұл токен үнемдеп, назарды шоғырландыруға көмектеседі.

Subagents — жеке контекст терезелері бар оқшауланған Claude даналары. Ауыр тапсырмаға субагентті іске қосыңыз (30 файлды оқып, қорытынды дайындау), сонда ол жеке терезесінде жұмыс істеп, тек нәтижесін қайтарады. Негізгі терезеңіз бос қалады. Anthropic былай жазады:

Мамандандырылған субагенттер нақты тапсырмаларды таза контекст терезелерінде шеше алады. [...] Әр субагент кең ауқымды зерттеу жүргізіп, ондаған мың немесе одан көп токен жұмсауы мүмкін, бірақ тек жұмысының ықшамдалған, қорытып алынған түйінін қайтарады (көбіне 1,000-2,000 токен).
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents

Context engineering — терезеге жалпы не кіретінін басқару. Anthropic оны 2025 жылы агенттермен жұмыс істеудің prompt engineering-тен бір деңгей жоғары негізгі дағдысы деп атады. Prompt engineering — сөздерді таңдау. Context engineering — файлдарды, бағыттарды, skills пен subagents-ті таңдау.

Екінші ми — context engineering-тің алғашқы құрылыс бөлшегі. Ол болмаса, Skills бос орыннан білім іздейді, Subagents баратын жер таппайды, ал агенттің терезесі кездейсоқ ақпаратқа толады. Екінші ми болса, үш құралдың бәрі де жұмыс істей бастайды.

Келесі қадам. Жобаның жанында екі қалта жасаңыз: business/ және ai-clone/. Әрқайсысына карта қызметін атқаратын 5 жолдық INDEX.md қосыңыз. CLAUDE.md ішіне бағыттайтын төрт жол енгізіңіз. Бір сағаттан кейін екінші мидың жұмыс істейтін негізі дайын болады. Одан кейін «агент әр қателескен сайын ai-clone/feedback/ ішіне бір жол қос» ережесі бойынша дамытыңыз. Екінші миға бағыттау үшін қолданатын толық CLAUDE.md үлгісін CLAUDE.md файлын дұрыс баптау нұсқаулығында түсіндіремін.

Дереккөздер

Ailoot туралы оқуды ailoot.ai сайтында жалғастырыңыз.

Толығырақ

Жиі қойылатын сұрақтар

Бизнес контекстін басқа Git тармағына қою оны жеке сақтай ма?

Жоқ. Тармақ сол репозиторийдің бөлігі, оның файлдары репозиторий объектілерімен және тарихымен бірге берілуі мүмкін. Бөлек басқарылатын жеке қойма не сақтық көшірмесі бар әдейі еленбейтін жергілікті қалта қолданыңыз; жолды елемеу бұрынғы бақыланған тарихты өшірмейді.

Код репозиторийінен тыс жеке контексті агент қалай табады?

Оған анық сілтеме мен тапсырмаға керек ең аз рұқсатты беріңіз. Қажетті құжатқа бағыттайтын қысқа индекс сақтап, агенттің рұқсат етілген файлды оқи алатынын тексеріңіз; бағыттаусыз жеке орын контексті автоматты бермейді.

Барлық мақалалар