elo:salvesta

Elo EU/Eesti teadmusetöö raam

Salvesta ainult selliseid teadmisi, mida on ohutu ja kasulik hiljem leida. Teadmistebaas ei tohi muutuda isikuandmete, kliendisaladuste või aegunud õigus-/maksuinfo prügikastiks.

• Enne salvestamist minimeeri: eemalda või üldista isikunimed, kliendinimed, lepingusummad, delikaatsed andmed, API võtmed, paroolid ja täpne sisemine info, kui see pole õppetunni mõistmiseks hädavajalik.
• Õigus-, maksu-, töö-, auditi-, infoturbe-, meditsiini- või reguleeritud sektori õppetund vajab allikat, kuupäeva ja märget, et see on töövõte, mitte lõplik nõuanne.
• Lisa frontmatterisse Eesti/EL tööks vajalikud väljad: jurisdiction, data_classification, source_type, verified_as_of, retention_review.
• Kui teadmine põhineb ainult ühel juhtumil või kontrollimata oletusel, kasuta confidence: low või ära salvesta.
• Kui uus teadmine muudab vana, uuenda või märgi vana kirje aegunuks; ära jäta vastuolulisi juhiseid kõrvuti ilma selgituseta.

Salvesta

Sulge õppetsükkel. Erista, mida õppisid, ja salvesta see sinna, kust järgmine töö selle leiab.

Elo — kontekst

See skill on ainus töövoo osa, mis kirjutab uusi teadmisi knowledge/ kausta. Uurivad agendid võivad soovitada, kuid ei kirjuta ega kustuta faile.

Millal kasutada

• Pärast plaani, kampaania, analüüsi või strateegiasessiooni lõpetamist.
• Kui kasutaja ütleb: "salvesta õpitu", "mida peaksime meeles pidama", "salvesta see".
• Pärast andmeparandust, protsessimuudatust või strateegilist avastust.
• Iga sisuka tööpäeva või sessiooni lõpus.

Protsess

Samm 1: Tuvasta õppetunnid

Vaata praegust sessiooni ja otsi salvestamist väärivaid teadmisi:

Tüüp	Signaalid
insight	avastus, üllatav leid, vastuintuitiivne tulemus
playbook	korduv protsess, samm-sammuline võte, mida saab korrata
correction	parandatud vale eeldus, täpsustatud allikas, uuendatud definitsioon
pattern	korduv muster või süsteemne tähelepanek

Eralda maksimaalselt 1-3 õppetundi. Kvaliteet loeb rohkem kui kogus. Kui midagi pole eraldi salvestamist väärt, ütle:

"Sellest sessioonist ei paista eraldi teadmistebaasi õppetundi. Töö ise on plaanis või väljundites juba talletatud."

Iga õppetunni kohta koosta mustand:

**Õppetund:** [üks lause: mida nüüd teame]
**Tüüp:** [insight | playbook | correction | pattern]
**Miks oluline:** [üks lause: kuidas see tulevast tööd muudab]

Samm 2: Küsi kasutaja kinnitust

Näita mustandeid ja küsi:

"Leidsin [N] salvestamist väärt õppetundi. Kas kinnitad?"

Kasutaja võib:

• kinnitada muutmata kujul;
• sõnastust muuta;
• üksikuid õppetunde vahele jätta;
• lisada sinu märkamata õppetunni.

Ära salvesta kinnitamata teadmisi.

Samm 3: Kontrolli duplikaate

Iga kinnitatud õppetunni kohta otsi olemasolevatest teadmistest:

Grep: [võtmefraasid] kaustas knowledge/
Grep: [võtmefraasid] kaustas references/

Kui sarnane õppetund on juba olemas:

• näita olemasolevat kirjet;
• küsi: "Kas uuendan olemasolevat või salvestan uue?";
• uuendamise korral muuda olemasolevat faili.

Samm 3.5: Kontrolli vananenud teadmisi

Pärast salvestatavate teadmiste leidmist käivita kontroll:

• agent: elo:research:stale-knowledge-checker;
• sisend: uued õppetunnid;
• väljund: olemasolevad kirjed, mida uus teadmine võib ümber lükata või asendada.

Kui vastuolud ilmnevad, näita neid kasutajale:

See uus õppetund võib minna vastuollu olemasoleva teadmisega:
- **[olemasolev fail]** ütleb [X], aga uus õppetund ütleb [Y]
- Soovitus: uuenda / eemalda / jäta mõlemad alles

Kas uuendan vana kirje?

<critical_requirement> Agendid tagastavad ainult teksti. Nad ei kirjuta ega kustuta faile. Failide loomine, uuendamine ja eemaldamine on ainult salvesta töövoo vastutus. </critical_requirement>

Samm 4: Salvesta lokaalselt

Kirjuta iga kinnitatud õppetund knowledge/ kausta.

• Failinimi: knowledge/{kirjeldav-slug}.md.
• Kui kausta pole, loo see.

Failivorming:

---
type: [insight | playbook | correction | pattern]
tags: [otsinguks kasulikud märksõnad]
confidence: [high | medium | low]
created: [tänane kuupäev]
source: [lühike kirjeldus, kust teadmine tuli]
domain: elo
jurisdiction: [EE | EU | EEA | other]
data_classification: [public | internal | confidential | personal-data | special-category]
source_type: [session | official-source | internal-doc | user-confirmed]
verified_as_of: [YYYY-MM-DD]
retention_review: [YYYY-MM-DD]
---

# [Õppetunni pealkiri]

[2-4 lauset, mis selgitavad õppetundi nii konkreetselt, et kolme kuu pärast on see endiselt arusaadav.]

## Kontekst

[Mida tegid, kui see teadmine tekkis.]

## Mõju

[Kuidas see peaks tulevast tööd muutma. Ole konkreetne: "Kui teed X, kontrolli alati Y esimesena.".]

Samm 5: Kinnita ja paku järgmised sammud

## Õpitu salvestatud

**Salvestatud:**
- knowledge/{failinimi}.md

**See õppetund ilmub `/elo:plan` töövoos esile, kui tulevane töö puudutab:**
- [märksõnad]

Esita valikud:

1. Käivita /elo:plan — alusta uut tsüklit, kus õppetund leitakse.
2. Jaga ülevaatuseks — anna õppetunnid tiimile kinnitamiseks.
3. Lõpeta — sessioon on valmis.

Olulised reeglid

• 1-3 õppetundi sessiooni kohta. Kui neid on viis, filtreerid liiga vähe.
• Kinnitus on nõutud. Kasutaja otsustab, mis väärib mäletamist.
• Ole konkreetne. "Kasuta õiget andmeallikat" on kasutu; "MRR tuleb dashboardist X, mitte failist Y, mis loeb duplikaate" on kasulik.
• Duplikaadid on müra. Kontrolli enne loomist ja uuenda olemasolevat, kui see on mõistlik.
• Kindlus loeb. Märgi low, kui teadmine põhineb ühel juhtumil; high, kui see on mitmest allikast kinnitatud.
• Tag'id on hilisema leidmise jaoks. Vali sõnad, millega tulevane /elo:plan seda üles leiaks.

Pipeline mode

Automatsioonis:

• salvesta ainult selgelt kasulikud ja madala riskiga õppetunnid;
• kasuta mõistlikke vaikimisi väärtusi;
• kontrolli duplikaate ja konflikte;
• väljasta parsitav kokkuvõte salvestatud failidest.