Julkinen

#8 Blogi Claude Coden muistina


blogi

Tekoälyassistentin hyödyllisyys perustuu suurelta osin siihen, mitä se tietää projektistasi. Ilman kontekstia se vastaa yleisesti — kontekstin kanssa se voi toimia kuin projektin tunteva yhteistyökumppani.

Anthropicin ohjeistus

Anthropic suosittelee kahta mekanismia projektikohtaisen muistin rakentamiseen:

CLAUDE.md on kehittäjän kirjoittama ohjetiedosto projektin juuressa. Se voi sisältää konventioita, kiellettyjä toimintatapoja ja projektikohtaisia huomioita. Anthropicin ohje on pitää se tiiviinä — alle 200 riviä — ja ihmisluettavana.

Automaattinen muisti on Clauden itsensä ylläpitämä muistiinpanojärjestelmä, johon tallentuu käyttäjän preferenssejä, projektin tilaa ja hyödylliseksi havaittuja käytäntöjä. Se täydentää CLAUDE.md:tä tallentamalla sen, mitä kehittäjä ei itse muistanut kirjoittaa.

Nämä kaksi mekanismia ratkaisevat tärkeän ongelman: Claude osaa toistuvissa sessioissa toimia johdonmukaisesti ilman, että samoja asioita tarvitsee selittää uudelleen.

Tämän projektin lähestymistapa

Taskukello-projekti noudattaa Anthropicin ohjeistusta mutta laajentaa sitä yhdellä ratkaisevalla tavalla: blogi toimii koko projektin kehitysdokumentaationa, jota Claude käyttää kontekstinaan.

Projekti koostuu kahdesta rinnakkaisesta osasta: tästä blogista ja itse Taskukello-sovelluksesta. Blogin src/content/blog/-kansion postaukset kuvaavat molempien arkkitehtuuripäätöksiä, valittuja teknologioita ja kehityskäytäntöjä. CLAUDE.md ohjeistaa Claudea grepataan postausten frontmatteria tarvittaessa ja lukemaan relevantteja postauksia ennen kuin se antaa neuvoja tai tekee muutoksia.

Tämä tarkoittaa, että projektin dokumentaatio on samalla Clauden työskentelyohjeistus — ei erillinen tiedosto jonka päivittäminen helposti unohtuu.

Blogi todo-listana

Postausten statusmalli tekee blogista myös tehtävähallinnan välineen:

  • draft — kesken tai vasta suunniteltu tehtävä
  • private — valmis mutta sisäinen kirjaus
  • published — julkinen artikkeli

Käytännön työnkulku: uusi kehitystehtävä kirjataan luonnoksena. Claude lukee sen kontekstina ja auttaa tehtävän toteutuksessa. Kun työ valmistuu, luonnoksesta muotoillaan raportti tehdyistä ratkaisuista ja muutetaan se yksityiseksi tai julkiseksi.

Lopputulos on, että dokumentaatio syntyy osana työtä — ei sen jälkeen.

Mitä tästä seuraa

Kun blogi toimii sekä julkisivuna, kehityspäiväkirjana että tekoälyn kontekstina, kaikki kolme hyötyvät samasta kirjoitustyöstä. Julkinen lukija näkee valmiit ratkaisut. Yksityinen kirjaus säilyttää päätösten taustat. Claude pysyy projektin tasalla ilman erillisiä ohjeistuspäivityksiä.