Drugi možgani v Claude Code: kako v eni uri zgraditi strukturo

Referenčna dokumentacija Ailoot: ailoot.ai/docs/.

Zakaj Claude Code potrebuje druge možgane in kaj je nujno?#

V torek odprete Claude Code. Pojasnite: to je projekt, to je občinstvo, tega ne počni. Delate skupaj. V četrtek odprete nov klepet in vse morate pojasniti znova.

Če imate datoteko CLAUDE.md, ste odpravili prvo plast frustracij. Osnovna pravila in opis projekta so v eni datoteki, ki se naloži v vsako sejo. Kako ta datoteka deluje, sem pojasnil v svojem vodiču za CLAUDE.md - najprej ga lahko preberete, da vzpostavite temelje.

Toda CLAUDE.md je priročnik za novega zaposlenega. Kako se obleči, kakšen ton uporabljati s strankami, katere ukaze uporabiti za objavo. To ni dovolj za sprejemanje dobrih odločitev o projektu. Za odločitve potrebujete znanje: kaj je izdelek, kdo je občinstvo, kako deluje ekonomika, kaj ste poskusili in kaj ni delovalo.

Po avtorjevih izkušnjah, opisanih tukaj, je bilo to znanje nekoč na štirih mestih: v njegovi glavi, klepetih Telegrama, dokumentih Google in glavah zaposlenih. Mesec po sprejetju odločitve se nihče več ni spomnil, zakaj je bila sprejeta. Nova oseba bi porabila eno uro za vprašanja ekipi, da bi se seznanila s projektom. Claude sploh ni imel dostopa do tega konteksta.

Pred uvedbo drugih možganov je po avtorjevih opisanih izkušnjah vsaka seja pomenila ponovno razlaganje, kdo je stranka, kako je sestavljena ponudba in kateri ponudnik obdeluje plačila. Z mapo business/ odprem klepet in rečem: »Posodobi ponudbo za novi cenovni načrt« - Claude sam poišče business/company/legal.md, prebere zahteve, nato odpre business/products/pricing.md, vidi novi cenovni načrt in v enem koraku predlaga spremembo. Uvodnega pojasnjevanja ni več; kontekst se naloži samodejno.

Anthropic to težavo v svojem inženirskem blogu imenuje kontekstna degradacija:

Z drugimi besedami, več ko natlačite v okno, slabše agent obravnava podrobnosti. Rešitev je ohraniti strukturo zunanjih datotek, ki jih Claude lahko sam poišče glede na konkretno zahtevo. To so drugi možgani.

Kaj so drugi možgani in kako se uporablja ta koncept v Claudu?#

Običajno so drugi možgani namenjeni splošni produktivnosti: ljudje ustvarijo trezor Obsidian ter vanj dodajajo odlomke iz knjig, zapiske s klicev in projektne zamisli.

Ko je avtor to zamisel uporabil pri delu s Claude Code, je prenehala biti vprašanje produktivnosti in postala vprašanje arhitekture agenta.

Pri klasičnem pristopu so drugi možgani vaši in do njih dostopate ročno. Pri delu s Claude Code postanejo dvosmerni: dostopate do njih tako vi kot agent. To spremeni zahteve glede oblike.

Ker agent do njih dostopa sam, morajo biti datoteke v obliki, ki jo razume brez ločene integracije. Markdown je idealen: besedilo, hierarhija naslovov in povezave med datotekami. Notion in Google Dokumenti niso primerni. Povežete jih lahko prek MCP, vendar to doda še eno plast, en žeton na zahtevo in še eno točko odpovedi.

Ker so datoteke v datotečnem sistemu poleg projekta, so samodejno dosegljive Claude Code. Nastavitev ni potrebna. Zaženite agenta v mapi projekta in videl bo vse datoteke v njej. Je brezplačno in deluje takoj.

Kakšno hierarhijo pomnilnika ima Claude Code že vgrajeno?#

Preden dodamo karkoli svojega, poglejmo, česa se Claude lahko spomni brez vaše pomoči. Anthropic v uradni dokumentaciji opisuje dva mehanizma: CLAUDE.md (pravila, ki jih napišete vi) in samodejni pomnilnik (lekcije, ki jih zapiše Claude sam). Oba se naložita na začetku vsake seje.

Datoteka CLAUDE.md se poišče na štirih mestih hkrati:

Vse štiri datoteke se naložijo v kontekst. Bolj kot je raven specifična, višja je njena prednostna stopnja. Lokalna datoteka se prebere zadnja, zato njena pravila preglasijo vsa druga.

Datoteka CLAUDE.md je lahko tudi v katerikoli mapi znotraj projekta. Ko Claude bere datoteko iz podmape, po potrebi naloži CLAUDE.md iz te podmape. To je uporabno v monorepozitoriju: pravila za frontend so v frontend/CLAUDE.md, pravila za backend v backend/CLAUDE.md, naložijo pa se le, ko agent dela na ustreznem delu.

Samodejni pomnilnik se je pojavil v Claude Code 2.1.59. To so datoteke, ki jih Claude piše o vas:

~/.claude/projects/<project-name>/memory/
├── MEMORY.md          # Kazalo, naloži se v vsaki seji (200 vrstic ali 25KB)
├── debugging.md       # Podrobni zapiski (naložijo se na zahtevo)
├── api-conventions.md
└── ...

Anthropic ga v uradni dokumentaciji opisuje takole:

Samodejni pomnilnik je omogočen z zastavico autoMemoryEnabled v ~/.claude/settings.json. Claude odloča, kaj bo zapisal. Datoteko MEMORY.md lahko preberete in uredite ročno - gre za običajno datoteko markdown.

CLAUDE.md ali drugi možgani - kje potegniti mejo?#

Tukaj je primerjava, ki jo uporabljam v svojih predavanjih: predstavljajte si, da ste zaposlili novega sodelavca. Kaj mu daste prvi dan?

Priročnik: kako se obleči, kdaj priti, kakšen ton uporabljati s strankami in prek katerega sistema objavljati. Gre za kratek dokument. Ne pojasnjuje, kaj počnete ali zakaj. Pove le, kako naj se oseba vede.

Poleg tega mu omogočite dostop do internega wikija podjetja. Ta pojasnjuje, kaj je izdelek, komu je namenjen, kdo je občinstvo, kakšna je cena in zakaj, kdo so konkurenti ter katere napake ste naredili. Gre za obsežen arhiv. Nihče ga ne prebere v celoti - vanj greste po odgovor na konkretno vprašanje.

CLAUDE.md = priročnik. Drugi možgani = wiki. Potrebujete oboje.

Razlika je preprosta. Vse, kar je pomembno pri vsaki nalogi, sodi v CLAUDE.md:

• Kdo je agent v tem projektu (pomočnik, vodja, asistent)
• V katerem jeziku naj odgovarja
• Sklad orodij
• Ukazi za objavo
• Prepovedi (ne uporabljaj pomišljajev em, ne izvajaj git push --force)
• Usmerjanje: kam po poslovni kontekst in kam po načela

Vse, kar je potrebno na zahtevo, sodi v druge možgane:

• Izdelek, občinstvo, ekonomika in cilji
• Konkurenti in trg
• Pretekle odločitve in razlogi zanje
• Primeri strank in ocene
• Načela in metodologija

Anthropic v svoji dokumentaciji navaja enako razliko:

Spretnosti so eden od načinov shranjevanja epizodičnega znanja. Mapa business/ poleg projekta je druga možnost. Uporabljam oboje in ju podrobneje opišem v nadaljevanju.

Kaj sestavlja možgane projekta - 5 delov in časovni stroj#

Primer arhitekture iz avtorjevih opisanih izkušenj:

Ključna metodološka točka je ločevanje map ai-clone/ in business/.

business/ odgovarja na vprašanje »kaj počnemo?« Vsebuje izdelek, občinstvo, cene in konkurente. Nanaša se na projekt. Če jutri projekt predate partnerju, gre ta mapa z njim.

ai-clone/ odgovarja na vprašanje »kako sprejemam odločitve?« Vsebuje moja načela, ton, strokovno znanje in prepovedane izraze. Nanaša se name. Če jutri začnem nov projekt, gre ta mapa z menoj.

Skupaj ustvarjata to, čemur pravim podjetje ene osebe. Ena oseba, strukturiran kontekst in umetna inteligenca, ki ta kontekst preberejo.

Želite postaviti še eno mapo in obenem zgraditi sistem, zaradi katerega bo Claude dosleden? To samo po sebi ne zadostuje. Brez mape ai-clone/ agent odgovarja za vsakogar, ne za vas. Brez kontekstnega inženirstva brska po celotni mapi in porablja žetone. Koristno je povezati vse tri stvari: druge možgane + klon UI + kontekstno inženirstvo. To so trije stebri, brez katerih UI halucinira.

Kaj sodi v mapo business/ in kaj ne?#

Struktura najvišje ravni mape business/ v avtorjevem opisanem projektu:

business/
├── INDEX.md              ← zemljevid mape, preberite najprej
├── company/              ← poslanstvo, pravna oseba, vrednote, pravne politike
├── products/             ← izdelki, programi, cene
├── audience/             ← profil stranke, segmenti, ugovori
├── goals/                ← letni, četrtletni in mesečni cilji, metrike
├── economics/            ← ekonomika enote, prihodki, odhodki, napoved
├── marketing/             ← kanali, lijak, gradiva, konkurenti
├── execution/            ← tedensko načrtovanje, seznam opravil
└── assets/               ← oblikovni sistem, ocene, zbirka besedil

To je primer iz avtorjevega opisanega projekta, ne dogma. Mape ustvarjam po potrebi. Začel sem s tremi (products/, audience/, goals/); ostale sem dodal po 2-3 mesecih, ko ni bilo več jasno, kam shraniti nove stvari.

Glavna datoteka mape je INDEX.md. To je zemljevid. Vsebuje tabelo »vprašanje → datoteka«, ki Claudu pomaga razumeti, kam naj gre. Brez nje agent porablja žetone za zaporedno branje vseh datotek.

Primer odlomka iz datoteke INDEX.md:

### Kje najti stvari

| Kaj potrebujete | Kje iskati |
|---|---|
| Kdo je naša stranka in kaj jo pesti | `business/audience/avatar.md` |
| Izdelki, načrti in cene | `business/products/` |
| Cilji in metrike | `business/goals/` |
| Ekonomika (prihodki, odhodki, ekonomika enote) | `business/economics/` |
| Kanali promocije in gradiva | `business/marketing/` |

Nato zadošča ena vrstica v CLAUDE.md: »Pri poslovnih vprašanjih preberi business/INDEX.md in sledi zemljevidu.« Agent ne naloži celotne mape v kontekst. Naloži zemljevid, izbere ustrezno datoteko in prebere samo to.

Kontrolni seznam, česa ne shranjujte v business/:

• Neobdelana korespondenca iz klepetov. Če vsebuje spoznanje, ga izluščite in zapišite. Če ga ne, jo izpustite.
• Informacije, podvojene v kodi. Podatek »Plačila obdeluje CloudPayments« ni potreben; agent ga lahko razbere iz kode.
• Posnetki zaslona in slike. Povečajo velikost mape, besedilni model pa jih brez dodatnega koraka ne razčleni.
• Dinamične številke. »Danes imamo 423 plačil za izdelek« bo čez teden dni zastarelo. Uporabite oznako LIVE in povezavo do poizvedbe v podatkovni zbirki.
• Občutljive ali sporne informacije. Če bi bil repozitorij jutri objavljen na YouTubu pred 100 tisoč neznanci, shranite le tisto, kar bi jim bili pripravljeni pokazati. Mapo berejo zaposleni, agenti in včasih zunanji izvajalci.

Zakaj imeti ločeno mapo ai-clone in zakaj je ne bi smeli mešati s poslovno vsebino?#

Ideja je preprosta: podjetje ve, kaj počnemo. Klon ve, kako sprejemam odločitve.

Struktura mape ai-clone/ v avtorjevem opisanem projektu:

ai-clone/
├── INDEX.md           ← zemljevid mape
├── role.md            ← kdo sem, moje ozadje, kaj mi je pomembno
├── identity/          ← vrednote, vizija, poslanstvo
├── thinking/          ← miselni modeli iz predavanj
├── voice/             ← ton, besedišče, slog
├── principles/        ← prepričanja o izdelku, kodi, poslovanju
├── feedback/          ← pravila, naučena iz napak ← glavna mapa
├── style/             ← prepovedani izrazi, oblika za Telegram
└── reference/         ← orodja, okolje

Najuporabnejša mapa je feedback/. V njej so konkretna pravila, ki sem se jih naučil iz napak agentov. Vsako pravilo shranim v ločeno datoteko v tej obliki:

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

Kratko pravilo v enem stavku.

**Zakaj:** zakaj to pravilo obstaja. Kontekst, incident, opažanje.

**Kako uporabiti:** konkretni pogoji, ob katerih velja pravilo.

Brez polja Why je pravilo mrtvo - agent ga ne bo prenesel v podobno situacijo. Brez polja How to apply ni jasno, kdaj uporabiti pravilo.

Primer iz moje mape: pravilo »vezaj, ne pomišljaj em«. Nastalo je zato, ker je pomišljaj em — prepoznaven vizualni znak ustvarjenega besedila. Velja za vsa javna besedila. Datoteka je ai-clone/feedback/no-em-dashes.md.

Sam ravnam nekoliko drugače: pravila pišem v ai-clone/feedback/, ne v CLAUDE.md. CLAUDE.md je projektna datoteka, pravila o tonu in slogu pa so osebna. Z menoj gredo v naslednji projekt. CLAUDE.md ostane pri projektu.

Kaj so metrike v živo in zakaj številk ne zapisati neposredno v datoteke?#

Ena glavnih pasti pri vzpostavljanju drugih možganov je polnjenje z zastarelimi številkami. Zapišete »imamo 320 strank«, dva tedna pozneje pa jih je že 410. Zapišete »mesečni prihodek je 4.7 milijona«, mesec pozneje pa številki manjka kontekst: ali gre za cilj, dejanski podatek ali napoved?

V avtorjevem primeru to deluje takole. V datoteki business/products/practicum.md je namesto številke oznaka:

## Skupine

> **LIVE** - za ogled trenutnih plačil po skupinah zaženite poizvedbe v `live-metrics.md`, razdelek »Prodaja«.

| Skupina | Datumi | Plačniki |
|-------|------|------------|
| 1 | 10.-12. marec 2026 | LIVE |
| 2 | 24.-26. marec 2026 | LIVE |

Ločena datoteka live-metrics.md vsebuje pripravljene poizvedbe SQL in opise njihovih rezultatov:

## Prodaja (plačila po skupinah)

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

Ko agenta vprašam: »Koliko plačil imamo za drugo skupino?«, ta:

1. Prebere business/products/practicum.md
2. Opazi oznako LIVE ob številki
3. Odpre live-metrics.md
4. Poišče razdelek »Prodaja«
5. Zažene poizvedbo v produkcijski podatkovni zbirki
6. Odgovori z uporabo svežih podatkov

S tem reši dve težavi hkrati. Številke ne zastarajo. Odločitve pa temeljijo na trenutnem stanju, ne na lanskem.

Kako se UI za posamezno zahtevo znajde v drugih možganih?#

Konkretna zahteva, na primer: »Pripravi e-pošto za udeležence o novi skupini.«

1. Claude začne s praznim oknom. Naloži CLAUDE.md (pravila, sklad tehnologij, usmeritve).
2. Iz usmeritev v CLAUDE.md razbere: »ai-clone/INDEX.md - vedno preberi na začetku seje.« Odpre datoteko in izve, kdo sem, kakšen je moj ton in katere izraze uporabljam kot prepovedane.
3. V usmeritvah vidi: »Predloge za e-pošto - src/lib/email/layout.ts.« Odpre datoteko in razume obliko.
4. Vidi: »Kontekst izdelka - business/products/practicum.md.« Odpre datoteko in prebere informacije o izdelku.
5. V datoteki opazi oznako LIVE in sklic na live-metrics.md. Odpre datoteko in poišče pripravljene poizvedbe SQL. Če potrebuje trenutno številko, zažene poizvedbo. Če je ne potrebuje, označi »pridobi to številko ob pošiljanju«.
6. Vidi pravila o tonu v ai-clone/style/telegram-format.md, prepoved pomišljajev em v ai-clone/feedback/no-em-dashes.md in stopnje konverzije lijaka v business/marketing/funnel.md.

Napiše e-pošto v mojem tonu, s svežimi številkami ter brez pomišljajev em ali znakov umetne inteligence.

Anthropic ta pristop v svojem inženirskem blogu imenuje kontekst »just-in-time«:

Z drugimi besedami, Claude nosi kazalce do podatkov, ne pa samih podatkov. To je veliko učinkoviteje z vidika žetonov in veliko natančneje, saj se v kontekstu znajdejo le pomembne informacije. Okno ostane prosto za sklepanje.

5 antipatternov drugih možganov - čemu se izogniti?#

Antipattern 1. Preobsežna datoteka CLAUDE.md. 500 vrstic navodil »namesto da bi vse dali na eno mesto«. Anthropic je jasen:

Ciljna dolžina je 80-120 vrstic. Vse drugo shranite v ločene datoteke in dodajte usmeritve do njih.

Antipattern 2. Mapa za vse. V druge možgane odlagate vse: neobdelano korespondenco iz klepetov, neuporabne posnetke zaslona in poročila, ki jih nihče ne bo prebral. Čez mesec je mapa preobsežna, agent zapravlja žetone za branje nesmiselne vsebine, vi pa se ne spomnite več, kje je kaj. Pravilo: vsaka datoteka v drugih možganih mora odgovarjati na konkretno vprašanje. Če je nihče ni odprl šest mesecev, jo izbrišite ali premaknite v arhiv.

Antipattern 3. Podvajanje. »Plačila obdeluje CloudPayments v src/lib/payment/cloudpayments.ts; ponudnik je nastavljen v .env.« Agent vse to vidi v kodi. Tega ne podvajajte v business/. Podvojene informacije zastarajo: koda se spremeni, mapa business/ pa se ne posodobi, zato agent dela na podlagi zastarelih informacij.

Antipattern 4. Neposredno zapisane številke. »Imamo 1,247 strank in 6.3% konverzijo« - predstavljajte si, da so te številke iz nekega abstraktnega finančnotehnološkega zagonskega podjetja. Vse bodo v enem tednu zastarele. Uporabite oznako LIVE in live-metrics.md. Razdelek o tem je zgoraj.

Antipattern 5. Kontekst brez dostopne poti. Če so drugi možgani drugje in agent nima dovoljenja ali povezave do njih, zagon v mapi s kodo ne zadošča. Za neobčutljive skupne zapiske je priročno hraniti business/ in ai-clone/ v repozitoriju. Zasebni kontekst hranite na ločeno nadzorovanem mestu ter izrecno nastavite dovoljeni dostop in usmerjanje. Priročna razporeditev map ne prevlada nad zaupnostjo.

Kako v eni uri zgraditi druge možgane - postopek po korakih#

1. Ustvarite dve korenski mapi

   V korenski mapi projekta, poleg src/:

   mkdir -p business/{products,audience,goals,economics,marketing}
   mkdir -p ai-clone/{identity,voice,principles,feedback,style}
   

2. Ustvarite datoteko INDEX.md kot zemljevid map

   business/INDEX.md je tabela »vprašanje → datoteka«. Začnite z vsaj 5 vrsticami in jih dodajajte sproti. Enako naredite v ai-clone/INDEX.md.

3. Dodajte kratka opisa izdelka in stranke

   business/products/main.md - kaj je izdelek, komu je namenjen, koliko stane in po čem se razlikuje. 30-50 vrstic. business/audience/avatar.md - kdo je stranka, kaj jo pesti in kaj kupuje. 30-50 vrstic. Ne opisujte idealne stranke - opišite resnično. Če česa ne veste, označite »treba razjasniti« in nadaljujte.

4. Opišite se v ai-clone/role.md

   Kdo ste, kaj počnete in kaj vam je pomembno. 20-30 vrstic. Za začetek je to dovolj. Ton, načela in prepovedane izraze dodajte, ko opazite, da agent piše v slogu, ki ni vaš.

5. Dodajte usmeritve v CLAUDE.md

   Odprite CLAUDE.md in dodajte razdelek:

   ## Zemljevid projekta
   
   - Poslovni kontekst → `business/INDEX.md`
   - Kontekst o meni → `ai-clone/INDEX.md`
   - Tehnični načrti → `plans/YYYY-MM-DD-*.md`
   - Razmisleki o preteklih sejah → `retrospectives/`
   
   Na začetku seje vedno preberite `ai-clone/INDEX.md` in `business/INDEX.md`.
   

6. Zaženite Claude Code in preverite

   Odprite agenta. Vprašajte: »Povej mi o mojem izdelku in občinstvu.« Če odgovori na podlagi konteksta v mapi, deluje. Če si stvari izmišlja, preverite, ali so mape poleg projekta, ali so datoteke pravilno poimenovane in ali so usmeritve v CLAUDE.md jasno zapisane.

Nato drugi možgani rastejo po dveh načelih.

Prvič: vsakič, ko agent naredi napako, dodajte pravilo. Po 3-4 tednih bo mapa ai-clone/feedback/ vsebovala 15-20 datotek s pravili in agent bo prenehal delati večino pogostih napak.

Drugič: vsakič, ko sprejmete poslovno odločitev, jo zabeležite v business/. Če zvišate ceno, v business/products/pricing.md dodajte opombo z datumom in razlogom. Če spremenite pozicioniranje, dodajte opombo v business/company/about.md. Čez šest mesecev boste imeli arhiv, ki si zapomni »zakaj«.

Ta teden smo skupaj opravili precej dela.

Analiziraj vse spremembe kode in vse potrditve, ki smo jih ta teden naredili.
Katere koristne informacije iz tega sodijo v mapo business/? Zapiši jih v ustrezne datoteke
in dodaj povezave wiki do sosednjih datotek, da se kontekst ne izgubi.

Če so v kodi odločitve, ki jih nisem pojasnil, me vprašaj zakaj
in zabeleži razlog v ustrezni datoteki z navedenim datumom.

Ne podvajaj tega, kar je že očitno iz kode. Vključi samo tisto, česar agent
v naslednji seji brez mape business/ ne bi vedel.

Kaj sledi - spretnosti, podagenti in kontekstno inženirstvo#

Ko so drugi možgani vzpostavljeni, so na voljo še tri orodja, ki jih Anthropic opisuje kot tri različne ravni optimizacije konteksta.

Spretnosti so postopkovno znanje. Če ponavljate določen potek dela (pisanje učnega vodiča, priprava objave za Telegram, pregled spletnega mesta), ga lahko zapišete v datoteko SKILL.md z opisom naloge. Na začetku seje Claude pregleda imena in opise spretnosti ter naloži samo tiste, ki ustrezajo trenutni nalogi. To prihrani žetone in pomaga ohraniti osredotočenost.

Podagenti so izolirani primerki Claude z lastnimi kontekstnimi okni. Zaženite podagenta za zahtevno nalogo (preberi 30 datotek in pripravi povzetek); delal bo v svojem oknu in vrnil samo rezultat. Glavno okno ostane prosto. Anthropic piše:

Kontekstno inženirstvo je upravljanje tega, kaj sploh pride v okno. Ekipa Anthropic je leta 2025 to označila za temeljno veščino pri delu z agenti, za eno raven nad inženirstvom pozivov. Inženirstvo pozivov pomeni izbiro ubeseditve. Kontekstno inženirstvo pomeni izbiro datotek, usmeritev, spretnosti in podagentov.

Drugi možgani so prvi gradnik kontekstnega inženirstva. Brez njih spretnosti berejo praznino, podagenti nimajo kam iti, agentovo okno pa se polni z naključnimi informacijami. Z njimi vsa tri orodja začnejo delovati.

Naslednji korak. Poleg projekta ustvarite dve mapi: business/ in ai-clone/. V vsako dodajte INDEX.md s 5 vrsticami, ki služijo kot zemljevid. V CLAUDE.md dodajte štiri vrstice z usmeritvami. V eni uri boste imeli delujoč okvir drugih možganov. Nato ga nadgrajujte po pravilu »po vsaki napaki agenta dodaj eno vrstico v ai-clone/feedback/«. Celotno predlogo CLAUDE.md za usmerjanje do drugih možganov pojasnjujem v vodiču Kako pravilno nastaviti CLAUDE.md.

Nadaljujte z raziskovanjem Ailoot na ailoot.ai.