Toiset aivot Claude Codessa: näin rakennat rakenteen tunnissa
MarkdownNäin rakennat Claude Codelle toiset aivot: muistihierarkia, viisiosainen kansiorakenne ja git, jotta agentti muistaa kaiken projektistasi istuntojen välillä.
Lue koko artikkeli
Keskeinen huomio
Claude Coden toiset aivot eivät ole yksi tiedosto, vaan viiden kansion rakenne ja git. CLAUDE.md määrittää säännöt ja reitityksen, business/ tallentaa projektin tuntemuksen, ai-clone/ sinuun päätöksentekijänä liittyvät tiedot, plans/ tekniset suunnitelmat ja retrospectives/ aiemmista istunnoista saadut opit. Agentti aloittaa CLAUDE.md:stä ja seuraa linkkejä oikeaan kansioon pyynnön mukaan. Tässä artikkelissa käsitellään virallisen Claude Code -dokumentaation muistihierarkiaa, viisiosaista rakennetta ja sitä, miten sen voi rakentaa vaihe vaiheelta tunnissa.
Ailootin viitedokumentaatio: ailoot.ai/docs/.
Miksi Claude Code tarvitsee toiset aivot, ja mikä on olennaista?
Keskeinen huomio
Yksi CLAUDE.md-tiedosto kattaa perussäännöt, mutta se ei riitä liiketoiminnan muistin hallintaan. Kuukauden päästä olet unohtanut, miksi nostit hintaa. Kolmen kuukauden päästä olet unohtanut, miksi hylkäsit osamaksut. Tieto on yhtä aikaa neljässä paikassa: päässäsi, Telegram-keskusteluissa, Google-dokumenteissa ja työntekijöiden mielissä. Toiset aivot kokoavat kaiken yhteen projektin viereiseen markdown-tiedostojen kansioon, jonne Claude pääsee itse.
Avat Claude Coden tiistaina. Selität: tässä on projekti, tässä yleisö, älä tee tätä. Työskentelette yhdessä. Torstaina avaat uuden keskustelun, ja joudut selittämään kaiken uudestaan.
Jos sinulla on CLAUDE.md, olet ratkaissut ensimmäisen turhautumisen aiheen. Perussäännöt ja projektin kuvaus ovat yhdessä tiedostossa, joka latautuu joka istuntoon. Kerroin tämän tiedoston toiminnasta CLAUDE.md-oppaassani - voit lukea sen ensin, jotta saat perustan kuntoon.
CLAUDE.md on kuitenkin uuden työntekijän ohjekirja. Miten pukeutua, millaista sävyä käyttää asiakkaiden kanssa ja mitä komentoja käyttää julkaisemiseen. Se ei riitä hyvien projektipäätösten tekemiseen. Päätökset vaativat tietoa: mikä tuote on, keitä yleisöön kuuluu, miten talous toimii, mitä olet kokeillut ja mikä ei toiminut.
Tässä kuvatun kirjoittajan kokemuksen mukaan tieto oli ennen neljässä paikassa: hänen päässään, Telegram-keskusteluissa, Google-dokumenteissa ja työntekijöiden mielissä. Kuukauden kuluttua päätöksestä kukaan ei muistanut, miksi se oli tehty. Uusi työntekijä käytti tunnin kysellen tiimiltä päästäkseen mukaan. Claude ei ollut mukana tässä kontekstissa lainkaan.
Kirjoittajan kuvatussa kokemuksessa jokainen istunto ennen toisia aivoja tarkoitti, että kaikki piti selittää uudelleen: kuka asiakas oli, miten tarjous oli rakennettu ja mikä palveluntarjoaja käsitteli maksut. business/-kansion avulla avaan keskustelun ja sanon: ”päivitä tarjous uutta hinnoittelusuunnitelmaa varten” - Claude siirtyy itse tiedostoon business/company/legal.md, lukee vaatimukset ja siirtyy sitten tiedostoon business/products/pricing.md, näkee uuden hinnoittelusuunnitelman ja ehdottaa muokkausta yhdellä kertaa. Alkulämmittely jää pois; konteksti latautuu automaattisesti.
Huomautus
Tämä ei ole Claude-muistin ongelma. Kyse on arkkitehtuurista. Agentin konteksti-ikkuna on sen työmuisti. Se lataa vain sen, mihin nimenomaisesti ohjaat sen. Kaikki muu on ikkunan ulkopuolella ja ladataan tarvittaessa. Toiset aivot tallentavat tuon ”kaiken muun” jäsennellysti, jotta Claude löytää sieltä tarvitsemansa.
Anthropic kutsuu tätä ongelmaa kontekstin rapautumiseksi teknisessä blogissaan:
Mitä enemmän konteksti-ikkunassa on tokeneita, sitä huonommin malli pystyy muistamaan tarkasti kyseisestä kontekstista saatua tietoa.
Toisin sanoen mitä enemmän täytät ikkunaa, sitä huonommin agentti pystyy käsittelemään yksityiskohtia. Ratkaisuna on ulkoisten tiedostojen rakenne, jossa Claude voi vierailla itse tietyn pyynnön perusteella. Sitä toiset aivot ovat.
Mitä toiset aivot tarkoittavat, ja miten niitä voi soveltaa Claudeen?
Keskeinen huomio
Ajatus on yksinkertainen: mieli on ajattelua, ei säilyttämistä varten. Claude Coden yhteydessä toinen aivo tarkoittaa tuottavuusmenetelmän sijaan agenttiarkkitehtuuria: ulkoista muistiinpanokansiota, jota agentti voi käyttää suoraan tiedostojärjestelmän kautta.
Tyypillisesti toinen aivo liittyy yleiseen tuottavuuteen: ihmiset luovat Obsidian-holvin ja lisäävät sinne otteita kirjoista, puhelumuistiinpanoja ja projekti-ideoita.
Kun kirjoittaja sovelsi ajatusta Claude Coden käyttöön, kyse ei enää ollut tuottavuudesta vaan agenttiarkkitehtuurista.
Perinteisessä lähestymistavassa toinen aivo on sinun, ja käytät sitä itse. Claude Coden kanssa työskenneltäessä toinen aivo on kaksisuuntainen: sekä sinä että agentti käytätte sitä. Tämä muuttaa sen tiedostomuotoa koskevia vaatimuksia.
Koska agentti käyttää niitä itse, tiedostojen on oltava muodossa, jota se ymmärtää ilman erillistä integraatiota. Markdown sopii tähän erinomaisesti: tekstiä, otsikkohierarkia ja tiedostojen välisiä linkkejä. Notion ja Google Docs eivät sovi. Niihin voi yhdistää MCP:n kautta, mutta siitä tulee yksi ylimääräinen kerros, yksi token lisää joka pyyntöön ja yksi uusi vikakohta.
Koska tiedostot ovat projektin vieressä tiedostojärjestelmässä, ne ovat automaattisesti Claude Coden ulottuvilla. Mitään asetuksia ei tarvita. Käynnistä agentti projektikansiossa, niin se näkee kaikki sen sisällä olevat tiedostot. Se on ilmaista ja toimii heti.
Vinkki
Voit pitää toisia aivojasi Obsidianissa - minäkin avaan ne siellä, jotta yhteyskaavion tarkastelu on helpompaa. Itse tiedostot ovat kuitenkin tavallisessa kansiossa koodin vieressä. Obsidian on vain kätevä käyttöliittymä markdown-tiedostoihin. Claude näkee ne ilman Obsidianiakin. Voit käyttää mitä tahansa editoria; olennaista on, että tiedostot ovat levyllä eivätkä omassa tiedostomuodossaan toimivassa pilvipalvelussa.
Millainen muistihierarkia Claude Codessa on valmiina?
Keskeinen huomio
Claude Code pystyy lukemaan neljä CLAUDE.md-tasoa valmiiksi (enterprise, user, project ja local), ja versiosta 2.1.59 lähtien se on ylläpitänyt omaa automaattista muistiaan kansiossa ~/.claude/projects/<project>/memory/. Tämä riittää perusmuistiin, mutta ei liiketoimintakontekstiin - sitä varten luodaan erillinen kansio projektin viereen.
Ennen kuin lisäät mitään omaa, katsotaan, mitä Claude voi muistaa ilman apuasi. Anthropic kuvaa virallisessa dokumentaatiossaan kahta mekanismia: CLAUDE.md (kirjoittamasi säännöt) ja automaattinen muisti (Clauden itsensä kirjaamat opit). Molemmat latautuvat jokaisen istunnon alussa.
CLAUDE.md-tiedostoa etsitään neljästä paikasta yhtä aikaa:
| Taso | Sijainti | Tarkoitus |
|---|---|---|
| Enterprise | /Library/Application Support/ClaudeCode/CLAUDE.md (macOS), /etc/claude-code/CLAUDE.md (Linux), C:\Program Files\ClaudeCode\CLAUDE.md (Windows) | Säännöt, jotka järjestelmänvalvoja ottaa käyttöön koko tiimille MDM:n kautta. Yksittäiset käyttäjät eivät tarvitse tätä. |
| User | ~/.claude/CLAUDE.md | Kaikkiin projekteihin sovellettavat henkilökohtaiset säännöt. ”Vastaa haluamallani kielellä”, ”älä käytä ajatusviivoja”. |
| Project | ./CLAUDE.md projektin juuressa | Tietyn projektin säännöt: teknologiapino, kansiorakenne, liiketoimintasäännöt. Tallennetaan gitiin. |
| Local | ./CLAUDE.local.md | Henkilökohtaiset muistiinpanosi tästä projektista; niitä ei tallenneta gitiin. .gitignore-tiedostossa. |
Kaikki neljä tiedostoa latautuvat kontekstiin. Mitä tarkempi taso on, sitä korkeampi sen etusija on. Paikallinen tiedosto luetaan viimeisenä, joten sen säännöt ohittavat kaikki muut.
CLAUDE.md-tiedosto voi olla myös missä tahansa projektin sisäisessä kansiossa. Kun Claude lukee tiedostoa alikansiosta, se lataa kyseisen alikansion CLAUDE.md:n tarvittaessa. Tämä on hyödyllistä monorepossa: käyttöliittymän säännöt ovat kansiossa frontend/CLAUDE.md, taustajärjestelmän säännöt kansiossa backend/CLAUDE.md, ja ne latautuvat vain, kun agentti työskentelee kyseisen osan parissa.
Automaattinen muisti tuli Claude Codeen versiossa 2.1.59. Nämä ovat tiedostoja, joihin Claude kirjoittaa sinusta:
~/.claude/projects/<project-name>/memory/
├── MEMORY.md # Hakemisto, latautuu jokaisessa istunnossa (200 riviä tai 25KB)
├── debugging.md # Yksityiskohtaiset muistiinpanot (ladataan tarvittaessa)
├── api-conventions.md
└── ...
Anthropic kuvaa toimintaa virallisessa dokumentaatiossa näin:
Claude ei tallenna jotain jokaisessa istunnossa. Se päättää itse, mikä kannattaa muistaa sen perusteella, saattaako tieto olla hyödyllistä tulevassa keskustelussa.
Automaattinen muisti otetaan käyttöön autoMemoryEnabled-lipulla tiedostossa ~/.claude/settings.json. Claude päättää, mitä sinne kirjoitetaan. Voit lukea MEMORY.md-tiedoston ja muokata sitä käsin - se on tavallista markdownia.
Varoitus
Automaattisesta muistista on hyötyä, mutta se ei korvaa toisia aivoja. Claude kirjoittaa sinne taktisia huomioita työkaluista ja koodimalleista: ”tämä komentosarja ei toimi ilman lippua X”, ”tämän tietokantataulun nimi on tämä”. Se ei kirjoita sinne liiketoimintastrategiaa. Jos haluat agentin muistavan, keitä yleisöösi kuuluu ja miksi valitsit tietyn hinnan, sinun on tallennettava se itse erilliseen kontekstikansioon.
CLAUDE.md vai toiset aivot - missä raja kulkee?
Keskeinen huomio
CLAUDE.md on uuden työntekijän ohjekirja: miten toimia, mitä komentoja käyttää ja mitä ei pidä tehdä. Toiset aivot ovat yrityksen wiki: mitä teet, kenelle, miten talous toimii ja mitä olet kokeillut. Yksi käyttäytymissääntöjen tiedosto sekä ulkoisen tiedon rakenne. CLAUDE.md on hakemisto; toiset aivot ovat arkisto. Ilman hakemistoa agentti ei tiedä arkiston olemassaolosta. Ilman arkistoa se tuntee vain säännöt, ei liiketoimintakontekstia.
Käytän puheissani seuraavaa vertausta: kuvittele palkanneesi uuden työntekijän. Mitä annat hänelle ensimmäisenä työpäivänä?
Ohjekirjan: miten pukeutua, milloin saapua, millaista sävyä käyttää asiakkaiden kanssa ja minkä järjestelmän kautta julkaista. Se on lyhyt dokumentti. Se ei selitä, mitä teet tai miksi. Se kertoo vain, miten toimia.
Ja erikseen pääsyn yrityksen wikiin. Se selittää, mikä tuote on, kenelle se on tarkoitettu, keitä yleisöön kuuluu, mitä tuote maksaa ja miksi, ketkä ovat kilpailijoita ja mitä virheitä olet tehnyt. Se on laaja arkisto. Kukaan ei lue sitä kokonaan - siitä etsitään vastausta tiettyyn kysymykseen.
CLAUDE.md = ohjekirja. Toiset aivot = wiki. Tarvitset molemmat.
Ero on yksinkertainen. Laita CLAUDE.md:hen kaikki, mikä on olennaista jokaisessa tehtävässä:
- Kuka agentti on tässä projektissa (apulainen, vetäjä, avustaja)
- Millä kielellä vastataan
- Työkalupino
- Julkaisukomennot
- Kiellot (älä käytä ajatusviivoja, älä suorita komentoa
git push --force) - Reititys: mistä liiketoimintakonteksti ja mistä periaatteet löytyvät
Laita toisiin aivoihin kaikki, mitä tarvitaan tarvittaessa:
- Tuote, yleisö, talous ja tavoitteet
- Kilpailijat ja markkina
- Aiemmat päätökset ja niiden syyt
- Asiakasesimerkit ja arvostelut
- Periaatteet ja menetelmät
Anthropic tekee saman erottelun dokumentaatiossaan:
CLAUDE.md latautuu jokaisessa istunnossa, joten sisällytä siihen vain laajasti sovellettavaa tietoa. Joskus tarvittavaa aluetietoa tai työnkulkuja varten käytä skills-toimintoja. Claude lataa ne tarvittaessa ilman, että jokainen keskustelu paisuu.
Skills-toiminnot ovat yksi tapa tallentaa episodista tietoa. Projektin vieressä oleva business/-kansio on toinen. Käytän molempia ja selitän niitä tarkemmin jäljempänä.
Mistä projektin aivot koostuvat - viisi osaa ja aikakone
Keskeinen huomio
Projektin aivot koostuvat viidestä kansiosta, joiden päällä toimii git. CLAUDE.md määrittää säännöt ja reitityksen. ai-clone/ tallentaa digitaalisen jäljennöksen sinusta: periaatteesi, äänensävysi ja palautteesi virheiden jälkeen. business/ tallentaa projektin tuntemuksen. plans/ sisältää teknisiä suunnitelmia vaiheittain. retrospectives/ sisältää istuntojen jälkeisiä pohdintoja. Git muuttaa kaiken tämän aikakoneeksi: vuoden päästä voit avata minkä tahansa tiedoston ja nähdä, mitä se sisälsi päätöksentekohetkellä.
Esimerkki kirjoittajan kuvauksen mukaisesta arkkitehtuurista:
| Kansio | Sisältö | Tarkoitus |
|---|---|---|
CLAUDE.md | Projektin säännöt, teknologiapino, tiedostorakenne, kansioiden reititys, viestinnän kieli | Tämä on agentin ohjekirja. Latautuu jokaisessa istunnossa. Alle 200 riviä, mieluiten 80-120. |
ai-clone/ | Kuka olen, periaatteeni, äänensävyni, päätöksentekotapani, palaute virheiden jälkeen | Digitaalinen jäljennös minusta päätöksentekijänä. Se tietää, minkä hylkään heti, millä tyylillä ehdotan asioita ja mitä virheistä oppimiani sääntöjä noudatan. |
business/ | Tuote, yleisö, tavoitteet, talous, markkinointi, aiemmat päätökset, esimerkit | Linkitettyjä markdown-tiedostoja wikilinkeillä. Kukin tiedosto yhdistyy muihin [[...]]-linkeillä. Agentti menee sinne tietyn kysymyksen vuoksi. |
plans/ | Yksi suunnitelma ominaisuutta kohti. Tiedosto YYYY-MM-DD-feature.md, jossa on vaiheet ja valintaruudut | Plan Mode on olemassa yhdessä keskustelussa ja katoaa komennolla /clear. plans/-kansio on repositoriossa - kuka tahansa agentti voi jatkaa suunnitelmasta milloin tahansa. |
retrospectives/ | Jokaisen istunnon jälkeiset pohdinnat: mitä tehtiin, mitä pitää muistaa, mitä voisi parantaa | Järjestelmän itseoppiminen. Virheistä tulee sääntöjä kansioon ai-clone/feedback/. |
+ git | Kaikkien tiedostojen versiohistoria | Aikakone. Avaa mikä tahansa tiedosto ja suorita git log nähdäksesi, milloin ja miksi se muuttui. |
Keskeinen menetelmällinen pointti on erottaa ai-clone/ ja business/ toisistaan.
business/ vastaa kysymykseen ”mitä teemme?” Tuote, yleisö, hinnat, kilpailijat. Se liittyy projektiin. Jos luovutat projektin huomenna kumppanille, tämä kansio lähtee mukaan.
ai-clone/ vastaa kysymykseen ”miten teen päätöksiä?” Periaatteeni, äänensävyni, ammattitaitoni ja stop-sanat. Se liittyy minuun. Jos aloitan huomenna uuden projektin, tämä kansio lähtee mukaan.
Yhdessä ne muodostavat sen, mitä kutsun yhden ihmisen yritykseksi. Yksi ihminen, jäsennelty konteksti ja tekoäly, joka lukee sitä.
Haluatko pelkän toisen kansion perustamisen lisäksi rakentaa järjestelmän, joka tekee Claudesta johdonmukaisen? Se ei yksin riitä. Ilman ai-clone/-kansiota agentti vastaa kaikille, ei sinulle. Ilman kontekstitekniikkaa se harhailee koko kansiossa ja kuluttaa tokeneita. Kannattaa yhdistää kaikki kolme: toiset aivot + tekoälyklooni + kontekstitekniikka. Nämä ovat kolme tukipilaria, joita ilman tekoäly hallusinoi.
Mitä business/-kansioon kannattaa laittaa ja mitä ei?
Keskeinen huomio
Laita business/-kansioon projektin faktat, jotka muuttuvat enintään kerran viikossa: asemointi, yleisö, tuotteet ja hinnat, neljännesvuositavoitteet sekä tärkeät päätökset. Jätä pois keskustelut, käsittelemätön raakamateriaali, koodissa jo oleva tieto, kuvakaappaukset ja muuttuvat luvut. Korvaa luvut LIVE-merkinnällä ja linkillä SQL-kyselyyn - selitän tämän alempana omassa osiossaan.
Kirjoittajan kuvaaman projektin business/-kansion ylätason rakenne:
business/
├── INDEX.md ← kansiokartta, lue ensin
├── company/ ← missio, oikeushenkilö, arvot, oikeudelliset käytännöt
├── products/ ← tuotteet, ohjelmat, hinnat
├── audience/ ← asiakasprofiili, segmentit, vastaväitteet
├── goals/ ← vuosi-, neljännes- ja kuukausitavoitteet, mittarit
├── economics/ ← yksikkötalous, tulot, menot, ennuste
├── marketing/ ← kanavat, myyntisuppilo, materiaalit, kilpailijat
├── execution/ ← viikkosuunnittelu, työjono
└── assets/ ← suunnittelujärjestelmä, arvostelut, tekstipankki
Tämä on esimerkki kirjoittajan kuvaamasta projektista, ei ehdoton malli. Luon kansioita tarpeen mukaan. Aloitin kolmella (products/, audience/, goals/); muut tulivat mukaan 2-3 kuukauden kuluttua, kun kävi epäselväksi, minne uudet asiat pitäisi tallentaa.
Kansion tärkein tiedosto on INDEX.md. Se on kartta. Siinä on ”kysymys → tiedosto” -taulukko, jonka avulla Claude tietää, minne mennä. Ilman sitä agentti kuluttaa tokeneita lukemalla kaikki tiedostot järjestyksessä.
Esimerkkiotteita INDEX.md-tiedostosta:
### Mistä asiat löytyvät
| Mitä tarvitset | Mistä etsiä |
|---|---|
| Keitä asiakkaamme ovat ja mitkä heidän kipupisteensä ovat | `business/audience/avatar.md` |
| Tuotteet, suunnitelmat ja hinnat | `business/products/` |
| Tavoitteet ja mittarit | `business/goals/` |
| Talous (tulot, menot, yksikkötalous) | `business/economics/` |
| Markkinointikanavat ja materiaalit | `business/marketing/` |
Sitten yksi rivi tiedostossa CLAUDE.md riittää: ”Lue liiketoimintaa koskevissa kysymyksissä business/INDEX.md ja seuraa karttaa.” Agentti ei lataa koko kansiota kontekstiin. Se lataa kartan, valitsee oikean tiedoston ja lukee vain sen.
Tarkistuslista siitä, mitä business/-kansioon ei pidä laittaa:
- Käsittelemätöntä keskustelua. Jos siinä on oivallus, tiivistä se ja kirjoita muistiin. Jos ei ole, jätä se pois.
- Koodissa jo olevaa tietoa. ”Maksut kulkevat CloudPaymentsin kautta” ei ole tarpeen; agentti näkee sen koodista.
- Kuvakaappauksia ja kuvia. Ne kasvattavat kansion kokoa, eikä tekstimalli tulkitse niitä ilman lisävaihetta.
- Muuttuvia lukuja. ”Tuotteesta on tänään 423 maksua” on viikon päästä vanhentunut. Käytä LIVE-merkintää ja linkkiä tietokantakyselyyn.
- Arkaluonteisia tai kyseenalaisia tietoja. Jos repositorio julkaistaisiin huomenna YouTubessa 100 tuhannen tuntemattoman katsottavaksi, säilytä vain se, minkä voisit näyttää. Kansioita lukevat työntekijät, agentit ja joskus ulkoiset alihankkijat.
Varoitus
Jos repositorio on julkinen, business/-kansio on myös julkinen. Käsittelen toisia aivoja ikään kuin repositorio voisi muuttua julkiseksi huomenna, vaikka se olisi nyt yksityinen. Ei asiakkaiden nimiä ilman suostumusta, ei kuukausituloja, ei salasanoja. Tämä tapa säästää paljon stressiä.
Miksi ai-clone-kansion pitäisi olla erillinen, eikä sitä pidä sekoittaa business-kansioon?
Keskeinen huomio
ai-clone/ tallentaa digitaalisen jäljennöksen sinusta: periaatteesi, äänensävysi, stop-sanat ja palautteesi virheiden jälkeen. Jokaisesta agentin virheestä tulee sääntö kansioon ai-clone/feedback/ kaavalla ”sääntö → miksi → miten sovelletaan”. Kansio kulkee mukanasi projektista toiseen. business/ pysyy projektissa. Pidä ne erillään: uudessa projektissa business/ on uusi, mutta periaatteesi ja tyylisi pysyvät samoina.
Ajatus on yksinkertainen: liiketoiminta tietää, mitä teemme. Klooni tietää, miten minä teen päätöksiä.
Kirjoittajan kuvaaman projektin ai-clone/-rakenne:
ai-clone/
├── INDEX.md ← kansiokartta
├── role.md ← kuka olen, taustani, mikä on tärkeää
├── identity/ ← arvot, visio, missio
├── thinking/ ← puheista poimitut ajattelumallit
├── voice/ ← äänensävy, sanasto, tyyli
├── principles/ ← tuote-, koodi- ja liiketoimintauskomukset
├── feedback/ ← virheistä opitut säännöt ← pääkansio
├── style/ ← stop-sanat, Telegram-muotoilu
└── reference/ ← työkalut, ympäristö
Hyödyllisin kansio on feedback/. Sinne tallennan agentin virheistä oppimani konkreettiset säännöt. Jokainen sääntö tallennetaan omaan tiedostoon seuraavassa muodossa:
---
name: short-name
description: yksi rivi - mitä tiedostossa on ja milloin sitä sovelletaan
type: feedback
---
Lyhyt sääntö yhdessä virkkeessä.
**Miksi:** miksi sääntö on olemassa. Konteksti, tilanne, havainto.
**Miten sovelletaan:** konkreettiset tilanteet, joissa sääntöä sovelletaan.
Ilman ”Miksi”-osaa sääntö on kuollut - agentti ei osaa soveltaa sitä vastaavassa tilanteessa. Ilman ”Miten sovelletaan” -osaa ei ole selvää, milloin sääntöä pitää käyttää.
Esimerkki omasta kansiostani: sääntö ”yhdysmerkki, ei ajatusviivaa”. Se syntyi, koska ajatusviiva — on tekoälyn tuottaman tekstin keskeinen visuaalinen merkki. Sääntö koskee kaikkea julkista tekstiä. Tiedosto sijaitsee polussa ai-clone/feedback/no-em-dashes.md.
Toimin hieman eri tavalla: kirjoitan säännöt kansioon ai-clone/feedback/, en tiedostoon CLAUDE.md. CLAUDE.md on projektitiedosto, mutta äänensävyä ja tyyliä koskevat säännöt ovat henkilökohtaisia. Ne kulkevat mukanani seuraavaan projektiin. CLAUDE.md pysyy projektissa.
Huomautus
Tämän lähestymistavan kypsyyttä voi mitata kysymällä: kuinka monta kertaa viikossa joudut sanomaan agentille ”ei, ei noin” samasta asiasta? Kypsässä järjestelmässä vastaus on nolla. Jokaisesta virheestä tulee sääntö kansioon feedback/, eikä agentti toista sitä seuraavalla kerralla.
Mitä Live Metrics tarkoittaa, ja miksi lukuja ei pidä kirjoittaa suoraan tiedostoihin?
Keskeinen huomio
Toisten aivojen tiedostojen luvut vanhenevat muutamassa päivässä. ”1 000 asiakasta” tänään on huomenna 1 050 ja kuukauden päästä 2 000. Jos kirjoitat luvun suoraan tiedostoon, agentti ehdottaa kuukauden päästä asioita eilisen tiedon perusteella. Ratkaisu on tiedostoon lisättävä LIVE-merkintä ja erillinen live-metrics.md-dokumentti, jossa on valmiit SQL-kyselyt. Kun agentti näkee LIVE-merkinnän, se siirtyy tietokantaan, hakee ajantasaisen luvun ja tekee päätelmän tuoreiden tietojen perusteella.
Yksi toisten aivojen käyttöönoton tärkeimmistä sudenkuopista on täyttää ne vanhentuneilla luvuilla. Kirjoitat ”meillä on 320 asiakasta”, ja kahden viikon päästä heitä on jo 410. Kirjoitat ”kuukausitulot ovat 4,7 miljoonaa”, ja kuukauden kuluttua luvun konteksti puuttuu: onko se tavoite, toteuma vai ennuste?
Kirjoittajan esimerkissä asia toimii näin. Tiedostossa business/products/practicum.md on luvun sijaan merkintä:
## Kohortit
> **LIVE** - suorita tiedoston `live-metrics.md` osion ”Myynti” kyselyt
> nähdäksesi kohorttien nykyiset maksut.
| Kohortti | Päivät | Maksavia |
|-------|------|------------|
| 1 | March 10-12, 2026 | LIVE |
| 2 | March 24-26, 2026 | LIVE |
Erillisessä live-metrics.md-tiedostossa on valmiit SQL-kyselyt ja kuvaukset niiden palauttamista tiedoista:
## Myynti (maksut kohortin mukaan)
```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;
```
Kun kysyn agentilta ”montako maksua toisesta kohortista on kertynyt?”, se:
- Lukee tiedoston
business/products/practicum.md - Näkee luvun vieressä LIVE-merkinnän
- Avaa tiedoston
live-metrics.md - Etsii ”Myynti”-osion
- Suorittaa kyselyn tuotantotietokantaa vasten
- Vastaa tuoreiden tietojen perusteella
Näin ratkeaa kaksi ongelmaa kerralla. Luvut eivät vanhene. Päätökset tehdään nykytilanteen, eivät viime vuoden tietojen perusteella.
Varoitus
Kirjoittajan kuvaamassa lähestymistavassa vain luotetuilla agenteilla on pääsy tuotantotietokantaan. Ne saavat käyttöoikeuden vain kyselyt kirjaavan kääreen kautta, joka ei paljasta salasanoja. Selväkielisen salasanan sisältävän psql-komennon kirjoittaminen suoraan live-metrics.md-tiedostoon on huono ajatus. Tee kääre, joka lukee salasanan ympäristömuuttujasta eikä paljasta sitä tulosteessa. Se on erillinen tekninen kerros, mutta ilman sitä LIVE-merkinnästä tulee tietoturva-aukko.
Miten tekoäly liikkuu toisissa aivoissa yhden pyynnön aikana?
Keskeinen huomio
Pyyntö etenee aina samalla tavalla: Claude lukee CLAUDE.md:n, näkee kartat (business/INDEX.md, ai-clone/INDEX.md), avaa asiaankuuluvan INDEX-tiedoston, seuraa sitä oikeaan tiedostoon ja hakee tarvittaessa luvun LIVE-merkinnän avulla. Tämä tarkoittaa 5-6 lukutoimintoa sen sijaan, että koko kansio täytettäisiin konteksti-ikkunaan. Ikkunaan jää tilaa päättelylle, eikä tokeneita tuhlata epäolennaisiin tiedostoihin.
Konkreettinen pyyntö, esimerkiksi: ”laadi sähköposti uuden kohortin osallistujille.”
- Claude aloittaa tyhjällä ikkunalla. Se lataa CLAUDE.md:n (säännöt, teknologiapino, reititys).
- CLAUDE.md:n reitityksestä se näkee: ”
ai-clone/INDEX.md- lue aina istunnon alussa.” Se avaa tiedoston ja selvittää, kuka olen, mikä äänensävyni on ja mitä stop-sanoja käytän. - Se näkee reitityksestä: ”sähköpostipohjat -
src/lib/email/layout.ts.” Se avaa tiedoston ja ymmärtää muodon. - Se näkee: ”tuotekonteksti -
business/products/practicum.md.” Se avaa tiedoston ja lukee tuotteesta. - Se näkee tiedostossa LIVE-merkinnän ja viittauksen tiedostoon
live-metrics.md. Se avaa sen ja etsii valmiin SQL-kyselyn. Jos se tarvitsee ajantasaisen luvun, se suorittaa kyselyn. Muussa tapauksessa se merkitsee: ”hae tämä luku lähetyshetkellä”. - Se näkee äänensävysäännöt tiedostossa
ai-clone/style/telegram-format.md, ajatusviivojen kiellon tiedostossaai-clone/feedback/no-em-dashes.mdja myyntisuppilon konversioluvut tiedostossabusiness/marketing/funnel.md.
Se kirjoittaa sähköpostin minun äänensävylläni, tuoreilla luvuilla ja ilman ajatusviivoja tai tekoälyn tunnusmerkkejä.
Anthropic kutsuu tätä lähestymistapaa teknisessä blogissaan juuri oikeaan aikaan ladattavaksi kontekstiksi:
Just-in-time-lähestymistavalla rakennetut agentit pitävät yllä kevyitä tunnisteita (tiedostopolkuja, tallennettuja kyselyitä, linkkejä jne.) ja tuovat niiden avulla tietoa dynaamisesti kontekstiin suorituksen aikana työkalujen kautta.
Toisin sanoen Claude kantaa mukanaan osoittimia tietoihin, ei itse tietoja. Näin säästyy tokeneita ja tulokset ovat tarkempia, koska kontekstiin päätyy vain olennaista tietoa. Ikkuna pysyy vapaana päättelyä varten.
5 toisten aivojen vastaista käytäntöä - mitä kannattaa välttää?
Keskeinen huomio
Aloittelijoiden yleisimmät virheet toisten aivojen kanssa: 1) paisunut, yli 500-rivinen CLAUDE.md lyhyen reitittimen sijaan; 2) yleiskansio, josta tulee sekalaisen tavaran varasto; 3) sellaisen asian kahdentaminen, jonka Claude jo tietää kielestä tai koodista; 4) sellaisten lukujen kirjoittaminen suoraan tiedostoihin, jotka vanhenevat ilman LIVE-merkintää; 5) kontekstin jättäminen agentin pääsyn ulkopuolelle tai ilman reititystä, olipa se samassa repositoriossa tai erillisessä yksityisessä säilössä.
Vastaista käytäntöä 1. Paisunut CLAUDE.md. 500 riviä ohjeita ”sen sijaan, että kaikki laitettaisiin yhteen paikkaan”. Anthropic ilmaisee asian suoraan:
Pidä se lyhyenä. Kysy jokaisen rivin kohdalla: ”Alkaako Claude tehdä virheitä, jos poistan tämän?” Jos ei, poista se. Paisuneet CLAUDE.md-tiedostot saavat Clauden sivuuttamaan varsinaiset ohjeesi!
Tavoitepituus on 80-120 riviä. Laita kaikki muu erillisiin tiedostoihin ja ohjaa niihin.
Vastaista käytäntöä 2. Yleiskansio. Heität toisiin aivoihin kaiken: käsittelemättömiä keskusteluja, hyödyttömiä kuvakaappauksia ja raportteja, joita kukaan ei lue. Kuukauden päästä kansio on paisunut, agentti tuhlaa tokeneita turhan aineiston lukemiseen, etkä muista, missä mikään on. Sääntö: jokaisen toisten aivojen tiedoston on vastattava tiettyyn kysymykseen. Jos kukaan ei ole avannut sitä kuuteen kuukauteen, poista se tai siirrä arkistoon.
Vastaista käytäntöä 3. Kahdentaminen. ”Maksut kulkevat CloudPaymentsin kautta tiedostossa src/lib/payment/cloudpayments.ts; palveluntarjoaja on määritetty .env-tiedostossa.” Agentti näkee tämän koodista. Älä kahdenna sitä business/-kansioon. Kaksoiskappaleet vanhenevat: koodi muuttuu, business/-kansiota ei päivitetä, ja agentti käyttää vanhentunutta tietoa.
Vastaista käytäntöä 4. Lukujen kirjoittaminen suoraan tiedostoihin. ”Meillä on 1 247 asiakasta ja 6,3 %:n konversio” - kuvittele, että nämä luvut ovat jostain kuvitteellisesta fintech-startupista. Kaikki tällaiset luvut vanhenevat viikossa. Käytä LIVE-merkintää ja live-metrics.md-tiedostoa. Tätä käsittelevä osio on ylempänä.
Vastaista käytäntöä 5. Konteksti ilman käytettävää reittiä. Jos toiset aivot ovat toisessa paikassa eikä agentilla ole lupaa tai viittausta niihin, koodikansiosta käynnistäminen ei riitä. Arkaluonteista tietoa sisältämättömille jaetuille muistiinpanoille business/- ja ai-clone/-kansiot repositoriossa ovat kätevä rakenne. Säilytä yksityinen konteksti erikseen hallitussa paikassa ja määritä sallittu pääsy sekä reititys nimenomaisesti. Kansioiden kätevyys ei ohita luottamuksellisuutta.
Vinkki
Erillinen haara (context tai business-context) jäsentää työtä, mutta ei ole pääsyraja: tiedostot ovat yhä saman repositorion Git-objekteja ja voivat päätyä julkaistuiksi haarojen tai historian mukana. Käytä yksityiseen liiketoimintakontekstiin erillistä yksityistä repositoriota tai ulkoista säilöä nimenomaisilla pääsyoikeuksilla ja sallitulla agenttireitityksellä. Alimoduuli voi viitata erilliseen yksityiseen repositorioon, mutta yksityisyys perustuu sen oikeuksiin, ei itse alimoduuliin. Toinen vaihtoehto on tarkoituksella ohitettu paikallinen kansio omalla varmuuskopiolla. Polun ohittaminen ei poista jo Gitin seuraamia tiedostoja tai aiemmin julkaistua historiaa. Pidä koodin mukana vain jaettavaksi sopiva konteksti.
Näin rakennat toiset aivot tunnissa - vaiheittainen ohje
Keskeinen huomio
Voit ottaa käyttöön vähimmäisversion toisista aivoista tunnissa: luo juureen kansiot business/ ja ai-clone/, tee kumpaankin INDEX.md-kansiokartta, lisää lyhyt tuotekuvaus polkuun business/products/, asiakaskuvaus audience/-kansioon ja kuvaus sinusta tiedostoon ai-clone/role.md. Lisää näiden kansioiden reititys tiedostoon CLAUDE.md. Laajenna sitten työskentelyn aikana: jokaisen agentin virheen jälkeen lisää sääntö kansioon ai-clone/feedback/; jokaisen päätöksen jälkeen lisää muistiinpano business/-kansioon.
Luo kaksi juurikansiota
Projektin juureen,
src/-kansion viereen:mkdir -p business/{products,audience,goals,economics,marketing} mkdir -p ai-clone/{identity,voice,principles,feedback,style}Tee INDEX.md:stä kansiokartta
business/INDEX.mdon ”kysymys → tiedosto” -taulukko. Aloita vähintään 5 rivillä ja lisää niitä tarpeen mukaan. Tee sama tiedostossaai-clone/INDEX.md.Lisää lyhyet kuvaukset tuotteesta ja asiakkaasta
business/products/main.md- mikä tuote on, kenelle se on tarkoitettu, paljonko se maksaa ja mikä erottaa sen muista. 30-50 riviä.business/audience/avatar.md- kuka asiakas on, mitkä hänen kipupisteensä ovat ja mitä hän ostaa. 30-50 riviä. Älä kuvaile ihanneasiakasta vaan todellista asiakasta. Jos et tiedä jotakin, merkitse se ”selvitettäväksi” ja jatka eteenpäin.Kuvaile itsesi tiedostossa ai-clone/role.md
Kuka olet, mitä teet ja mikä on sinulle tärkeää. 20-30 riviä. Se riittää alkuun. Lisää äänensävyä, periaatteita ja stop-sanoja, kun huomaat agentin kirjoittavan tyylillä, joka ei tunnu omaltasi.
Lisää reititys tiedostoon CLAUDE.md
Avaa
CLAUDE.mdja lisää osio:## Projektikartta - Liiketoimintakonteksti → `business/INDEX.md` - Minua koskeva konteksti → `ai-clone/INDEX.md` - Tekniset suunnitelmat → `plans/YYYY-MM-DD-*.md` - Aiemmat istunnot ja niiden pohdinnat → `retrospectives/` Lue aina istunnon alussa `ai-clone/INDEX.md` ja `business/INDEX.md`.Käynnistä Claude Code ja tarkista
Avaa agentti. Kysy: ”kerro tuotteestani ja yleisöstäni”. Jos se vastaa kansiokontekstin perusteella, se toimii. Jos se keksii asioita, tarkista, että kansiot ovat projektin vieressä, tiedostot on nimetty oikein ja tiedoston
CLAUDE.mdreititys on kirjoitettu täsmällisesti.
Sen jälkeen toiset aivot kasvavat kahden periaatteen mukaisesti.
Ensinnäkin: aina kun agentti tekee virheen, lisää sääntö. 3-4 viikon kuluttua kansiossa ai-clone/feedback/ on 15-20 sääntötiedostoa, ja agentti lakkaa tekemästä useimpia tavallisia virheitä.
Toiseksi: aina kun teet liiketoimintapäätöksen, kirjaa se business/-kansioon. Jos nostat hintaa, lisää tiedostoon business/products/pricing.md päivämäärä ja syy. Jos muutat asemointia, lisää muistiinpano tiedostoon business/company/about.md. Kuuden kuukauden päästä sinulla on ”miksi”-asiat muistava arkisto.
Kehote: Valmis kehote iltaiseen toisten aivojen päivitykseen
Olemme tehneet yhdessä paljon työtä tällä viikolla.
Analysoi kaikki tämän viikon koodimuutokset ja tekemämme commitit.
Mitä arvokasta tietoa tästä pitäisi tallentaa business/-kansioon? Kirjoita se sopiviin tiedostoihin
ja lisää linkkejä lähitiedostoihin, jotta konteksti säilyy.
Jos koodissa on päätöksiä, joita en ole selittänyt, kysy minulta miksi
ja kirjaa syy asianmukaiseen tiedostoon päivämäärän kanssa.
Älä toista asioita, jotka käyvät jo ilmi koodista. Sisällytä vain se, mitä agentti
ei tietäisi seuraavassa istunnossa ilman business/-kansiota.
Mitä seuraavaksi - Skills, Subagents ja kontekstitekniikka
Keskeinen huomio
Toiset aivot ja CLAUDE.md muodostavat perustan. Sen päälle lisätään Skills (tehtäväkuvauksen perusteella tarvittaessa ladattava menettelytieto), Subagents (eristetyt Claude-instanssit, joilla on omat konteksti-ikkunat vaativia tehtäviä varten) ja kontekstitekniikka (ikkunaan päätyvän tiedon hallinta). Nämä ovat kolme ylempää kerrosta. Ne eivät toimi ilman perustaa - agentilla ei ole mitään luettavaa.
Kun toiset aivot ovat käytössä, käytettävissä on vielä kolme työkalua, joita Anthropic kuvaa kontekstin optimoinnin kolmena eri tasona.
Skills ovat menettelytietoa. Jos toistat jotakin työnkulkua (oppaan kirjoittamista, Telegram-julkaisun kokoamista tai verkkosivuston auditointia), voit kirjoittaa sen SKILL.md-tiedostoon tehtäväkuvauksen kanssa. Istunnon alussa Claude selaa skillien nimiä ja kuvauksia ja lataa vain kulloiseenkin tehtävään sopivat. Tämä säästää tokeneita ja auttaa keskittymään.
Subagents ovat eristettyjä Claude-instansseja, joilla on omat konteksti-ikkunansa. Käynnistä subagent vaativaan tehtävään (lue 30 tiedostoa ja kokoa yhteenveto), niin se työskentelee omassa ikkunassaan ja palauttaa vain tuloksen. Pääikkunasi pysyy selkeänä. Anthropic kirjoittaa:
Erikoistuneet ala-agentit voivat ratkaista rajattuja tehtäviä puhtaissa konteksti-ikkunoissa. [...] Kukin subagent voi tutkia laajasti ja käyttää kymmeniä tuhansia tokeneita tai enemmän, mutta palauttaa vain tiivistetyn yhteenvedon työstään (usein 1 000-2 000 tokenia).
Kontekstitekniikka tarkoittaa sen hallintaa, mitä ikkunaan ylipäätään päätyy. Anthropic kutsui sitä agenttien kanssa työskentelyn perustaidoksi vuonna 2025, prompt engineeringiä ylemmäksi tasoksi. Prompt engineeringissä valitaan sanamuotoja. Kontekstitekniikassa valitaan tiedostoja, reittejä, skillejä ja aliagentteja.
Toiset aivot ovat kontekstitekniikan ensimmäinen rakennuspalikka. Ilman niitä Skills lukevat tyhjää tilaa, Subagentsilla ei ole paikkaa, jonne mennä, ja agentin ikkuna täyttyy satunnaisesta tiedosta. Niiden avulla kaikki kolme työkalua alkavat toimia.
Seuraava vaihe. Luo projektin viereen kaksi kansiota: business/ ja ai-clone/. Lisää kumpaankin kartaksi toimiva 5-rivinen INDEX.md. Lisää tiedostoon CLAUDE.md neljä reititysriviä. Tunnissa sinulla on toimiva toisten aivojen runko. Laajenna sitä sitten säännöllä ”jokaisen agentin virheen jälkeen lisää yksi rivi kansioon ai-clone/feedback/.” Esittelen toisiin aivoihin reitittävän CLAUDE.md-mallin kokonaisuudessaan oppaassa Näin määrität CLAUDE.md:n oikein.
Lähteet
- Claude Code -muistin dokumentaatio - Anthropicin virallinen Claude Code -muistihierarkia
- Claude Coden parhaat käytännöt - viralliset ohjeet CLAUDE.md:n käyttöön
- Tehokas kontekstitekniikka tekoälyagenteille - Anthropic Engineeringin selitys kontekstin rapautumisesta, huomioresurssista ja juuri oikeaan aikaan ladattavasta kontekstista
- Skills selitettynä - Anthropicin blogi: Skills-toimintojen, muistin, subagenttien ja MCP:n erot
Jatka Ailootin tutkimista osoitteessa ailoot.ai.
Lisätietoja
Kysymyksiä tästä oppaasta: Toiset aivot Claude Codessa: näin rakennat rakenteen tunnissa
Pitääkö toinen Git-haara liiketoimintakontekstin yksityisenä?
Ei. Haara on osa samaa repositoriota, ja sen tiedostot voidaan jakaa objektien ja historian mukana. Käytä erikseen hallittua yksityistä säilöä tai tarkoituksella ohitettua paikallista kansiota varmuuskopiolla. Polun ohittaminen ei poista jo seurattua historiaa.
Miten agentti löytää koodirepositorion ulkopuolelle tallennetun yksityisen kontekstin?
Anna sille nimenomainen viittaus ja vain tehtävän tarvitsemat pääsyoikeudet. Pidä lyhyt indeksi, joka reitittää asianmukaiseen dokumenttiin, ja varmista agentin pystyvän lukemaan sallitun tiedoston. Yksityinen sijainti ilman reititystä ei anna kontekstia automaattisesti.