Evidenssipohjainen työloki: näin dokumentoin työni AI:n kanssa niin, että siihen voi luottaa

Huomio nimistä: Tämä kirjoitus perustuu omaan, oikeaan työhöni. Yritysten ja toimittajien nimet on keksitty, eikä luottamuksellista dataa jaeta. Opit ja menetelmät ovat aitoja ja sellaisenaan käyttökelpoisia.

Useimmat työpäiväkirjat kuolevat kahteen asiaan: kirjoittaminen unohtuu, tai merkinnöistä tulee muistinvaraista fiktiota. Ratkaisin molemmat ongelmat samalla kertaa rakentamalla evidenssipohjaisen työlokin, jota AI auttaa ylläpitämään – mutta tiukoilla säännöillä.

Perusidea: evidenssi ja tulkinta erilleen

Jokainen päiväkohtainen lokimerkintä on markdown-tiedosto, jossa on aina samat osiot:

• Summary – mitä päivänä tehtiin, yhdellä kappaleella
• Evidence – konkreettiset todisteet: repositorio, commit-hashit ja -viestit, sessiokansiot, havaitut tiedostot
• Interpretation – mitä evidenssi todennäköisesti tarkoittaa
• Outcome – mikä muuttui valmiiksi
• Follow-Up – mitä puuttuu, jos evidenssi on vajaata

Tärkein oivallus on Evidence- ja Interpretation-osioiden erottaminen. Commit-viesti Harden catalog sync and WAC initialization on fakta. Se, että "työ keskittyi katalogin luotettavuuteen", on tulkinta. Kun nämä ovat eri osioissa, loki kestää tarkastelun vielä vuoden päästä: tiedän tarkalleen, mikä on varmaa ja mikä päättelyä.

Säännöt AI:lle

Työlokin README määrittelee säännöt, joita AI-avustajan on noudatettava:

1. AI saa luonnostella lokimerkintöjä.
2. AI:n on kysyttävä vahvistus ennen merkinnän finalisointia.
3. Sensitiivinen tieto jätetään pois, ellei sitä erikseen hyväksytä.
4. Evidenssi ja tulkinta pidetään erillään.

Näistä tärkein on kohta 1:n ja 2:n yhdistelmä. AI on erinomainen kaivamaan git-historiasta ja kansiorakenteista sen, mitä oikeasti tapahtui – ja huono tietämään, mitä ei tapahtunut. Ihminen vahvistaa, AI kokoaa.

Takautuva kirjaus: git-historia on jo työlokisi

Aloitin lokin tyhjästä, mutta sain siihen heti seitsemän viikon historian, koska git-historia on jo evidenssipohjainen työloki – se pitää vain jalostaa luettavaksi. Kävin AI:n kanssa läpi projektikansioiden commitit ja sessiokansiot, ja jokaisesta päivästä, jolta löytyi jälkiä, syntyi merkintä.

Kiinnostava erikoistapaus: päivät, joilta löytyi vain sessiokansio ilman artefakteja – esimerkiksi kansio nimeltä 2026-04-20-is-there-a-way-to-get, jonka nimi on katkennut kesken. Houkutus olisi antaa AI:n "täydentää" mitä sinä päivänä luultavasti tehtiin. Sääntöjen ansiosta merkintä toteaa suoraan: aihe epäselvä, evidenssi ei riitä, täydennetään jos materiaalia löytyy. Rehellinen aukko on arvokkaampi kuin uskottava arvaus.

Mitä tästä seuraa käytännössä

Parin kuukauden käytön jälkeen lokista on tullut kolmen asian lähde:

• Viikkokatsaukset syntyvät minuuteissa, koska raakadata on valmiiksi jäsenneltyä.
• Blogi- ja LinkedIn-ideat nousevat suoraan tehdystä työstä – tämä blogi on siitä elävä todiste.
• Keskeneräisen työn muisti: loki erottaa committoidun työn ja aktiivisen mutta committoimattoman työn. Snapshot-merkintä "tässä projektissa on käynnissä olevaa työtä" estää sen yleisen virheen, että keskeneräinen alkaa näyttää valmiilta.

Näin pääset alkuun

1. Luo git-repo, esim. work-ledger, ja siihen kansiot daily/ ja drafts/.
2. Kirjoita README:hen säännöt – erityisesti evidenssin ja tulkinnan erottelu sekä AI:n vahvistusvelvollisuus.
3. Anna AI:lle pääsy projektiesi git-historiaan ja pyydä sitä luonnostelemaan merkinnät takautuvasti.
4. Vahvista jokainen merkintä itse ennen finalisointia.
5. Tee siitä viikoittainen rutiini: commitit sisään, loki ulos.

Työkalut ovat sivuseikka. Periaate – ei väitettä ilman evidenssiä – on se, mikä tekee lokista luotettavan.