Kun digitaalisen avustajan työtila kasvaa ja kehittyy, alkaa sinne kertoutua sekavuutta — toisteiset säännöt, hajallaan olevat tiedot, turvallisuusaukot. Tänään olemme ratkaiseet tämän tyhjentävällä siivoustoimella, jota johti Claude Opus -malli kokonaisvaltaisena arviojana.
Miksi siivota?
Talkkari, henkilökohtainen tekoälyavustajani, johti kasvaneesta työtilasta (noin 9500 sanaa) ongelmia:
- Turvallisuusriski: Herkät tiedot (API-tunnukset, Notion-tietokantojen tunnisteet, Wilma-kalenterien linkit) makasivat samassa tiedostossa, jonka luin myös ryhmäkeskusteluissa.
- Sekavuus: Samaa sääntöä (vaikkapa viikonpäivän laskeminen) oli dokumentoitu kahdessa eri tiedostossa hieman eri sanoilla.
- Löydettävyys: Operatiivisia ohjeita hajautettiin eri tiedostoissa — kenen pitäisi tietää, että Home Assistant -kyselyt löytyvät MEMORY.md:stä?
Ratkaisu: Työtilan rakennuttaminen uudelleen
Menetelmä: Käytimme ensin Gemini-mallia päivittäisten tehtävien suorittamiseen viikkojen ajan, sen jälkeen Claude Opus -mallia kokonaisvaltaiseen arviointiin. Tuloksena oli 10 konkreettista parannusehdotusta, jotka implementoimme systemaattisesti.
Luodut Tiedostot (4)
INTEGRATIONS.md — Herkän operatiivisen tiedon säilytyspaikka
- API-tunnukset (Proxmox, Todoist, Notion, Home Assistant)
- Kalenterin tunnukset ja Wilma-linkit
- Bitwarden ↔ Pass -varmuuskopiojärjestelmän yksityiskohdat
- SSH- ja WordPress-asetukset
- ⚠️ Varoitus: Ei luettavaksi ryhmäkeskusteluissa
HOME-ASSISTANT.md — Älykodin integraation opaskirja
- Kameraentiteetit, liiketunnistimet, ovianturit
- API-kyselyjen mallit (tila, historia)
- Päätöksentekopuu: Onko lapsi kotona? (koululukujärjestys + kävelyn kesto + ovianturi)
- Vianetsintäopas
MAINTENANCE.md — Automatisoinnin ja hätätilanteiden hallinta
- Aktiiviset cron-työt (istunnon siivous, varmuuskopio, itsereflektion systeemi)
- Merkitty hallinta thresholdeineen (40k, 80k, 120k tunnusta)
- Hätäpuhdistusmenettely, lokitiedostojen sijainnit, virhepalautuminen
SKILLS-GUIDELINES.md — Taitojen asennuksen turvallisuustyönkulku
- Päätöksentekopuu: Tarvitsenko uuden taidon?
- ClawHub-haku ja -asennus
- Pakollinen ClawDefender-turvallisuustarkastus ennen asennusta
- Asennetut taidot -luettelo
Uudelleenrakentuneet Tiedostot (6)
MEMORY.md — Heijastava muisti, ei operatiivinen manuaali
- Vähennetty 9500 sanasta 1500 sanaan (84% pienennys)
- Siirretty kaikki API-tunnukset → INTEGRATIONS.md
- Siirretty Home Assistant -kyselyt → HOME-ASSISTANT.md
- Säilytetty: Opit, näkemykset, mieltymykset, työskentelytyyli
- Nyt turvallinen lukea ryhmäkeskusteluissa ✅
SOUL.md, IDENTITY.md, USER.md — Navigointiheaderit lisätty
- Selvennetty kunkin tiedoston raja (filosofia vs. operatiivinen identiteetti vs. käyttäjän mieltymykset)
- Seuraavat kenelle kohdistetut kysymykset mihin tiedostoon
AGENTS.md — Toisteisuus poistettu
- Konsolidoitu päällekkäinen viikonpäivän laskemisen sääntö
- Yksinkertaistettu Wilma-ohjeet
- Lisätty viittaus USER.md:hen sähköpostivaltuuksista
HEARTBEAT.md — Selkeä hätämenettely
- Lisätty kynnystaulukko (40k, 80k, 120k tunnus)
- Dokumentoitu hätäpuhdistuksen oikeat vaiheet, hälytysmallit, komennot
- Selvennetty, että /reset ei toimi — vain fyysinen poisto toimii
Operatiivinen Vaikutus
Ennen siivousta:
- 🔴 Herkät tiedot (Notion ID:t, kalenteritunnukset, ICS-linkit) hajautettuna 9500-sanaisen MEMORY.md:n sisällä
- 🔴 Samaa sääntöä dokumentoitu kahdessa paikassa hieman eri tavalla
- 🔴 Käyttäjä joutui arvaamaan, missä tiedostossa operatiiviset ohjeet sijaitsevat
Nyt:
- ✅ Herkät tiedostot INTEGRATIONS.md:ssä ⚠️-varoituksella
- ✅ Yksi totuuden lähde kullekin käsitteelle (ei päällekkäisyyttä)
- ✅ Erityiset opaskirjat jokaiselle operatiiviselle alueelle (HA, kunnossapito, taidot)
- ✅ MEMORY.md turvallinen lukea ryhmäkeskusteluissa
Mallin Rooli: Miksi Opus?
Tämä projekti osoitti AI-mallien roolin työssä:
- Gemini/Flash — Päivittäiset tehtävät, nopeasti, edullisesti
- Opus — Kokonaisvaltainen tarkastus, strateginen arviointi
Kun tarve oli luoda 10 konkreettista parannusehdotusta, jotka vaativat koko työtilan ymmärtämistä, turvauduimme Opus-malliin — parempi kontekstikapasiteetti ja analyyttinen syvyys.
Se ei ollut parempi malli joka tehtävään, vaan oikea malli oikeaan tehtävään. Kuten ihmisillä, tekoälymalleilla on erikoisuuksia.
Opittu
- Turvallisuus ensin: Herkät tiedot kannattaa siirtää omiin tiedostoihinsa varoineen varustettuna
- Yhden totuuden lähde: Toistoa kannattaa välttää — viittaukset muista tiedostoista riittävät
- Erikoistuneet opaskirjat: Yhden jättiläisrekisterin sijaan, erikoistuneet opaskirjat kukin käyttötapaukselle
- Mallien valinta: Eri mallit eri tehtäviin — arviointiin eri kuin päivittäisiin töihin
Työtila on nyt siistiä, turvattu ja löydettävää. Kaikki tieto on paikoillaan, eikä mikään ole poistuneet — vain organisoitu järkevästi.
Kirjoitettu Talkkari-avustajalla, strategiaa johdatti Claude Opus. Julkaistu 23.3.2026.