Antrosios smegenys Claude Code: kaip per valandą sukurti struktūrą
MarkdownKaip sukurti antrąsias smegenis Claude Code: atminties hierarchija, penkių dalių aplankų struktūra ir git, padedantys agentui tarp sesijų prisiminti viską apie jūsų projektą.
Skaityti visą straipsnį
Svarbiausia
Antrosios smegenys Claude Code nėra vienas failas; tai penkių aplankų struktūra ir git. CLAUDE.md nustato taisykles ir nurodo, kur kreiptis, business/ saugo žinias apie projektą, ai-clone/ – informaciją apie jus kaip sprendimus priimantį asmenį, plans/ – techninius planus, o retrospectives/ – ankstesnių sesijų pamokas. Agentas pradeda nuo CLAUDE.md ir pagal nuorodas pereina į tinkamą aplanką konkrečiai užklausai. Šiame straipsnyje aptariama atminties hierarchija oficialioje Claude Code dokumentacijoje, penkių dalių struktūra ir kaip ją žingsnis po žingsnio sukurti per valandą.
Ailoot informacinė dokumentacija: ailoot.ai/docs/.
Kodėl Claude Code reikia antrųjų smegenų ir kas būtina?
Svarbiausia
Viename CLAUDE.md faile galima aprašyti pagrindines taisykles, bet jis negali saugoti verslo konteksto. Po mėnesio pamiršote, kodėl pakėlėte kainą. Po trijų mėnesių pamiršote, kodėl atsisakėte mokėjimo dalimis. Žinios vienu metu gyvena keturiose vietose: jūsų galvoje, „Telegram“ pokalbiuose, „Google“ dokumentuose ir darbuotojų galvose. Antrosios smegenys surenka visa tai į vieną markdown failų aplanką šalia projekto, o Claude gali pats jame ieškoti.
Antradienį atidarote Claude Code. Paaiškinate: štai projektas, štai auditorija, šito nedaryk. Dirbate kartu. Ketvirtadienį tai jau naujas pokalbis ir vėl turite viską aiškinti iš naujo.
Jei turite CLAUDE.md, išsprendėte pirmąjį nusivylimo etapą. Pagrindinės taisyklės ir projekto aprašas yra viename faile ir įkeliami kiekvienoje sesijoje. Kaip veikia šis failas, paaiškinau savo CLAUDE.md vadove – galite pirmiausia jį perskaityti ir susikurti pagrindą.
Tačiau CLAUDE.md yra instrukcijų vadovas naujam darbuotojui. Kaip rengtis, kokiu tonu bendrauti su klientais, kokias komandas naudoti publikavimui. To nepakanka geriems sprendimams dėl projekto priimti. Sprendimams reikia žinių: kas yra produktas, kas yra auditorija, kaip veikia ekonomika, ką bandėte ir kas nepasiteisino.
Čia aprašyta autoriaus patirtis rodo, kad tos žinios anksčiau gyveno keturiose vietose: jo galvoje, „Telegram“ pokalbiuose, „Google“ dokumentuose ir darbuotojų galvose. Praėjus mėnesiui po sprendimo, niekas nebeprisiminė, kodėl jis buvo priimtas. Naujas žmogus valandą klausinėdavo komandos, kad įsivažiuotų. Claude apskritai nebuvo įtrauktas į šį kontekstą.
Remiantis autoriaus aprašyta patirtimi, iki antrųjų smegenų kiekvienoje sesijoje tekdavo iš naujo aiškinti, kas yra klientas, kaip sudarytas pasiūlymas ir kuris paslaugų teikėjas tvarko mokėjimus. Turėdamas business/, atidarau pokalbį ir sakau: „atnaujink pasiūlymą pagal naują kainodaros planą“ – Claude pats nueina į business/company/legal.md, perskaito reikalavimus, tada pereina į business/products/pricing.md, pamato naują kainodaros planą ir vienu kartu pasiūlo pakeitimą. Nebereikia įžanginio aiškinimo; kontekstas įkeliamas automatiškai.
Pastaba
Tai ne Claude atminties problema. Tai architektūros problema. Agento konteksto langas yra jo darbinė atmintis. Į jį įkeliama tik tai, į ką aiškiai nurodote. Visa kita lieka už lango ribų ir įkeliama pagal poreikį. Antrosios smegenys tą „visa kita“ saugo struktūruotai, kad Claude galėtų susiorientuoti.
Savo inžinerijos tinklaraštyje Anthropic šią problemą vadina konteksto nykimu:
Kuo daugiau žetonų yra konteksto lange, tuo prasčiau modelis tiksliai prisimena informaciją iš to konteksto.
Kitaip tariant, kuo daugiau prikraunate į langą, tuo prasčiau agentas dirba su konkrečiomis detalėmis. Sprendimas – palaikyti išorinių failų struktūrą, į kurią Claude gali pats užeiti gavęs konkrečią užklausą. Tai ir yra antrosios smegenys.
Kas yra antrosios smegenys ir kaip jos pritaikomos Claude?
Svarbiausia
Idėja paprasta: protas skirtas mąstyti, o ne mintims saugoti. Claude Code antrosios smegenys iš produktyvumo metodo virsta agento architektūra: išoriniu užrašų aplanku, kurį agentas gali tiesiogiai pasiekti per failų sistemą.
Paprastai antrosios smegenys naudojamos bendram produktyvumui: žmonės susikuria „Obsidian“ saugyklą ir į ją deda ištraukas iš knygų, pokalbių užrašus ir projektų idėjas.
Kai autorius pritaikė šią idėją darbui su Claude Code, ji nustojo būti apie produktyvumą ir tapo agento architektūra.
Taikant klasikinį požiūrį, antrosios smegenys priklauso jums, o prie jų jungiatės rankiniu būdu. Dirbant su Claude Code antrosios smegenys tampa dvikryptės: jomis naudojatės ir jūs, ir agentas. Tai keičia jų formato reikalavimus.
Kadangi agentas prie jų jungiasi pats, failai turi būti tokio formato, kurį jis supranta be atskiros integracijos. Markdown tam idealus: tekstas, antraščių hierarchija ir nuorodos tarp failų. „Notion“ ir „Google Docs“ netinka. Juos galima prijungti per MCP, bet tai prideda dar vieną sluoksnį, dar vieną žetoną kiekvienai užklausai ir dar vieną galimą gedimo vietą.
Kadangi failai yra failų sistemoje šalia projekto, Claude Code juos pasiekia automatiškai. Nieko konfigūruoti nereikia. Paleiskite agentą projekto aplanke ir jis matys visus jame esančius failus. Tai nemokama ir veikia iš karto.
Patarimas
Antrosios smegenys gali būti „Obsidian“ – aš irgi jas ten atidarau, kad būtų lengviau peržiūrėti ryšių grafiką. Tačiau patys failai yra įprastame aplanke šalia kodo. „Obsidian“ tėra patogi sąsaja markdown failams. Claude juos mato ir be „Obsidian“. Galite naudoti bet kurį redaktorių; svarbu, kad failai būtų diske, o ne debesijos paslaugoje su nuosavu formatu.
Kokią atminties hierarchiją Claude Code turi iš karto?
Svarbiausia
Claude Code iš karto gali skaityti keturių lygių CLAUDE.md failus (enterprise, user, project ir local), o nuo 2.1.59 versijos tvarko ir savo automatinę atmintį aplanke ~/.claude/projects/<project>/memory/. To pakanka pagrindinei atminčiai, bet ne verslo kontekstui – jį laikykite atskirame aplanke šalia projekto.
Prieš ką nors pridėdami, pažiūrėkime, ką Claude gali prisiminti be jūsų pagalbos. Oficialioje dokumentacijoje Anthropic aprašo du mechanizmus: CLAUDE.md (jūsų rašomas taisykles) ir automatinę atmintį (Claude paties užrašomas pamokas). Abu įkeliami kiekvienos sesijos pradžioje.
CLAUDE.md ieškoma keturiose vietose iš karto:
| Lygis | Vieta | Paskirtis |
|---|---|---|
| Enterprise | /Library/Application Support/ClaudeCode/CLAUDE.md (macOS), /etc/claude-code/CLAUDE.md (Linux), C:\Program Files\ClaudeCode\CLAUDE.md (Windows) | Taisyklės, kurias administratorius per MDM įdiegia visai komandai. Pavieniams naudotojams to nereikia. |
| User | ~/.claude/CLAUDE.md | Asmeninės taisyklės, taikomos visuose projektuose. „Atsakyk mano pasirinkta kalba“, „nenaudok ilgojo brūkšnio“. |
| Project | ./CLAUDE.md projekto šakniniame aplanke | Konkretaus projekto taisyklės: technologijų rinkinys, aplankų struktūra, verslo taisyklės. Įtraukiamas į git. |
| Local | ./CLAUDE.local.md | Asmeninės pastabos apie šį projektą, kurios neįtraukiamos į git. Įrašas faile .gitignore. |
Visi keturi failai įkeliami į kontekstą. Kuo konkretesnis lygis, tuo aukštesnis jo prioritetas. Vietinis failas perskaitomas paskutinis, todėl jo taisyklės nusveria visas kitas.
CLAUDE.md failas gali būti bet kuriame projekto aplanke. Kai Claude skaito failą poaplankyje, prireikus įkelia ir to poaplankio CLAUDE.md. Tai patogu monorepozitorijoje: frontend taisyklės saugomos frontend/CLAUDE.md, backend – backend/CLAUDE.md, o įkeliamos tik tada, kai agentas dirba su atitinkama dalimi.
Automatinė atmintis atsirado Claude Code 2.1.59 versijoje. Tai failai, kuriuos Claude rašo apie jus:
~/.claude/projects/<project-name>/memory/
├── MEMORY.md # Rodyklė, įkeliama kiekvienoje sesijoje (200 eilučių arba 25KB)
├── debugging.md # Išsamios pastabos (įkeliamos pagal poreikį)
├── api-conventions.md
└── ...
Oficialioje dokumentacijoje Anthropic tai apibūdina taip:
Claude ne kiekvienoje sesijoje ką nors išsaugo. Jis nusprendžia, ką verta prisiminti, atsižvelgdamas į tai, ar informacija gali būti naudinga būsimame pokalbyje.
Automatinė atmintis įjungiama vėliavėle autoMemoryEnabled faile ~/.claude/settings.json. Claude pats nusprendžia, ką į ją rašyti. Galite perskaityti MEMORY.md ir redaguoti jį rankiniu būdu – tai įprastas markdown failas.
Dėmesio
Automatinė atmintis naudinga, bet ji nepakeičia antrųjų smegenų. Claude joje užrašo praktines įžvalgas apie įrankius ir kodo šablonus. „Šis skriptas neveikia be vėliavėlės X“, „ši duomenų bazės lentelė vadinasi taip“. Verslo strategijos jis ten nerašo. Jei norite, kad agentas prisimintų, kas yra jūsų auditorija ir kodėl pasirinkote konkrečią kainą, turite patys įrašyti tai į atskirą konteksto aplanką.
CLAUDE.md ar antrosios smegenys – kur nubrėžti ribą?
Svarbiausia
CLAUDE.md yra instrukcijų vadovas naujam darbuotojui: kaip elgtis, kokias komandas naudoti ir ko nedaryti. Antrosios smegenys yra įmonės wiki: ką darote, kam tai skirta, kaip veikia ekonomika ir ką jau bandėte. Vienas elgesio taisyklių failas ir išorinių žinių struktūra. CLAUDE.md yra rodyklė, o antrosios smegenys – archyvas. Be rodyklės agentas nežino, kad archyvas egzistuoja. Be archyvo jis žino tik taisykles, o ne verslo kontekstą.
Štai mano pokalbiuose naudojamas palyginimas: įsivaizduokite, kad pasamdėte naują darbuotoją. Ką jam duosite pirmą dieną?
Instrukcijų vadovą: kaip rengtis, kada atvykti, kokiu tonu bendrauti su klientais, per kokią sistemą publikuoti. Tai trumpas dokumentas. Jame nepaaiškinama, ką darote ir kodėl. Jame tiesiog nurodoma, kaip elgtis.
Ir atskirai – prieigą prie įmonės wiki. Joje paaiškinama, kas yra produktas, kam jis skirtas, kas yra auditorija, kokia kaina ir kodėl, kas yra konkurentai ir kokių klaidų esate padarę. Tai išsamus archyvas. Niekas jo neskaito viso – jame ieškote atsakymo į konkretų klausimą.
CLAUDE.md = instrukcijų vadovas. Antrosios smegenys = wiki. Reikia abiejų.
Skirtumas paprastas. Į CLAUDE.md dėkite viską, kas aktualu kiekvienai užduočiai:
- Kas šiame projekte yra agentas (pagalbininkas, vadovas, asistentas)
- Kokia kalba atsakyti
- Technologijų rinkinys
- Publikavimo komandos
- Draudimai (nenaudoti ilgojo brūkšnio, nevykdyti
git push --force) - Nurodymai, kur ieškoti verslo konteksto ir principų
Į antrąsias smegenis dėkite viską, ko prireikia pagal poreikį:
- Produktą, auditoriją, ekonomiką ir tikslus
- Konkurentus ir rinką
- Ankstesnius sprendimus ir jų priežastis
- Klientų pavyzdžius ir atsiliepimus
- Principus ir metodiką
Anthropic dokumentacijoje skiria tą patį:
CLAUDE.md įkeliamas kiekvienoje sesijoje, todėl įtraukite tik tai, kas plačiai taikoma. Srities žinioms ar darbo eigoms, kurių reikia tik kartais, naudokite skills. Claude juos įkelia pagal poreikį ir neapkrauna kiekvieno pokalbio.
Skills yra vienas būdas saugoti epizodines žinias. Kitas – šalia projekto esantis business/ aplankas. Naudoju abu ir apie juos išsamiau paaiškinsiu toliau.
Iš ko sudarytos projekto smegenys – 5 dalys ir laiko mašina
Svarbiausia
Projekto smegenys – tai penki aplankai ir git virš jų. CLAUDE.md nustato taisykles ir nurodo, kur kreiptis. ai-clone/ saugo jūsų skaitmeninę projekciją: principus, toną ir grįžtamąjį ryšį po klaidų. business/ saugo žinias apie projektą. plans/ saugo techninius planus pagal etapus. retrospectives/ saugo apmąstymus po sesijų. Git visa tai paverčia laiko mašina: po metų galite atverti bet kurį failą ir pamatyti, ką jame buvo galima rasti priimant sprendimą.
Architektūros pavyzdys iš autoriaus aprašytos patirties:
| Aplankas | Kas viduje | Paskirtis |
|---|---|---|
CLAUDE.md | Projekto taisyklės, technologijų rinkinys, failų struktūra, aplankų nukreipimas, bendravimo kalba | Tai agento instrukcijų vadovas. Įkeliamas kiekvienoje sesijoje. Mažiau nei 200 eilučių, idealiu atveju 80-120. |
ai-clone/ | Kas esu, mano principai, tonas, sprendimų priėmimo stilius, grįžtamasis ryšys po klaidų | Mano, kaip sprendimus priimančio asmens, skaitmeninė projekcija. Ji žino, ką iškart atmesiu, kokiu stiliumi siūlau dalykus ir kokių taisyklių išmokau iš klaidų. |
business/ | Produktas, auditorija, tikslai, ekonomika, rinkodara, ankstesni sprendimai, pavyzdžiai | Susieti markdown failai su wiki nuorodomis. Failai susiejami nuorodomis [[...]]. Agentas čia ateina ieškoti atsakymo į konkretų klausimą. |
plans/ | Vienas planas kiekvienai funkcijai. Failas YYYY-MM-DD-feature.md su etapais ir žymimaisiais laukeliais | Plan Mode egzistuoja viename pokalbyje ir dingsta po /clear. Aplankas plans/ yra saugykloje – bet kuris agentas gali bet kada perimti planą. |
retrospectives/ | Kiekvienos sesijos apmąstymai: kas padaryta, ką įsiminti, ką būtų galima patobulinti | Sistemos savimokos procesas. Klaidos tampa taisyklėmis aplanke ai-clone/feedback/. |
+ git | Visų failų versijų istorija | Laiko mašina. Atverkite bet kurį failą ir paleiskite git log, kad pamatytumėte, kada ir kodėl jis pasikeitė. |
Svarbiausias metodinis dalykas – atskirti ai-clone/ nuo business/.
business/ atsako į klausimą „ką darome?“ Produktas, auditorija, kainos, konkurentai. Tai susiję su projektu. Jei rytoj perduosite projektą partneriui, šis aplankas keliaus kartu.
ai-clone/ atsako į klausimą „kaip priimu sprendimus?“ Mano principai, tonas, amatas ir draudžiami žodžiai. Tai susiję su manimi. Jei rytoj pradėsiu naują projektą, šis aplankas keliaus su manimi.
Norite ne tik susikurti antrą aplanką, bet ir sistemą, kuri padėtų Claude veikti nuosekliai? Vien to nepakanka. Be ai-clone/ agentas atsako už visus, o ne už jus. Be konteksto inžinerijos jis klaidžioja po visą aplanką ir eikvoja žetonus. Naudinga susieti visus tris dalykus: antrosios smegenys + AI klonas + konteksto inžinerija. Tai trys ramsčiai, be kurių AI haliucinuoja.
Kas turėtų būti aplanke business/, o kas neturėtų?
Svarbiausia
Į business/ dėkite projekto faktus, kurie keičiasi kartą per savaitę ar rečiau: pozicionavimą, auditoriją, produktus ir kainas, ketvirčio tikslus ir svarbiausius sprendimus. Nedėkite susirašinėjimo pokalbiuose, neapdorotos medžiagos, informacijos, kuri dubliuojama kode, ekrano kopijų ar dinamiškų skaičių. Skaičius pakeiskite žyma LIVE ir nuoroda į SQL užklausą – apie tai paaiškinsiu atskirame skirsnyje žemiau.
Aukščiausio lygio business/ struktūra autoriaus aprašytame projekte:
business/
├── INDEX.md ← aplankų žemėlapis, skaityti pirmiausia
├── company/ ← misija, juridinis asmuo, vertybės, teisinės taisyklės
├── products/ ← produktai, programos, kainos
├── audience/ ← kliento profilis, segmentai, prieštaravimai
├── goals/ ← metiniai, ketvirčio ir mėnesio tikslai, rodikliai
├── economics/ ← vieneto ekonomika, pajamos, išlaidos, prognozė
├── marketing/ ← kanalai, pardavimo piltuvas, medžiaga, konkurentai
├── execution/ ← savaitinis planavimas, darbų sąrašas
└── assets/ ← dizaino sistema, atsiliepimai, tekstų bankas
Tai autoriaus aprašyto projekto pavyzdys, o ne dogma. Aplankus kuriu pagal poreikį. Pradėjau nuo trijų (products/, audience/, goals/); kiti atsirado po 2-3 mėnesių, kai tapo neaišku, kur dėti naujus dalykus.
Pagrindinis aplanko failas yra INDEX.md. Tai žemėlapis. Jame yra lentelė „klausimas → failas“, pagal kurią Claude supranta, kur eiti. Be jos agentas eikvoja žetonus iš eilės skaitydamas kiekvieną failą.
INDEX.md ištraukos pavyzdys:
### Kur ko ieškoti
| Ko reikia | Kur ieškoti |
|---|---|
| Kas yra mūsų klientas ir kokios jo problemos | `business/audience/avatar.md` |
| Produktai, planai ir kainos | `business/products/` |
| Tikslai ir rodikliai | `business/goals/` |
| Ekonomika (pajamos, išlaidos, vieneto ekonomika) | `business/economics/` |
| Reklamos kanalai ir medžiaga | `business/marketing/` |
Tuomet užtenka vienos eilutės CLAUDE.md: „Jei klausimai apie verslą, perskaityk business/INDEX.md ir vadovaukis žemėlapiu.“ Agentas neįkelia viso aplanko į kontekstą. Jis įkelia žemėlapį, pasirenka tinkamą failą ir perskaito tik jį.
Ko nedėti į business/:
- Neapdorotos susirašinėjimo pokalbiuose medžiagos. Jei joje yra įžvalga, ją apibendrinkite ir užrašykite. Jei nėra – nedėkite.
- Informacijos, kuri dubliuojama kode. „Mokėjimai apdorojami per CloudPayments“ nereikalinga; agentas gali tai matyti kode.
- Ekrano kopijų ir vaizdų. Jie didina aplanko apimtį, o tekstinis modelis jų neapdoroja be papildomo veiksmo.
- Dinamiškų skaičių. „Šiandien už produktą sumokėta 423 kartus“ po savaitės bus pasenę. Naudokite žymą LIVE ir nuorodą į duomenų bazės užklausą.
- Jautrios ar abejotinos informacijos. Jei rytoj saugykla būtų paskelbta „YouTube“ prieš 100 tūkstančių nepažįstamųjų, palikite tik tai, ką sutiktumėte parodyti. Šį aplanką skaito darbuotojai, agentai, o kartais ir išorės rangovai.
Dėmesio
Jei saugykla vieša, viešas ir aplankas business/. Antrąsias smegenis tvarkau taip, tarsi saugykla rytoj galėtų tapti vieša, net jei dabar ji privati. Jokių klientų vardų be sutikimo, jokių mėnesio pajamų skaičių, jokių slaptažodžių. Šis įprotis padeda išvengti daug streso.
Kodėl reikia atskiro ai-clone aplanko ir kodėl jo nereikėtų maišyti su business?
Svarbiausia
ai-clone/ saugo jūsų skaitmeninę projekciją: principus, toną, draudžiamus žodžius ir grįžtamąjį ryšį po klaidų. Kiekviena agento klaida virsta taisykle aplanke ai-clone/feedback/ pagal formulę „taisyklė → kodėl → kaip taikyti“. Šis aplankas keliauja su jumis iš projekto į projektą. business/ lieka prie projekto. Laikykite juos atskirai: naujame projekte business/ bus naujas, o jūsų principai ir stilius liks tokie patys.
Idėja paprasta: verslas žino, ką darome. Klonas žino, kaip priimu sprendimus.
ai-clone/ struktūra autoriaus aprašytame projekte:
ai-clone/
├── INDEX.md ← aplanko žemėlapis
├── role.md ← kas esu, mano patirtis, kas man svarbu
├── identity/ ← vertybės, vizija, misija
├── thinking/ ← pranešimuose aptarti mąstymo modeliai
├── voice/ ← tonas, žodynas, stilius
├── principles/ ← įsitikinimai apie produktą, kodą, verslą
├── feedback/ ← iš klaidų išmoktos taisyklės ← pagrindinis aplankas
├── style/ ← draudžiami žodžiai, „Telegram“ formatas
└── reference/ ← įrankiai, aplinka
Naudingiausias aplankas yra feedback/. Jame saugomos konkrečios taisyklės, kurių išmokau iš agentų klaidų. Kiekviena taisyklė įrašoma atskirame faile pagal šį formatą:
---
name: short-name
description: one line - what’s in the file and when to apply it
type: feedback
---
Trumpa taisyklė vienu sakiniu.
**Kodėl:** kodėl ši taisyklė galioja. Kontekstas, incidentas, pastebėjimas.
**Kaip taikyti:** konkrečios situacijos, kada taisyklė taikoma.
Be dalies „Kodėl“ taisyklė negyva – agentas jos nepritaikys panašioje situacijoje. Be dalies „Kaip taikyti“ neaišku, kada taisyklę naudoti.
Pavyzdys iš mano aplanko: taisyklė „brūkšnelis, o ne ilgasis brūkšnys“. Ji atsirado todėl, kad ilgasis brūkšnys — yra ryškus sugeneruoto teksto vizualinis ženklas. Taisyklė taikoma bet kokiam viešam tekstui. Failas yra ai-clone/feedback/no-em-dashes.md.
Aš darau šiek tiek kitaip: taisykles rašau į ai-clone/feedback/, o ne į CLAUDE.md. CLAUDE.md yra projekto failas, o tono ir stiliaus taisyklės – asmeninės. Jos keliauja su manimi į kitą projektą. CLAUDE.md lieka prie projekto.
Pastaba
Šio metodo brandą galima matuoti pagal tai, kiek kartų per savaitę dėl to paties dalyko sakote agentui „ne, ne taip“. Brandžioje sistemoje atsakymas yra nulis. Kiekviena klaida virsta taisykle aplanke feedback/, ir kitą kartą agentas jos nekartoja.
Kas yra tiesioginiai rodikliai ir kodėl nereikėtų fiksuoti skaičių failuose?
Svarbiausia
Skaičiai antrųjų smegenų failuose pasensta per kelias dienas. „1,000 klientų“ šiandien rytoj taps 1,050, o po mėnesio – 2,000. Jei juos įrašysite kaip fiksuotus, po mėnesio agentas siūlys veiksmus remdamasis vakarykščiais duomenimis. Sprendimas – žyma LIVE faile ir atskiras dokumentas live-metrics.md su paruoštomis vykdyti SQL užklausomis. Pamatęs LIVE, agentas nueina į duomenų bazę, gauna dabartinį skaičių ir samprotauja remdamasis naujausiais duomenimis.
Viena pagrindinių klaidų kuriant antrąsias smegenis – pripildyti jas pasenusiais skaičiais. Parašote „turime 320 klientų“, o po dviejų savaičių jų jau 410. Parašote „mėnesio pajamos yra 4.7 milijono“, o po mėnesio nebeaišku, ką šis skaičius reiškia: tikslą, faktines pajamas ar prognozę?
Autoriaus pavyzdyje tai veikia taip. Faile business/products/practicum.md vietoj skaičiaus įrašoma žyma:
## Kohortos
> **LIVE** - vykdykite užklausas iš `live-metrics.md`, skilties „Pardavimai“,
> kad pamatytumėte dabartinius mokėjimus pagal kohortą.
| Kohorta | Datos | Mokantys |
|-------|------|------------|
| 1 | Kovo 10-12, 2026 | LIVE |
| 2 | Kovo 24-26, 2026 | LIVE |
Atskirame faile live-metrics.md pateikiamos paruoštos vykdyti SQL užklausos ir aprašymai, ką jos grąžina:
## Pardavimai (mokėjimai pagal kohortą)
```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;
```
Kai paklausiu agento „kiek mokėjimų turime už antrąją kohortą?“, jis:
- Perskaito
business/products/practicum.md - Pastebi šalia skaičiaus esančią žymą LIVE
- Atidaro
live-metrics.md - Randa skiltį „Pardavimai“
- Paleidžia užklausą produkcinėje duomenų bazėje
- Atsako naudodamas naujausius duomenis
Taip išsprendžiamos dvi problemos vienu metu. Skaičiai nepasensta. O sprendimai priimami remiantis dabartiniu vaizdu, ne praėjusių metų duomenimis.
Dėmesio
Autoriaus aprašytu būdu prieigą prie produkcinės duomenų bazės turi tik patikimi agentai. Jie ją gauna tik per tarpinę programą, kuri registruoja užklausas ir neatskleidžia slaptažodžių. Tiesioginė psql komanda su atviru tekstiniu slaptažodžiu faile live-metrics.md yra bloga mintis. Sukurkite tarpinę programą, kuri paima slaptažodį iš aplinkos kintamojo ir neįtraukia jo į išvestį. Tai atskiras techninis sluoksnis, bet be jo LIVE virsta saugumo spraga.
Kaip AI naviguoja antrosiose smegenyse vykdydamas vieną užklausą?
Svarbiausia
Užklausos eiga visada tokia pati: Claude perskaito CLAUDE.md, pamato žemėlapius (business/INDEX.md, ai-clone/INDEX.md), pereina į reikiamą INDEX, pagal jį randa konkretų failą ir prireikus per LIVE gauna skaičių. Tai 5-6 skaitymo operacijos, užuot krovus visą aplanką į kontekstą. Langas lieka laisvas samprotauti, o žetonai neeikvojami nesusijusiems failams.
Konkreti užklausa, pavyzdžiui: „parenk el. laišką dalyviams apie naują kohortą“.
- Claude pradeda nuo tuščio lango. Įkelia CLAUDE.md (taisykles, technologijų rinkinį, nurodymus).
- CLAUDE.md nurodymuose pamato: „
ai-clone/INDEX.md– visada skaityti sesijos pradžioje.“ Atidaro failą ir sužino, kas aš esu, koks mano tonas ir kokius draudžiamus žodžius naudoju. - Nurodymuose pamato: „el. laiškų šablonai –
src/lib/email/layout.ts.“ Atidaro failą ir perpranta formatą. - Pamato: „produkto kontekstas –
business/products/practicum.md.“ Atidaro failą ir perskaito apie produktą. - Faile pamato žymą LIVE ir nuorodą į
live-metrics.md. Atidaro failą ir randa paruoštą vykdyti SQL užklausą. Jei reikia dabartinio skaičiaus, paleidžia užklausą. Jei ne, pasižymi „gauti šį skaičių siuntimo metu“. - Pamato tono taisykles faile
ai-clone/style/telegram-format.md, ilgojo brūkšnio draudimą faileai-clone/feedback/no-em-dashes.mdir konversijos rodiklius failebusiness/marketing/funnel.md.
Jis parašo el. laišką mano tonu, su naujausiais skaičiais ir be ilgųjų brūkšnių ar AI požymių.
Savo inžinerijos tinklaraštyje Anthropic šį metodą vadina kontekstu tinkamu momentu:
Agentai, sukurti pagal „tinkamu momentu“ principą, saugo lengvus identifikatorius (failų kelius, išsaugotas užklausas, nuorodas ir kt.) ir naudoja šias nuorodas dinamiškai įkelti duomenis į kontekstą vykdymo metu per įrankius.
Kitaip tariant, Claude nešiojasi nuorodas į duomenis, o ne pačius duomenis. Taip žetonai naudojami daug taupiau ir darbas tikslesnis, nes kontekste atsiduria tik aktuali informacija. Langas lieka laisvas samprotauti.
5 antrosios smegenų antipaternų – ko reikėtų vengti?
Svarbiausia
Pagrindinės pradedančiųjų klaidos kuriant antrąsias smegenis: 1) išpūstas, 500+ eilučių CLAUDE.md vietoj trumpo nukreipimo failo; 2) universalus saugojimo aplankas, tampantis sąvartynu; 3) dubliuojama tai, ką Claude jau žino iš kalbos ar kodo; 4) fiksuojami skaičiai pasensta, jei nenaudojamas LIVE; 5) kontekstas paliekamas agentui nepasiekiamas arba nesukuriamas kelias į jį, nesvarbu, ar jis toje pačioje saugykloje, ar atskiroje privačioje vietoje.
Antipatternas 1. Išpūstas CLAUDE.md. 500 eilučių instrukcijų „užuot viską sutalpinus vienoje vietoje“. Anthropic kalba tiesiai:
Rašykite glaustai. Prie kiekvienos eilutės paklauskite: „Ar Claude pradės klysti, jei ją pašalinsiu?“ Jei ne, ištrinkite. Išpūsti CLAUDE.md failai priverčia Claude ignoruoti tikruosius jūsų nurodymus!
Tikslinė apimtis – 80-120 eilučių. Visa kita sudėkite į atskirus failus ir nurodykite, kur jų ieškoti.
Antipatternas 2. Universalus aplankas. Į antrąsias smegenis metate viską: neapdorotą susirašinėjimą, nenaudingas ekrano kopijas, ataskaitas, kurių niekas neskaitys. Po mėnesio aplankas išsipučia, agentas eikvoja žetonus skaitydamas šiukšles, o jūs nebežinote, kur kas yra. Taisyklė: kiekvienas antrųjų smegenų failas turi atsakyti į konkretų klausimą. Jei niekas jo neatidarė šešis mėnesius, ištrinkite arba perkelkite į archyvą.
Antipatternas 3. Dubliavimas. „Mokėjimai vyksta per CloudPayments faile src/lib/payment/cloudpayments.ts; paslaugų teikėjas nustatytas faile .env.“ Agentas visa tai gali matyti kode. Nedubliuokite informacijos aplanke business/. Dublikatai pasensta: kodas pasikeičia, business/ neatnaujinamas, o agentas remiasi pasenusia informacija.
Antipatternas 4. Fiksuoti skaičiai. „Turime 1,247 klientus, o konversija siekia 6.3 %“ – įsivaizduokite, kad tai skaičiai iš kokio nors abstraktaus fintech startuolio. Visi tokie skaičiai po savaitės bus pasenę. Naudokite žymą LIVE ir live-metrics.md. Apie tai rašoma aukščiau.
Antipatternas 5. Kontekstas be pasiekiamo kelio. Jei antrosios smegenys yra kitoje vietoje, o agentas neturi nei leidimo, nei nuorodos į jas, nepakanka paleisti jį kodo aplanke. Nejautrioms bendroms pastaboms patogu laikyti business/ ir ai-clone/ projekto saugykloje. Privatų kontekstą laikykite atskirai kontroliuojamoje vietoje ir aiškiai nustatykite leidžiamą prieigą bei nukreipimą. Aplankų patogumas nepanaikina konfidencialumo.
Patarimas
Atskira šaka (context ar business-context) organizuoja darbą, tačiau nėra prieigos riba: jos failai lieka tos pačios saugyklos Git objektais ir gali būti paskelbti su šakomis ar istorija. Privačiam verslo kontekstui naudokite atskirą privačią saugyklą ar išorinę vietą su aiškiais prieigos valdikliais ir leidžiamu agento nukreipimu. Submodule gali rodyti į atskirą privačią saugyklą, tačiau jos privatumą suteikia tos saugyklos leidimai, o ne pats submodule. Kitas variantas — sąmoningai ignoruojamas vietinis aplankas su sava atsargine kopija; ignoravimas nepašalina jau Git sekamų failų ar anksčiau paskelbtos istorijos. Su kodu laikykite tik bendrinti tinkamą kontekstą.
Kaip per valandą sukurti antrąsias smegenis – nuoseklus vadovas
Svarbiausia
Minimalią antrųjų smegenų sistemą galite susikurti per valandą: sukurkite šakninius aplankus business/ ir ai-clone/, kiekviename paruoškite žemėlapį INDEX.md, pridėkite trumpą produkto aprašą į business/products/, kliento aprašą į audience/, o aprašą apie save – į ai-clone/role.md. CLAUDE.md nurodykite, kaip pereiti į šiuos aplankus. Tada plėskite struktūrą dirbdami: po kiekvienos agento klaidos pridėkite taisyklę į ai-clone/feedback/, po kiekvieno sprendimo – pastabą į business/.
Sukurkite du šakninius aplankus
Projekto šakniniame aplanke, šalia
src/:mkdir -p business/{products,audience,goals,economics,marketing} mkdir -p ai-clone/{identity,voice,principles,feedback,style}Sukurkite INDEX.md kaip aplanko žemėlapį
business/INDEX.mdyra lentelė „klausimas → failas“. Pradėkite bent nuo 5 eilučių, o kitas pridėkite vėliau. Tą patį padarykite ir faileai-clone/INDEX.md.Pridėkite trumpus produkto ir kliento aprašus
business/products/main.md– kas yra produktas, kam jis skirtas, kiek kainuoja ir kuo skiriasi nuo kitų. 30-50 eilučių.business/audience/avatar.md– kas yra klientas, kokios jo problemos ir ką jis perka. 30-50 eilučių. Aprašykite tikrą, o ne idealų klientą. Jei ko nors nežinote, pažymėkite „reikia išsiaiškinti“ ir tęskite.Aprašykite save faile ai-clone/role.md
Kas esate, ką veikiate ir kas jums svarbu. 20-30 eilučių. Pradžiai tiek pakanka. Toną, principus ir draudžiamus žodžius pridėkite pastebėję, kad agentas rašo ne jūsų stiliumi.
Pridėkite nukreipimo informaciją į CLAUDE.md
Atidarykite
CLAUDE.mdir pridėkite skiltį:## Projekto žemėlapis - Verslo kontekstas → `business/INDEX.md` - Kontekstas apie mane → `ai-clone/INDEX.md` - Techniniai planai → `plans/YYYY-MM-DD-*.md` - Ankstesnių sesijų apmąstymai → `retrospectives/` Sesijos pradžioje visada perskaityk `ai-clone/INDEX.md` ir `business/INDEX.md`.Paleiskite Claude Code ir patikrinkite
Atidarykite agentą. Paklauskite: „papasakok apie mano produktą ir auditoriją“. Jei jis atsako remdamasis aplanko kontekstu, vadinasi, viskas veikia. Jei prasimano, patikrinkite, ar aplankai yra šalia projekto, ar failai tinkamai pavadinti ir ar CLAUDE.md nukreipimai tiksliai suformuluoti.
Vėliau antrosios smegenys auga vadovaujantis dviem principais.
Pirma: kiekvieną kartą agentui suklydus pridėkite taisyklę. Po 3-4 savaičių aplanke ai-clone/feedback/ bus 15-20 taisyklių failų, ir agentas nebekartos daugumos įprastų klaidų.
Antra: kiekvieną kartą priėmę verslo sprendimą, užrašykite jį aplanke business/. Jei pakeliate kainą, pridėkite pastabą faile business/products/pricing.md ir nurodykite datą bei priežastį. Jei pakeičiate pozicionavimą, pridėkite pastabą faile business/company/about.md. Po šešių mėnesių turėsite archyvą, kuris atsimena „kodėl“.
Raginimas: paruoštas tekstas vakarinei antrųjų smegenų peržiūrai
Šią savaitę kartu nuveikėme nemažai.
Išanalizuok visus šios savaitės kodo pakeitimus ir visus mūsų atliktus commit.
Kokią vertingą informaciją iš jų reikėtų įrašyti į business/? Įrašyk ją į tinkamus failus
ir pridėk wiki nuorodų į gretimus failus, kad kontekstas neprapultų.
Jei kode yra sprendimų, kurių nepaaiškinau, paklausk manęs, kodėl juos priėmiau,
ir užrašyk priežastį tinkamame faile su data.
Nekartok to, kas jau akivaizdu iš kodo. Įtrauk tik tai, ko agentas
nežinotų kitoje sesijoje neturėdamas business/.
Kas toliau – Skills, Subagents ir konteksto inžinerija
Svarbiausia
Antrosios smegenys ir CLAUDE.md yra pagrindas. Ant jo kuriami Skills (procedūrinės žinios, įkeliamos pagal poreikį pagal užduoties aprašą), Subagents (atskiros Claude instancijos su atskirais konteksto langais sudėtingoms užduotims) ir konteksto inžinerija (valdymas to, kas patenka į langą). Tai trys viršutiniai aukštai. Be pagrindo jie neveikia – agentas neturi ko skaityti.
Sukūrus antrąsias smegenis lieka dar trys įrankiai, kuriuos Anthropic aprašo kaip tris skirtingus konteksto optimizavimo lygius.
Skills – tai procedūrinės žinios. Jei kartojate darbo eigą (rašote mokymosi vadovą, rengiate „Telegram“ įrašą, audituojate svetainę), galite ją aprašyti faile SKILL.md kartu su užduoties aprašu. Sesijos pradžioje Claude peržiūri skills pavadinimus ir aprašymus, o įkelia tik tuos, kurie tinka dabartinei užduočiai. Taip taupomi žetonai ir išlaikomas dėmesys.
Subagents – tai atskiros Claude instancijos su savais konteksto langais. Sudėtingai užduočiai paleiskite subagentą (perskaityti 30 failų ir parengti santrauką): jis dirbs savo lange ir grąžins tik rezultatą. Pagrindinis langas liks laisvas. Anthropic rašo:
Specializuoti subagentai gali spręsti konkrečias užduotis švariuose konteksto languose. [...] Kiekvienas subagentas gali plačiai tyrinėti ir sunaudoti dešimtis tūkstančių žetonų ar daugiau, tačiau grąžina tik sutrumpintą ir apibendrintą savo darbo santrauką (dažnai 1,000-2,000 žetonų).
Konteksto inžinerija – tai valdymas to, kas apskritai patenka į langą. Anthropic komanda 2025 m. ją pavadino pagrindiniu darbo su agentais įgūdžiu, esančiu vienu lygiu aukščiau už prompt engineering. Prompt engineering – tai tinkamų žodžių pasirinkimas. Konteksto inžinerija – tai failų, maršrutų, skills ir subagentų pasirinkimas.
Antrosios smegenys yra pirmasis konteksto inžinerijos elementas. Be jų Skills neturi ko skaityti, Subagents neturi kur eiti, o agento langas prisipildo atsitiktinės informacijos. Turint antrąsias smegenis, visi trys įrankiai pradeda veikti.
Kitas žingsnis. Sukurkite du aplankus šalia projekto: business/ ir ai-clone/. Į kiekvieną įdėkite INDEX.md su 5 žemėlapio eilutėmis. CLAUDE.md pridėkite keturias nukreipimo eilutes. Per valandą turėsite veikiantį antrųjų smegenų pagrindą. Tada jį plėskite pagal taisyklę „po kiekvienos agento klaidos pridėk vieną eilutę į ai-clone/feedback/“. Visą CLAUDE.md šabloną, kurį naudosite nukreipti į antrąsias smegenis, aiškinu vadove Kaip tinkamai nustatyti CLAUDE.md.
Šaltiniai
- Claude Code atminties dokumentacija - oficiali Anthropic Claude Code atminties hierarchija
- Claude Code geriausia praktika - oficialios rekomendacijos, kaip dirbti su CLAUDE.md
- Veiksminga AI agentų konteksto inžinerija - Anthropic Engineering paaiškinimas apie konteksto nykimą, dėmesio biudžetą ir kontekstą, įkeliamą tinkamu momentu
- Skills paaiškinti - Anthropic tinklaraščio įrašas apie skirtumus tarp Skills, Memory, Subagents ir MCP
Toliau susipažinkite su Ailoot adresu ailoot.ai.
Išsamiau
Klausimai ir atsakymai
Ar verslo kontekstas kitoje Git šakoje lieka privatus?
Ne. Šaka yra tos pačios saugyklos dalis, o jos failai gali būti bendrinami su saugyklos objektais ir istorija. Naudokite atskirai kontroliuojamą privačią vietą arba sąmoningai ignoruojamą vietinį aplanką su atsargine kopija; ignoravimas neištrina esamos sekamos istorijos.
Kaip agentas turi rasti privatų kontekstą už kodo saugyklos ribų?
Pateikite aiškią nuorodą ir tik užduočiai reikalingus prieigos leidimus. Laikykite trumpą indeksą, nukreipiantį į tinkamą dokumentą, ir patikrinkite, ar agentas gali perskaityti leidžiamą failą; privati vieta be nukreipimo savaime konteksto nepateikia.