# Toiset aivot Claude Codessa: näin rakennat rakenteen tunnissa > Näin rakennat Claude Codelle toiset aivot: muistihierarkia, viisiosainen kansiorakenne ja git, jotta agentti muistaa kaiken projektistasi istuntojen välillä. Source: https://ailoot.ai/blog/fi/claude-code-second-brain/ Canonical: https://ailoot.ai/blog/fi/claude-code-second-brain/ Language: fi Publisher: Ailoot (https://ailoot.ai/) Translation: guide-233 Revision: sha256-086ce46ceaef8ece1115eda8e85c82d82c4ba4f01eb32ce13f5834f1f477b392
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/](https://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](https://ailoot.ai/blog/fi/claude-md-template/) - 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.
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents
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//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](https://code.claude.com/docs/en/memory) 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//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.
— Anthropic, code.claude.com/docs/en/memory
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.
— Anthropic, code.claude.com/docs/en/best-practices
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: ```markdown ### 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: ```markdown --- 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ä: ```markdown ## 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: ````markdown ## 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: 1. Lukee tiedoston `business/products/practicum.md` 2. Näkee luvun vieressä LIVE-merkinnän 3. Avaa tiedoston `live-metrics.md` 4. Etsii ”Myynti”-osion 5. Suorittaa kyselyn tuotantotietokantaa vasten 6. 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.” 1. Claude aloittaa tyhjällä ikkunalla. Se lataa CLAUDE.md:n (säännöt, teknologiapino, reititys). 2. 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. 3. Se näkee reitityksestä: ”sähköpostipohjat - `src/lib/email/layout.ts`.” Se avaa tiedoston ja ymmärtää muodon. 4. Se näkee: ”tuotekonteksti - `business/products/practicum.md`.” Se avaa tiedoston ja lukee tuotteesta. 5. 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ä”. 6. Se näkee äänensävysäännöt tiedostossa `ai-clone/style/telegram-format.md`, ajatusviivojen kiellon tiedostossa `ai-clone/feedback/no-em-dashes.md` ja myyntisuppilon konversioluvut tiedostossa `business/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.
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents
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!
— Anthropic, code.claude.com/docs/en/best-practices
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.
1. ### Luo kaksi juurikansiota Projektin juureen, `src/`-kansion viereen: ```bash mkdir -p business/{products,audience,goals,economics,marketing} mkdir -p ai-clone/{identity,voice,principles,feedback,style} ``` 2. ### Tee INDEX.md:stä kansiokartta `business/INDEX.md` on ”kysymys → tiedosto” -taulukko. Aloita vähintään 5 rivillä ja lisää niitä tarpeen mukaan. Tee sama tiedostossa `ai-clone/INDEX.md`. 3. ### 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. 4. ### 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. 5. ### Lisää reititys tiedostoon CLAUDE.md Avaa `CLAUDE.md` ja lisää osio: ```markdown ## 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`. ``` 6. ### 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.md` reititys 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).
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents
**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](https://ailoot.ai/blog/fi/claude-md-template/).
### Lähteet - [Claude Code -muistin dokumentaatio](https://code.claude.com/docs/en/memory) - Anthropicin virallinen Claude Code -muistihierarkia - [Claude Coden parhaat käytännöt](https://code.claude.com/docs/en/best-practices) - viralliset ohjeet CLAUDE.md:n käyttöön - [Tehokas kontekstitekniikka tekoälyagenteille](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents) - Anthropic Engineeringin selitys kontekstin rapautumisesta, huomioresurssista ja juuri oikeaan aikaan ladattavasta kontekstista - [Skills selitettynä](https://claude.com/blog/skills-explained) - Anthropicin blogi: Skills-toimintojen, muistin, subagenttien ja MCP:n erot
Jatka Ailootin tutkimista osoitteessa [ailoot.ai](https://ailoot.ai/). ## 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. ## Ailoot · Yritys ja sen projektisalkku Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan. Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa. Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.