# Második agy a Claude Code-ban: hogyan építsd fel egy óra alatt > Hogyan építsünk második agyat a Claude Code-hoz: memóriaszintek, ötrészes mappastruktúra és git, hogy az ügynök két munkamenet között is emlékezzen a projektről mindenre. Source: https://ailoot.ai/blog/hu/claude-code-second-brain/ Canonical: https://ailoot.ai/blog/hu/claude-code-second-brain/ Language: hu Publisher: Ailoot (https://ailoot.ai/) Translation: guide-233 Revision: sha256-4c0da6c2b0fe707cc6d7522447b9bfc06e270cb802993b3eb6e46df1ca972b3a
Lényeg A Claude Code második agya nem egyetlen fájl, hanem öt mappa és a git együttese. A CLAUDE.md rögzíti a szabályokat és az útvonalakat, a `business/` tárolja a projekttel kapcsolatos tudást, az `ai-clone/` a döntéshozóként rólad szóló információkat, a `plans/` a műszaki terveket, a `retrospectives/` pedig a korábbi munkamenetek tanulságait. Az ügynök a CLAUDE.md fájllal kezd, és a konkrét kérésnek megfelelő mappába mutató hivatkozásokat követi. Ez a cikk a Claude Code hivatalos dokumentációjának memóriaszintjeit, az ötrészes struktúrát és annak lépésről lépésre, egy óra alatt történő felépítését mutatja be.
Ailoot referencia-dokumentáció: [ailoot.ai/docs/](https://ailoot.ai/docs/). ## Miért van szüksége a Claude Code-nak második agyra, és mi a lényeg?
Lényeg Egyetlen CLAUDE.md-fájl lefedi az alapvető szabályokat, de az üzleti memóriát nem tudja kezelni. Egy hónap múlva elfelejtetted, miért emelted az árat. Három hónap múlva már arra sem emlékszel, miért utasítottad el a részletfizetést. A tudás egyszerre négy helyen él: a fejedben, Telegram-beszélgetésekben, Google-dokumentumokban és az alkalmazottak fejében. A második agy egyetlen, markdownfájlokat tartalmazó mappába gyűjti mindezt a projekt mellett, Claude pedig önállóan hozzáférhet.
Kedden megnyitod a Claude Code-ot. Elmagyarázod: ez a projekt, ez a közönség, ezt ne csináld. Együtt dolgoztok. Csütörtökön új beszélgetés indul, és mindent újra el kell magyaráznod. Ha van CLAUDE.md-fájlod, már túljutottál a frusztráció első körén. Az alapvető szabályok és a projektleírás egyetlen fájlban élnek, és minden munkamenetben betöltődnek. A [CLAUDE.md-ről szóló útmutatómban](https://ailoot.ai/blog/hu/claude-md-template/) elmagyaráztam, hogyan működik ez a fájl - először azt is elolvashatod, hogy meglegyenek az alapok. A CLAUDE.md azonban egy új alkalmazott kézikönyve. Hogyan öltözzön, milyen hangnemben beszéljen az ügyfelekkel, milyen parancsokkal tegye közzé a tartalmat. Ez nem elég ahhoz, hogy jó döntéseket hozzon a projektről. A döntésekhez tudás kell: mi a termék, kik a közönség tagjai, hogyan működik a gazdaságossága, mit próbáltál már, és mi nem működött. A szerző itt leírt tapasztalatai szerint ez a tudás korábban négy helyen élt: a fejében, Telegram-beszélgetésekben, Google-dokumentumokban és az alkalmazottak fejében. Egy döntés után egy hónappal senki sem emlékezett már rá, miért született. Egy új embernek egy órán át kellett kérdezgetnie a csapatot, hogy képbe kerüljön. Claude egyáltalán nem részesült ebből a kontextusból. A második agy előtt, a szerző ismertetett tapasztalatai szerint, minden munkamenet azzal járt, hogy újra el kellett magyarázni, ki az ügyfél, hogyan épül fel az ajánlat, és melyik szolgáltató kezeli a fizetéseket. A `business/` mappával megnyitok egy beszélgetést, és azt mondom: „frissítsd az ajánlatot az új árképzési csomaghoz” - Claude magától megnyitja a `business/company/legal.md` fájlt, elolvassa a követelményeket, majd a `business/products/pricing.md` fájlt, megnézi az új árképzési csomagot, és egy menetben javasol módosítást. Nincs több bemelegítés; a kontextus automatikusan betöltődik.
Megjegyzés Ez nem Claude memóriájának problémája. Ez architekturális kérdés. Az ügynök kontextusablaka a munkamemóriája. Csak azt tölti be, amire kifejezetten ráirányítod. Minden más az ablakon kívül marad, és igény szerint töltődik be. A második agy strukturáltan tárolja ezt a „minden mást”, hogy Claude eligazodjon benne.
Az Anthropic a mérnöki blogjában context rot néven hivatkozik erre a problémára:
Minél több token van a kontextusablakban, annál rosszabbul idézi fel a modell pontosan az abban szereplő információkat.
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents
Más szóval, minél többet zsúfolsz az ablakba, az ügynök annál rosszabbul kezeli a konkrét részleteket. A megoldás egy külső fájlstruktúra fenntartása, amelyet Claude egy adott kérésre önállóan felkereshet. Ez a második agy. ## Mi az a második agy, és hogyan alkalmazható Claude-ra?
Lényeg Az ötlet egyszerű: az elméd gondolkodásra való, nem tárolásra. A Claude Code esetében egy második agy produktivitási módszerből ügynökarchitektúrává válik: egy külső jegyzetmappává, amelyet az ügynök közvetlenül elér a fájlrendszeren keresztül.
A második agy általában a produktivitásról szól: az emberek Obsidian-tárolót hoznak létre, és könyvrészletekkel, hívásjegyzetekkel, valamint projektötletekkel töltik meg. Amikor a szerző ezt az ötletet a Claude Code-dal végzett munkára alkalmazta, a produktivitás helyett az ügynökarchitektúra került előtérbe. A klasszikus megközelítésben a második agy a tiéd, és kézzel férsz hozzá. Claude Code-dal dolgozva a második agy **kétirányúvá** válik: te és az ügynök is hozzáfértek. Ez megváltoztatja a formátumával szembeni követelményeket. Mivel az ügynök önállóan fér hozzá, a fájloknak olyan formátumban kell lenniük, amelyet külön integráció nélkül is ért. A markdown ideális: szöveg, címsorhierarchia és fájlok közötti hivatkozások. A Notion és a Google Docs nem megfelelő. MCP-n keresztül összekapcsolhatod őket, de ezzel újabb réteg, kérésenként egy újabb token és még egy hibalehetőség jár. Mivel a fájlok a projekt mellett, a fájlrendszerben vannak, automatikusan a Claude Code rendelkezésére állnak. Nincs szükség beállításra. Indítsd az ügynököt a projekt mappájából, és látni fogja az összes benne lévő fájlt. Ingyenes és azonnal működik.
Tipp A második agyadat Obsidianban is tarthatod - én is ott nyitom meg, mert úgy könnyebb áttekinteni a kapcsolatok gráfját. Maguk a fájlok azonban egy hagyományos mappában vannak a kód mellett. Az Obsidian csupán egy kényelmes felület a markdownfájlokhoz. Claude Obsidian nélkül is látja őket. Bármilyen szerkesztőt használhatsz; az a fontos, hogy a fájlok a lemezen legyenek, ne egy saját formátumot használó felhőszolgáltatásban.
## Milyen memóriaszintek vannak alapból a Claude Code-ban?
Lényeg A Claude Code alapból a CLAUDE.md négy szintjét tudja olvasni (enterprise, user, project és local), a 2.1.59-es verzió óta pedig saját automatikus memóriát tart fenn a `~/.claude/projects//memory/` mappában. Ez elegendő az alapvető memóriához, az üzleti kontextushoz azonban nem - azt egy külön, a projekt melletti mappában tárold.
Mielőtt bármit hozzáadnánk, nézzük meg, mire emlékszik Claude a segítséged nélkül. Az Anthropic a [hivatalos dokumentációjában](https://code.claude.com/docs/en/memory) két mechanizmust ismertet: CLAUDE.md (az általad írt szabályok) és automatikus memória (a Claude által írt tanulságok). Mindkettő minden munkamenet kezdetén töltődik be. A CLAUDE.md fájlt egyszerre négy helyen keresi: | Szint | Hely | Cél | |----|----|----| | **Enterprise** | `/Library/Application Support/ClaudeCode/CLAUDE.md` (macOS), `/etc/claude-code/CLAUDE.md` (Linux), `C:\Program Files\ClaudeCode\CLAUDE.md` (Windows) | A rendszergazda MDM-en keresztül a teljes csapatra érvényes szabályai. Magánszemélyeknek erre nincs szükségük. | | **User** | `~/.claude/CLAUDE.md` | Személyes szabályok, amelyek minden projektre érvényesek. „A nekem megfelelő nyelven válaszolj”, „ne használj em dash-t.” | | **Project** | `./CLAUDE.md` a projekt gyökérmappájában | Egy adott projektre vonatkozó szabályok: stack, mappastruktúra, üzleti szabályok. Gitbe commitolva. | | **Local** | `./CLAUDE.local.md` | Személyes jegyzetek ehhez a projekthez, amelyek nem kerülnek be a gitbe. A `.gitignore` fájlban szerepelnek. | Mind a négy fájl betöltődik a kontextusba. Minél konkrétabb a szint, annál magasabb a prioritása. A helyi fájl olvasása történik utoljára, ezért annak szabályai minden mást felülírnak. A projekt bármelyik mappájában lehet CLAUDE.md fájl. Amikor Claude egy almappából olvas fájlt, igény szerint betölti annak az almappának a CLAUDE.md fájlját is. Ez monorepókban hasznos: a frontend szabályai a `frontend/CLAUDE.md` fájlban, a backend szabályai a `backend/CLAUDE.md` fájlban vannak, és csak akkor töltődnek be, amikor az ügynök az adott résszel dolgozik. Az automatikus memória a Claude Code 2.1.59-ben jelent meg. Ezeket a fájlokat Claude írja rólad: ``` ~/.claude/projects//memory/ ├── MEMORY.md # Index, minden munkamenetben betöltődik (200 sor vagy 25KB) ├── debugging.md # Részletes jegyzetek (igény szerint betöltve) ├── api-conventions.md └── ... ``` Az Anthropic a hivatalos dokumentációban így írja le:
Claude nem ment el valamit minden munkamenetben. Maga dönti el, mit érdemes megjegyezni aszerint, hogy az információ hasznos lehet-e egy későbbi beszélgetésben.
— Anthropic, code.claude.com/docs/en/memory
Az automatikus memória a `~/.claude/settings.json` fájlban található `autoMemoryEnabled` flaggel engedélyezhető. Claude dönti el, mit ír oda. Elolvashatod a MEMORY.md fájlt, és kézzel is szerkesztheted - ez egyszerű markdown.
Figyelem Az automatikus memória hasznos, de nem helyettesíti a második agyat. Claude taktikai tanulságokat ír bele az eszközökről és a kódmintákról. „Ez a szkript az X flag nélkül hibásan működik”, „így hívják ezt az adatbázistáblát.” Üzleti stratégiát nem ír bele. Ha azt szeretnéd, hogy az ügynök emlékezzen a közönségedre és arra, miért választottál egy adott árat, ezt magadnak kell elhelyezned egy külön kontextusmappában.
## CLAUDE.md vagy második agy - hol húzd meg a határt?
Lényeg A CLAUDE.md az új alkalmazott kézikönyve: hogyan viselkedjen, milyen parancsokat használjon, és mit ne tegyen. A második agy a vállalati wiki: mit csinálsz, kinek szól, hogyan működik a gazdaságosság, és mit próbáltál már. Egyetlen viselkedési szabályokat tartalmazó fájl és egy külső tudásstruktúra. A CLAUDE.md az index, a második agy az archívum. Index nélkül az ügynök nem tud az archívum létezéséről. Archívum nélkül csak a szabályokat ismeri, az üzleti kontextust nem.
Íme az az analógia, amelyet az előadásaimon használok: képzeld el, hogy felvettél egy új alkalmazottat. Mit adsz oda neki az első napján? Egy kézikönyvet: hogyan öltözzön, mikor érkezzen, milyen hangnemben beszéljen az ügyfelekkel, milyen rendszeren keresztül tegye közzé a tartalmat. Ez egy rövid dokumentum. Nem magyarázza el, mit csinálsz vagy miért. Csak azt írja le, hogyan viselkedjen. Emellett hozzáférést adsz a vállalati wikihez. Az elmagyarázza, mi a termék, kinek szól, kik alkotják a közönséget, mennyi az ára és miért, kik a versenytársak, és milyen hibákat követtél el. Ez egy kiterjedt archívum. Senki sem olvassa el az egészet - egy konkrét kérdéssel keresed fel. CLAUDE.md = kézikönyv. Második agy = wiki. Mindkettőre szükséged van. A különbség egyszerű. Minden, ami **minden feladathoz kapcsolódik**, kerüljön a CLAUDE.md-be: - Ki az ügynök ebben a projektben (segítő, vezető, asszisztens) - Milyen nyelven válaszoljon - Eszközstack - Közzétételi parancsok - Tiltások (ne használj em dash-t, ne futtasd a `git push --force` parancsot) - Útvonalak: hol keresse az üzleti kontextust és hol az alapelveket Minden, amire **csak igény szerint van szükség**, kerüljön a második agyba: - A termék, a közönség, a gazdaságosság és a célok - Versenytársak és piac - Korábbi döntések és azok okai - Ügyfélpéldák és értékelések - Alapelvek és módszertan Az Anthropic ugyanezt a különbséget teszi dokumentációjában:
A CLAUDE.md minden munkamenetben betöltődik, ezért csak azt tedd bele, ami általánosan érvényes. A csak alkalmanként szükséges szakterületi tudáshoz vagy munkafolyamatokhoz használj skilleket. Claude ezeket igény szerint tölti be, így nem duzzasztja fel minden beszélgetést.
— Anthropic, code.claude.com/docs/en/best-practices
A skillek az epizodikus tudás tárolásának egyik módját jelentik. Egy másik lehetőség a projekt mellett elhelyezett `business/` mappa. Mindkettőt használom; lentebb részletesebben is elmagyarázom őket. ## Mi alkotja a projektagyat - 5 rész és egy időgép
Lényeg A projektagy öt mappából áll, amelyek fölött ott a git. A CLAUDE.md rögzíti a szabályokat és az útvonalakat. Az `ai-clone/` tárolja a digitális kivetülésedet: az elveidet, a hangnemedet és a hibák utáni visszajelzéseket. A `business/` tárolja a projekttel kapcsolatos tudást. A `plans/` szakaszonként tartalmazza a műszaki terveket. A `retrospectives/` a munkamenetek utáni visszatekintéseket tárolja. A git mindezt időgéppé alakítja: egy év múlva bármelyik fájlt megnyithatod, és megnézheted, mi volt benne egy döntés meghozatalakor.
Példaarchitektúra a szerző ismertetett tapasztalataiból: | Mappa | Mi van benne | Cél | |----|----|----| | **`CLAUDE.md`** | Projektszabályok, stack, fájlstruktúra, mappaútvonalak, kommunikációs nyelv | Ez az ügynök kézikönyve. Minden munkamenetben betöltődik. 200 sor alatt, ideális esetben 80-120 sor. | | **`ai-clone/`** | Ki vagyok, az elveim, a hangnemem, a döntési stílusom, a hibák utáni visszajelzések | Digitális kivetülés rólam mint döntéshozóról. Tudja, mit utasítok el azonnal, milyen stílusban teszek javaslatokat, és milyen szabályokat tanultam meg a hibákból. | | **`business/`** | Termék, közönség, célok, gazdaságosság, marketing, korábbi döntések, példák | Wiki-linkekkel összekötött markdownfájlok. Minden fájl `[[...]]` hivatkozásokon keresztül kapcsolódik a többihez. Az ügynök konkrét kérdés esetén keresi fel. | | **`plans/`** | Egy terv funkciónként. `YYYY-MM-DD-feature.md` fájl szakaszokkal és jelölőnégyzetekkel | A Plan Mode egy beszélgetésre korlátozódik, és `/clear` után elvész. A `plans/` mappa a tárolóban van - bármelyik ügynök bármikor folytathatja a tervet. | | **`retrospectives/`** | Visszatekintések minden munkamenet után: mi készült el, mire kell emlékezni, mit lehetne jobban csinálni | A rendszer önálló tanulása. A hibák szabályokká válnak az `ai-clone/feedback/` mappában. | | **`+ git`** | Az összes fájl verzióelőzménye | Időgép. Nyiss meg bármelyik fájlt, és futtasd a `git log` parancsot, hogy lásd, mikor és miért változott. | A legfontosabb módszertani pont az `ai-clone/` és a `business/` **különválasztása**. A `business/` arra válaszol: „mit csinálunk?” Termék, közönség, árak, versenytársak. A projektről szól. Ha holnap átadod a projektet egy partnernek, ez a mappa vele megy. Az `ai-clone/` arra válaszol: „hogyan hozok döntéseket?” Az elveim, a hangnemem, a szakmai tudásom és a kerülendő szavaim. Rólam szól. Ha holnap új projektbe kezdek, ez a mappa velem jön. Nemcsak egy második mappát szeretnél létrehozni, hanem olyan rendszert is, amely következetessé teszi Claude-ot? Ez önmagában nem elég. `ai-clone/` nélkül az ügynök mindenkinek válaszol, nem neked. Context engineering nélkül végigbolyongja az egész mappát, és elégeti a tokeneket. Érdemes mindhárom dolgot összekapcsolni: **második agy + AI-klón + context engineering**. Ez az a **három pillér**, amely nélkül az AI hallucinál. ## Mi kerüljön a business/ mappába, és mi ne?
Lényeg A hetente legfeljebb egyszer változó projektadatokat tedd a `business/` mappába: pozicionálás, közönség, termékek és árak, negyedéves célok, valamint fontos döntések. Hagyd ki a csevegések levelezését, a feldolgozatlan nyersanyagokat, a kódban már szereplő információkat, a képernyőképeket és a dinamikus számokat. A számokat váltsd fel LIVE jelölővel és egy SQL-lekérdezés hivatkozásával - erről lentebb külön szakaszban írok.
A `business/` legfelső szintű struktúrája a szerző ismertetett projektjében: ``` business/ ├── INDEX.md ← mappatérkép, először ezt olvasd el ├── company/ ← küldetés, jogi személy, értékek, jogi szabályzatok ├── products/ ← termékek, programok, árak ├── audience/ ← ügyfélprofil, szegmensek, kifogások ├── goals/ ← éves, negyedéves és havi célok, mutatók ├── economics/ ← egységgazdaságtan, bevételek, kiadások, előrejelzés ├── marketing/ ← csatornák, értékesítési tölcsér, anyagok, versenytársak ├── execution/ ← heti tervezés, backlog └── assets/ ← dizájnrendszer, értékelések, szövegtár ``` Ez példa a szerző ismertetett projektjéből, nem szigorú előírás. Szükség szerint hozok létre mappákat. Hárommal kezdtem (`products/`, `audience/`, `goals/`); a többit 2-3 hónap után adtam hozzá, amikor már nem volt egyértelmű, hová tegyem az új dolgokat. A mappa fő fájlja az `INDEX.md`. Ez egy térkép. Egy „kérdés → fájl” táblázat van benne, amely megmutatja Claude-nak, hová menjen. Nélküle az ügynök tokeneket pazarol arra, hogy sorban elolvassa az összes fájlt. Példarészlet az `INDEX.md` fájlból: ```markdown ### Hol találsz meg dolgokat? | Amire szükséged van | Hol keresd? | |---|---| | Kik az ügyfeleink, és mik a fájdalompontjaik? | `business/audience/avatar.md` | | Termékek, csomagok és árak | `business/products/` | | Célok és mutatók | `business/goals/` | | Gazdaságosság (bevételek, kiadások, egységgazdaságtan) | `business/economics/` | | Promóciós csatornák és anyagok | `business/marketing/` | ``` A CLAUDE.md-ben egyetlen sor is elég: „Üzleti kérdéseknél olvasd el a `business/INDEX.md` fájlt, és kövesd a térképet.” Az ügynök nem tölti be az egész mappát a kontextusba. Betölti a térképet, kiválasztja a megfelelő fájlt, és csak azt olvassa el. **Ellenőrzőlista arról, mit ne tegyél a `business/` mappába:** - Feldolgozatlan csevegéses levelezés. Ha van benne felismerés, szűrd le és írd le. Ha nincs, hagyd ki. - A kódban már szereplő információ. A „fizetések CloudPaymentsen keresztül mennek” nem szükséges; az ügynök látja a kódban. - Képernyőképek és képek. Növelik a mappa méretét, és további lépés nélkül nem dolgozza fel őket egy szöveges modell. - Dinamikus számok. „Ma 423 fizetés történt a termékért” egy hét múlva elavult lesz. Használj LIVE jelölőt és adatbázis-lekérdezésre mutató hivatkozást. - Érzékeny vagy kétes információk. Ha holnap 100 ezer idegen előtt tennéd közzé a YouTube-on a tárolót, csak azt tartsd meg, amit meg is mutatnál. Alkalmazottak, ügynökök és néha külső vállalkozók is olvassák ezt a mappát.
Figyelem Ha a tároló nyilvános, a `business/` mappa is az. Úgy kezelem a második agyat, mintha a tároló holnap nyilvánossá válhatna, akkor is, ha most privát. Ne legyenek benne beleegyezés nélkül ügyfélnevek, havi bevételi adatok vagy jelszavak. Ez a szokás sok aggodalmat megelőz.
## Miért legyen külön ai-clone mappa, és miért ne keverd össze a business mappával?
Lényeg Az `ai-clone/` tárolja a digitális kivetülésedet: elveidet, hangnemedet, kerülendő szavakat és a hibák utáni visszajelzéseket. Minden ügynöki hiba szabállyá válik az `ai-clone/feedback/` mappában, a következő képlettel: „szabály → miért → hogyan alkalmazd”. A mappa veled megy projektről projektre. A `business/` a projekttel marad. Tartsd őket külön: az új projektben új lesz a `business/`, az elveid és a stílusod azonban változatlanok maradnak.
Az ötlet egyszerű: az üzlet tudja, mit csinálunk. A klón tudja, hogyan hozok döntéseket. Az `ai-clone/` struktúrája a szerző ismertetett projektjében: ``` ai-clone/ ├── INDEX.md ← mappatérkép ├── role.md ← ki vagyok, háttér, mi fontos ├── identity/ ← értékek, jövőkép, küldetés ├── thinking/ ← előadásokból származó mentális modellek ├── voice/ ← hangnem, szókincs, stílus ├── principles/ ← a termékről, kódról és üzletről vallott nézetek ├── feedback/ ← a hibákból tanult szabályok ← fő mappa ├── style/ ← kerülendő szavak, Telegram-formátum └── reference/ ← eszközök, környezet ``` A leghasznosabb mappa a `feedback/`. Az ügynökök hibáiból tanult konkrét szabályokat tartalmazza. Minden szabály külön fájlba kerül, ilyen formátumban: ```markdown --- name: short-name description: egy sor - mi van a fájlban, és mikor kell alkalmazni type: feedback --- Rövid szabály egy mondatban. **Miért:** miért létezik ez a szabály. Kontextus, incidens, megfigyelés. **Hogyan alkalmazd:** konkrét jelzések arról, mikor érvényes a szabály. ``` A „Miért” nélkül a szabály halott - az ügynök nem fogja átvinni hasonló helyzetekre. A „Hogyan alkalmazd” nélkül nem egyértelmű, mikor kell használni. Egy példa a mappámból: a „kötőjel, ne em dash” szabály. Azért született, mert az em dash `—` a generált szöveg egyik jellegzetes vizuális ismertetőjegye. Minden nyilvánosságnak szánt szövegre érvényes. A fájl helye: `ai-clone/feedback/no-em-dashes.md`. Én egy kicsit másképp csinálom: a szabályokat az `ai-clone/feedback/` mappába írom, nem a `CLAUDE.md` fájlba. A CLAUDE.md projektfájl, a hangnemre és stílusra vonatkozó szabályok viszont személyesek. Ezek velem tartanak a következő projektbe. A `CLAUDE.md` a projekttel marad.
Megjegyzés A megközelítés érettségének egyik mércéje: hetente hányszor mondod az ügynöknek ugyanazzal kapcsolatban, hogy „nem, ne így”? Egy érett rendszerben a válasz nulla. Minden hiba szabállyá válik a `feedback/` mappában, és az ügynök legközelebb nem követi el újra.
## Mik azok az élő mutatók, és miért ne rögzítsük a számokat a fájlokban?
Lényeg A második agy fájljaiban szereplő számok napokon belül elavulnak. A mai „1,000 ügyfélből” holnapra 1,050, egy hónap múlva 2,000 lesz. Ha rögzített számot írsz be, egy hónappal később az ügynök a tegnapi adatok alapján tesz javaslatokat. A megoldás egy LIVE jelölő a fájlban, valamint egy külön `live-metrics.md` dokumentum, amely futtatásra kész SQL-lekérdezéseket tartalmaz. Amikor az ügynök meglátja a LIVE jelölőt, megnyitja az adatbázist, lekéri az aktuális számot, és naprakész adatok alapján következtet.
A második agy létrehozásakor az egyik fő buktató az elavult számokkal való feltöltés. Azt írod, „320 ügyfelünk van”, két héttel később pedig már 410. Azt írod, „a havi bevétel 4.7 millió”, egy hónappal később viszont hiányzik a szám kontextusa: célérték, tényleges adat vagy előrejelzés? A szerző példájában így működik. A `business/products/practicum.md` fájlban egy jelölő szerepel szám helyett: ```markdown ## Cohorts > **LIVE** - futtasd a `live-metrics.md` lekérdezéseit a „Értékesítés” szakaszból, > hogy megtekintsd a kohorszonkénti aktuális fizetéseket. | Kohorsz | Dátumok | Fizető | |-------|------|------------| | 1 | 2026. március 10-12. | LIVE | | 2 | 2026. március 24-26. | LIVE | ``` Egy külön `live-metrics.md` fájl futtatásra kész SQL-lekérdezéseket és leírást tartalmaz arról, hogy mit adnak vissza: ````markdown ## Értékesítés (fizetések kohorszonként) ```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; ``` ```` Amikor megkérdezem az ügynököt, „hány fizetésünk van a második kohorszban?”, az ügynök: 1. Elolvassa a `business/products/practicum.md` fájlt 2. Meglátja a szám melletti LIVE jelölőt 3. Megnyitja a `live-metrics.md` fájlt 4. Megkeresi az „Értékesítés” szakaszt 5. Lefuttatja a lekérdezést az éles adatbázison 6. Friss adatokkal válaszol Ez két problémát old meg egyszerre. A számok nem avulnak el. A döntések pedig az aktuális helyzetre, nem a tavalyi állapotra épülnek.
Figyelem A szerző ismertetett megközelítésében csak megbízható ügynökök férnek hozzá az éles adatbázishoz. Ezt a hozzáférést kizárólag olyan wrapperen keresztül kapják meg, amely naplózza a lekérdezéseket, és nem teszi hozzáférhetővé a jelszavakat. Rossz ötlet a jelszót nyílt szövegként tartalmazó közvetlen `psql` parancsot tenni a `live-metrics.md` fájlba. Készíts olyan wrappert, amely környezeti változóból veszi a jelszót, és nem jeleníti meg a kimenetben. Ez külön műszaki réteg, de nélküle a LIVE biztonsági rést jelent.
## Hogyan tájékozódik az AI a második agyban egyetlen kéréshez?
Lényeg A kérés útvonala mindig ugyanaz: Claude elolvassa a CLAUDE.md fájlt, meglátja a térképeket (`business/INDEX.md`, `ai-clone/INDEX.md`), megnyitja a megfelelő INDEX fájlt, annak útmutatása alapján eljut egy konkrét fájlhoz, és szükség esetén a LIVE segítségével lekéri az aktuális számot. Ez 5-6 olvasási művelet, ahelyett hogy az egész mappát betöltenénk a kontextusba. Az ablak szabad marad a gondolkodáshoz, a tokenek pedig nem mennek irreleváns fájlokra.
Egy konkrét kérés például: „írj e-mailt a résztvevőknek az új kohorszról.” 1. Claude üres ablakkal indul. Betölti a CLAUDE.md fájlt (szabályok, stack, útvonalak). 2. A CLAUDE.md útvonalai között ezt látja: „`ai-clone/INDEX.md` - a munkamenet elején mindig olvasd el.” Megnyitja a fájlt, és megtudja, ki vagyok, milyen a hangnemem, és mely szavakat kerülöm. 3. Az útvonalak között ezt látja: „e-mail-sablonok - `src/lib/email/layout.ts`.” Megnyitja a fájlt, és megérti a formátumot. 4. Ezt látja: „termékkontextus - `business/products/practicum.md`.” Megnyitja a fájlt, és elolvassa a termékről szóló információkat. 5. Meglátja a fájlban a LIVE jelölőt, valamint a `live-metrics.md` hivatkozását. Megnyitja a fájlt, és megkeresi a futtatható SQL-lekérdezést. Ha aktuális számra van szüksége, lefuttatja a lekérdezést. Ha nincs, megjelöli: „ezt a számot küldéskor kérd le”. 6. Megnézi a `ai-clone/style/telegram-format.md` hangnemi szabályait, az `ai-clone/feedback/no-em-dashes.md` em dash-t tiltó szabályát és a `business/marketing/funnel.md` konverziós arányait. Megírja az e-mailt az én hangnememben, friss számokkal, em dash és AI-jelzések nélkül. Az Anthropic mérnöki blogja just-in-time context néven említi ezt a megközelítést:
A 'just in time' megközelítéssel épített ügynökök könnyű azonosítókat (fájlútvonalakat, mentett lekérdezéseket, hivatkozásokat stb.) tartanak meg, és ezek segítségével az eszközökön keresztül, futásidőben dinamikusan húznak adatokat a kontextusba.
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents
Más szóval Claude az adatokra mutató hivatkozásokat viszi magával, nem magukat az adatokat. Ez sokkal takarékosabban bánik a tokenekkel, és sokkal pontosabb is, mert csak a releváns információ kerül a kontextusba. Az ablak tiszta marad a gondolkodáshoz. ## 5 hiba a második agy kialakításában - mit kerülj el?
Lényeg A kezdők leggyakoribb hibái a második agy kialakításakor: 1) a rövid útvonalválasztó helyett 500+ sorosra növesztik a CLAUDE.md-t; 2) a gyűjtőmappa mindent elnyelő lomtárrá válik; 3) megismétlik azt, amit Claude már tud a nyelvből vagy a kódból; 4) rögzítik a számokat, amelyek LIVE nélkül elavulnak; 5) a kontextust elérhetetlenül hagyják vagy nem adnak hozzá útvonalat, akár ugyanabban a tárolóban, akár külön privát tárban van.
1. hiba. **Túlburjánzó CLAUDE.md.** 500 sor utasítás „ahelyett, hogy mindent egy helyre tennél”. Az Anthropic egyértelműen fogalmaz:
Legyen rövid. Minden sornál kérdezd meg: 'Ha ezt törlöm, Claude hibázni kezd?' Ha nem, töröld. A túlzsúfolt CLAUDE.md fájlok miatt Claude figyelmen kívül hagyja a valódi utasításaidat!
— Anthropic, code.claude.com/docs/en/best-practices
A célhossz 80-120 sor. Minden mást tegyél külön fájlokba, és irányítsd oda az ügynököt. 2. hiba. **Gyűjtőmappa mindenféle számára.** Mindent a második agyba dobsz: feldolgozatlan csevegéseket, haszontalan képernyőképeket, senki által el nem olvasott jelentéseket. Egy hónappal később a mappa felduzzadt, az ügynök tokeneket pazarol a kacatok olvasására, te pedig már nem tudod, mi hol van. A szabály: a második agy minden fájlja válaszoljon egy konkrét kérdésre. Ha hat hónapig senki sem nyitotta meg, töröld vagy tedd át az archívumba. 3. hiba. **Ismétlés.** „A fizetések a CloudPaymentsen keresztül mennek, a `src/lib/payment/cloudpayments.ts` fájlban; a szolgáltató beállításai a `.env` fájlban vannak.” Az ügynök mindezt látja a kódban. Ne ismételd meg a `business/` mappában. Az ismétlések elavulnak: megváltozik a kód, a `business/` nem frissül, az ügynök pedig elavult információkból dolgozik. 4. hiba. **Rögzített számok.** „1,247 ügyfelünk van, 6.3%-os konverziós aránnyal” - képzeld el, hogy ezek egy absztrakt fintech startup adatai. Egy hét alatt minden ilyen szám elavul. Használj LIVE jelölőt és `live-metrics.md` fájlt. A témáról szóló rész fentebb olvasható. 5. hiba. **Kontextus elérhető útvonal nélkül.** Ha a második agy máshol van, és az ügynöknek sem jogosultsága, sem hivatkozása nincs hozzá, a kódmappából indulás nem elég. Nem érzékeny megosztott jegyzetekhez a `business/` és `ai-clone/` tárolón belüli tartása kényelmes. A privát kontextust külön szabályozott helyen tartsd, és kifejezetten állítsd be az engedélyezett hozzáférést és útvonalválasztást. A mappák kényelme nem írja felül a bizalmasságot.
Tipp Egy külön ág (`context` vagy `business-context`) a munkát rendezi, de nem hozzáférési határ: a fájljai ugyanazon tároló Git-objektumai maradnak, és ágakkal vagy előzményekkel közzétehetők. Privát üzleti kontextushoz külön privát tárolót vagy külső tárat használj kifejezett hozzáférésvédelemmel és engedélyezett ügynökútvonallal. A submodule külön privát tárolóra mutathat, de a bizalmasság annak jogosultságaiból ered, nem a submodule-ból. Másik lehetőség a tudatosan kizárt helyi mappa saját mentéssel; a kizárás nem távolítja el a már követett fájlokat vagy korábban közzétett előzményeket. A kóddal csak megosztható kontextust tarts.
## Hogyan építs második agyat egy óra alatt - lépésről lépésre
Lényeg Egy óra alatt létrehozhatsz egy minimális második agyat: hozd létre a gyökérben a `business/` és az `ai-clone/` mappát, mindkettőben készíts egy `INDEX.md` térképet, adj rövid termékleírást a `business/products/` mappához, ügyfélleírást az `audience/` mappához, valamint egy leírást arról, ki vagy az `ai-clone/role.md` fájlban. Add hozzá e mappák útvonalait a `CLAUDE.md` fájlhoz. Ezután munka közben bővítsd: minden ügynöki hiba után adj hozzá egy szabályt az `ai-clone/feedback/` mappához; minden döntés után készíts jegyzetet a `business/` mappában.
1. ### Hozz létre két gyökérmappát A projekt gyökerében, az `src/` mellett: ```bash mkdir -p business/{products,audience,goals,economics,marketing} mkdir -p ai-clone/{identity,voice,principles,feedback,style} ``` 2. ### Készíts INDEX.md fájlt mappatérképként A `business/INDEX.md` egy „kérdés → fájl” táblázat. Legalább 5 sorral kezdd, majd bővítsd, ahogy haladsz. Tedd ugyanezt az `ai-clone/INDEX.md` fájllal is. 3. ### Adj rövid leírást a termékről és az ügyfélről A `business/products/main.md` fájlban írd le, mi a termék, kinek szól, mennyibe kerül, és mitől különbözik. 30-50 sor. A `business/audience/avatar.md` fájlban írd le, ki az ügyfél, mik a fájdalompontjai, és mit vásárol. 30-50 sor. Ne ideális ügyfelet írj le - egy valódit mutass be. Ha valamit nem tudsz, jelöld „tisztázandó”-ként, és lépj tovább. 4. ### Írd le magad az ai-clone/role.md fájlban Ki vagy, mivel foglalkozol, és mi fontos neked. 20-30 sor. Ennyi elég a kezdéshez. Adj hozzá hangnemet, alapelveket és kerülendő szavakat, amikor észreveszed, hogy az ügynök a tiédtől eltérő stílusban ír. 5. ### Add hozzá az útvonalakat a CLAUDE.md-hez Nyisd meg a `CLAUDE.md` fájlt, és adj hozzá egy szakaszt: ```markdown ## Projekt térképe - Üzleti kontextus → `business/INDEX.md` - Rólam szóló kontextus → `ai-clone/INDEX.md` - Műszaki tervek → `plans/YYYY-MM-DD-*.md` - Korábbi munkamenetek visszatekintései → `retrospectives/` A munkamenet kezdetén mindig olvasd el az `ai-clone/INDEX.md` és a `business/INDEX.md` fájlt. ``` 6. ### Indítsd el a Claude Code-ot, és ellenőrizd Nyisd meg az ügynököt. Kérdezd meg: „mesélj a termékemről és a közönségemről”. Ha a mappakörnyezet alapján válaszol, működik. Ha kitalál dolgokat, ellenőrizd, hogy a mappák a projekt mellett vannak-e, helyesek-e a fájlnevek, és pontosan vannak-e megadva a CLAUDE.md útvonalai. Ezután a második agy két alapelv szerint növekszik. Először: valahányszor az ügynök hibázik, adj hozzá egy szabályt. 3-4 hét után az `ai-clone/feedback/` 15-20 szabályfájlt tartalmaz majd, az ügynök pedig felhagy a leggyakoribb hibák többségével. Másodszor: minden üzleti döntést jegyezz fel a `business/` mappában. Ha árat emelsz, írj megjegyzést a `business/products/pricing.md` fájlba a dátummal és az indokkal. Ha megváltoztatod a pozicionálást, jegyezd fel a `business/company/about.md` fájlban. Hat hónappal később lesz egy archívumod, amely emlékszik a „miért”-re.
Prompt: Kész prompt a második agy esti frissítéséhez ``` Ezen a héten sok munkát végeztünk együtt. Elemezd az összes heti kódváltoztatást, az összes commitot, amit készítettünk. Milyen értékes információ kerüljön ezekből a business/ mappába - írd be a megfelelő fájlokba, a szomszédos fájlokra mutató wiki linkekkel, hogy a kontextus ne vesszen el. Ha vannak a kódban olyan döntések, amelyeket nem magyaráztam el, kérdezd meg, miért születtek, és jegyezd fel az indokot a megfelelő fájlban, a dátum feltüntetésével. Ne ismételd meg azt, ami már nyilvánvaló a kódból. Csak azt vedd fel, amit az ügynök business/ nélkül nem tudna a következő munkamenetben. ```
## Mi következik - Skills, Subagents és context engineering
Lényeg A második agy és a CLAUDE.md együtt alkotják az alapot. Erre épülnek a Skills (a feladatleírás alapján igény szerint betöltött eljárási tudás), a Subagents (saját kontextusablakkal rendelkező, elszigetelt Claude-példányok nagy feladatokra) és a context engineering (annak kezelése, mi kerül az ablakba). Ez a három felső szint. Alap nélkül nem működnek - az ügynöknek nincs mit olvasnia.
A második agy létrehozása után van még három eszköz, amelyeket az Anthropic a kontextusoptimalizálás három különböző szintjeként mutat be. A **Skills** eljárási tudást jelentenek. Ha van ismétlődő munkafolyamatod (tanulási útmutató írása, Telegram-bejegyzés összeállítása, weboldal auditálása), a feladat leírásával együtt egy `SKILL.md` fájlba kódolhatod. A munkamenet elején Claude átnézi a skillneveket és -leírásokat, majd csak az aktuális feladathoz illőket tölti be. Ez tokeneket takarít meg, és segít a fókusz megtartásában. A **Subagents** saját kontextusablakkal rendelkező, elszigetelt Claude-példányok. Indíts subagentet egy nagy feladatra (olvasson el 30 fájlt, és készítsen összefoglalót); a saját ablakában dolgozik, és csak az eredményt adja vissza. A fő ablakod szabad marad. Az Anthropic ezt írja:
A specializált alügynökök tiszta kontextusablakokban oldhatnak meg célzott feladatokat. [...] Minden alügynök széles körben kutathat, több tízezer vagy akár több token felhasználásával, de csak tömörített, leszűrt munkafoglalatot ad vissza (gyakran 1,000-2,000 tokent).
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents
A **Context engineering** annak kezelése, hogy mi kerüljön egyáltalán az ablakba. Az Anthropic csapata 2025-ben az ügynökökkel való munka egyik alapvető készségének nevezte, amely egy szinttel a prompt engineering fölött áll. A prompt engineering a megfogalmazás megválasztása. A context engineering a fájlok, útvonalak, skillek és subagentek kiválasztása. A második agy a context engineering első építőeleme. Nélküle a Skills üres térben olvasnak, a Subagentsnek nincs hová menniük, az ügynök ablaka pedig véletlenszerű információkkal telik meg. Vele mindhárom eszköz működésbe lép. **Következő lépés.** Hozz létre két mappát a projekt mellett: `business/` és `ai-clone/`. Mindkettőbe tegyél egy 5 soros térképként szolgáló `INDEX.md` fájlt. Adj hozzá négy útvonalat a `CLAUDE.md` fájlhoz. Egy óra alatt működő másodikagy-kereted lesz. Ezután bővítsd azzal a szabállyal, hogy „minden ügynöki hiba után adj hozzá egy sort az `ai-clone/feedback/` mappához”. A teljes CLAUDE.md-sablont, amellyel a második agyhoz irányítod az ügynököt, a [Hogyan állítsd be megfelelően a CLAUDE.md-t](https://ailoot.ai/blog/hu/claude-md-template/) című útmutatóban mutatom be.
### Források - [Claude Code memória-dokumentáció](https://code.claude.com/docs/en/memory) - az Anthropic hivatalos Claude Code memóriaszintjei - [Claude Code: bevált módszerek](https://code.claude.com/docs/en/best-practices) - hivatalos útmutató a CLAUDE.md használatához - [Hatékony context engineering AI-ügynökökhöz](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents) - Anthropic Engineering, ismertető a context rot jelenségéről, a figyelmi keretről és a just-in-time kontextusról - [A Skills bemutatása](https://claude.com/blog/skills-explained) - Anthropic-blog: a Skills, Memory, Subagents és MCP közötti különbség
Fedezd fel tovább az Ailootot itt: [ailoot.ai](https://ailoot.ai/). ## Kérdések és válaszok: Második agy a Claude Code-ban: hogyan építsd fel egy óra alatt ### Az üzleti kontextus másik Git-ágra tétele privátan tartja? Nem. Az ág ugyanannak a tárolónak a része, és fájljai a tároló objektumaival és előzményeivel megoszthatók. Külön szabályozott privát tárat vagy tudatosan kizárt, mentett helyi mappát használj; egy útvonal kizárása nem törli a meglévő követett előzményt. ### Hogyan találja meg az ügynök a kódtáron kívüli privát kontextust? Adj kifejezett hivatkozást és csak a feladathoz szükséges jogosultságokat. Rövid index irányítson a releváns dokumentumhoz, és igazold az engedélyezett fájl olvasását; az útvonalválasztás nélküli privát hely nem ad automatikusan kontextust. ## Ailoot · A vállalat és projektportfóliója Az Ailoot felhalmozott működési tapasztalatra, széles ügyfélkörre, stabil szolgáltatásra és folyamatos KPI-ellenőrzésre épít. A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben. Az Ailoot ezt a működési tapasztalatot használja az ügyfelek termékeiben, ágenseiben, alkalmazásaiban és automatizálásaiban elérhető AI-funkciók API-hozzáféréséhez.