elo:tsükkel

Elo EU/Eesti teadmusetöö raam

See skill orkestreerib kõiki kuut Elo skill'i järjest. Iga faas täidab oma EU/Eesti raami kohustusi (jurisdiktsioon, allikahierarhia, andmekaitse, professionaalse ülevaatuse väravad). Tsükkel ise lisab kolm vaheväravat, kus kasutaja saab vastavusotsuse blokeerida.

• Vaikimisi Eesti/EL/EMP kontekst, EUR, A4, Europe/Tallinn ajavöönd, eestikeelne väljund.
• Kui sisend puudutab õigust, makse, auditit, personali, AI-d, infoturvet, tarbijasuhet, meditsiini, hanget või avalikku sektorit, peatu pärast plan faasi kindlasti ja küsi professionaalse ülevaatuse omanikku, ka kui kasutaja valis --auto režiimi.
• Ära kirjuta tsükli ühessegi väljundisse saladusi, paroole, API võtmeid, liigseid isikuandmeid ega aegunud õigus-/maksuväiteid ilma allika ja kuupäevata.
• Kui mõni faas avastab, et lähtematerjal põhineb USA või aegunud eeldusel, peata tsükkel ja teavita kasutajat — see on värava-katkestus, mitte veendu katkestus.

#$ARGUMENTS

Tsükkel

Üks käsk viib kogu Elo töövoo läbi. Sina annad sisendi, mina viin selle läbi kuue faasi ja peatun ainult väravates, kus inimese otsust on päriselt vaja.

Elo — kontekst

See skill on ainus Elo skill, mis kutsub teisi skille välja järjekorras. Iga faas kirjutab oma väljundi tavalisse kohta (plans/, knowledge/), mitte tsükli-spetsiifilisse kausta. Tsükkel ei dubleeri seda, mida brainstorm, plan, veendu, review, work või salvesta juba teevad — ta lihtsalt orkestreerib.

• Teadmistebaas: knowledge/
• Plaanid: plans/
• Referentsid: references/
• Iga faasi täielik kirjeldus: vt vastav skills/{faas}/SKILL.md

Millal kasutada

• Kui kasutaja annab sisendi ja soovib lõpptulemust, mitte vahesammude haldamist: "vii see tsükkel lõpuni", "tee Elo läbi", "võta see ette".
• Kui sama teema kallal on tehtud /elo:brainstorm ja kasutaja ütleb: "jätka edasi tsükli lõpuni".
• Skedulleeritud või automatiseeritud kontekstis, kus 6 käsu järjekorras käivitamine pole praktiline.
• Kui kasutaja on Elo'ga uus ja tahab kogu tsüklit kogemata näha.

Argumendid

Lipp	Mõju
--gates (vaikimisi)	Peatub 3 väravas: pärast plan, pärast review, enne salvesta.
--auto	Kogu tsükkel ilma kasutajaväravata. Kasutab iga faasi Pipeline mode reegleid. Riskantse sisuga sunnib siiski plaani-värava.
--alates=plan	Alusta määratud faasist (kasulik, kui brainstorm on juba tehtud). Lubatud väärtused: brainstorm (vaikimisi), plan, review, work, salvesta.
--kuni=review	Lõpeta määratud faasiga. Sama loend.

Näiteid:

/elo:tsükkel "Q4 müügikampaania B2B SaaS klientidele"
/elo:tsükkel --auto "iganädalane sotsiaalmeedia kalender"
/elo:tsükkel --alates=plan "plans/brainstorm-q4-kampaania.md põhjal"
/elo:tsükkel --kuni=review "tee plaan ja kontrolli üle, töö teen ise"

Protsess

Samm 0: Lahti pakimine

Loe sisendist välja:

1. Teema — mida tsüklis lahendatakse.
2. Režiim — --gates või --auto (kui pole määratud, vali --gates).
3. Alustus- ja lõpufaas — --alates ja --kuni argumentidest või vaikimisi brainstorm → salvesta.
4. Riski-signaalid — sisendis mainitud sõnad: leping, tööleping, palk, isikuandmed, GDPR, AI, audit, käibemaks, KMS, tarbija, hange, alaealine, terviseinfo, infoturve, NIS2, DORA. Iga signaal sunnib plaani-värava ka --auto režiimis.

Kui sisend on liiga lühike (alla 50 tähemärgi ja ühegi olulise märksõnata), küsi:

"Mis teema kallal töötame? Anna 2–3 lauset taustaks ja eesmärgist."

Ära alusta tsüklit ilma sisendita.

Teata kasutajale tsükli plaan enne käivitamist:

## Tsükli plaan

**Teema:** [üks lause]
**Režiim:** [gates | auto]
**Faasid:** [brainstorm → plan → veendu → review → work → salvesta]
**Riski-signaalid:** [loend või "puuduvad"]
**Eeldatavad väravad:** [pärast plan, pärast review, enne salvesta]

Käivitan tsükli. Annan iga faasi lõpus märku.

Samm 1: Käivita brainstorm

Käivita elo:brainstorm koos teemaga. Optimisatsioon: kui keskkond toetab alam-agente, käivita samal ajal paralleelselt taustal:

• elo:research:domain-past-work-researcher (sisend: teema)
• elo:research:domain-knowledge-researcher (sisend: teema märksõnad)

Nende tulemused lisa brainstorm-faasi väljundisse "Tõmba sisse seotud kontekst" sektsiooni alla. See teeb brainstorm'i sümmeetriliseks plaaniga, kus paralleelne uurimine on juba sees.

Brainstorm-faas peab tootma:

• Mida kuulsin (kokkuvõte)
• Teemad, pinged, lüngad
• Plaani kandvad küsimused (kui kandvaid pole, märgi seda)
• Soovitatud suund
• plans/brainstorm-{slug}.md fail

Ära peatu brainstorm'i järel kasutaja-väravaks, kui plaani-kandvaid küsimusi ei tekkinud või kui need lahendati vaikevalikutega. Kui plaani-kandev küsimus tõesti vajab inimese otsust ja --auto ei kehti, küsi kasutajalt korraga 1–3 küsimust ja oota vastust.

Kui sisend tuli viitega plans/brainstorm-*.md failile, jäta see samm vahele ja teata: "Kasutan olemasolevat ajurünnakut: {tee}".

Samm 2: Käivita plan

Käivita elo:plan koos brainstorm'i tulemuse või lähtefailiga. Plaan kasutab kahte uurimisagenti paralleelselt (kui sammus 1 ei käivitatud) ja kirjutab plans/{tüüp}-{slug}.md faili.

Plaan peab sisaldama:

• Vastava tüübi mall (strateegia, kampaania, briif, uurimus, operatsioonid)
• "Eesti/EL vastavus ja riskid" sektsioon, kui riski-signaale on
• Edu mõõdikud allikatega
• Lahtised küsimused
• Viited

Värav 1 — pärast plan (peatu, kui --gates või riski-signaale on)

Vahepeal käivita automaatselt elo:veendu taustal. Kui see annab "Peata X jaoks" soovituse, näita seda kasutajale enne valikute esitamist.

Esita kasutajale plaani kokkuvõte:

## Värav 1: Plaan valmis

**Plaan:** `plans/{tüüp}-{slug}.md`
**Tüüp:** [strateegia | kampaania | briif | uurimus | operatsioonid]
**Riskid:** [loend Eesti/EL vastavuse sektsioonist või "puuduvad"]
**Kindluse kontroll:** [veendu kokkuvõte ühes reas]
**Lahtised küsimused:** [N tk; kõige olulisem: ...]

Valikud:
1. **Jätka tsüklit** (review → work → salvesta)
2. **Muuda plaani** — täpsusta sektsioone
3. **Peatu siin** — kasutaja võtab edasi käsitsi

Oota vastust. Kui kasutaja valib 1, jätka. Kui 2, käivita konkreetne plaani-uuendus ja küsi värava juures uuesti. Kui 3, lõpeta tsükkel ja anna soovitused: "Kui valmid, jätka /elo:review käsuga."

Auto-režiimis: jäta värav vahele ja jätka, välja arvatud kui riski-signaale on — siis küsi alati professionaalse ülevaatuse omanikku enne edasi liikumist. See on EU/Eesti raami nõue, mida --auto ei tühista.

Samm 3: Käivita review

Käivita elo:review plaanifaili vastu. Review kasutab kahte ülevaatajat paralleelselt:

• elo:review:strategic-alignment-reviewer
• elo:review:data-accuracy-reviewer

Review tagastab leiud kujul [P1|P2|P3] + Eesti/EL kasutuskõlblikkuse sektsioon.

Värav 2 — pärast review (peatu, kui P1 leide on või kui --gates)

Esita ülevaatuse kokkuvõte:

## Värav 2: Review tehtud

**P1 (blokeerib):** [N tk]
**P2 (peaks parandama):** [N tk]
**P3 (lihv):** [N tk]
**Eesti/EL:** [korras | täiendamist vajab]

Valikud:
1. **Paranda P1/P2 ja jätka** — uuendan plaani, käivitan review uuesti, siis liigun edasi
2. **Jätka teadlikult** — P1 jääb, töö läheb riskiga edasi
3. **Peatu siin** — kasutaja parandab käsitsi

P1 leiud sunnivad värava ka --auto režiimis. P1 ilma kasutaja teadliku otsuseta ei sõidu kunagi edasi.

Samm 4: Käivita work

Käivita elo:work plaanifaili vastu. Töö täidab plaani partiide kaupa, kirjutab töölogi sama plaanifaili ## Töölogi sektsiooni alla.

Tsükli kontekstis:

• Eelista paralleelseid alam-agente sõltumatutele ülesannetele.
• Iga partii lõpus uuenda kasutajat lühidalt: "Partii 1/3 valmis: X, Y."
• Kui ilmneb blokeerija, mille saab lahendada plaani uuendamisega, käivita Värav 2 uuesti, mitte ära iseseisvalt muuda ulatust.

Töö lõppedes tee täitmise kokkuvõte (vt work SKILL.md Samm 7).

Värav 3 — enne salvesta (peatu alati, kui --gates; auto-režiimis hindamine)

Esita õpitu-mustand:

## Värav 3: Õppetunnid

Tsüklist eraldasin [N] potentsiaalset õppetundi:

1. **[pealkiri]** (tüüp: [insight|playbook|correction|pattern], kindlus: [tase])
   - Õppetund: [üks lause]
   - Miks oluline: [üks lause]
2. ...

Valikud:
1. **Salvesta kõik** — kirjutan `knowledge/` kausta
2. **Salvesta valitult** — sina märgid, mis salvestada
3. **Ära salvesta** — sessioon kinni, teadmised jäävad ainult plaanifaili

Auto-režiimis: rakenda salvesta SKILL.md "Pipeline mode" reegleid — salvesta ainult confidence: high õppetunnid, mis ei sisalda isikuandmeid ega delikaatset infot. Madala kindlusega või vastuoluseid sisaldavad õppetunnid jäävad ootele ja kuvatakse kasutajale järgmise tsükli alguses.

Samm 5: Käivita salvesta

Käivita elo:salvesta kinnitatud õppetundidega. Sammu osana:

• käivitub automaatselt elo:research:stale-knowledge-checker;
• vastuolus kirjeid uuendatakse või arhiveeritakse salvesta SKILL.md reeglite järgi;
• igale uuele kirjele lisatakse täielik EU/Eesti frontmatter (jurisdiction, data_classification, source_type, verified_as_of, retention_review).

Samm 6: Lõpeta tsükkel

Anna kokkuvõte:

## Tsükkel lõpetatud

**Teema:** [...]
**Kestus:** [u. minutid või sammud]
**Loodud failid:**
- `plans/brainstorm-{slug}.md`
- `plans/{tüüp}-{slug}.md`
- `knowledge/{slug-1}.md`
- `knowledge/{slug-2}.md`

**Töölogi koos väljundite asukohtadega:** vt plaanifaili `## Töölogi`.

**Lahtised punktid:**
- [blokeerija või järgmise tsükli teema]

**Soovitatud järgmine tsükkel:**
- /elo:tsükkel "[järgmise teema soovitus]"

Veaolukorrad

Olukord	Käitumine
Sisend on tühi	Küsi 2–3 lause taust enne käivitamist
Faas avastab USA-keskse eelduse	Peatu, teata kasutajale, paku uuesti planeerimist
Faas avastab puuduva ametliku Eesti/EL allika kriitilisele faktile	Lisa lahtisele küsimusele, ära plaani lukusta
Alam-agendid ei tööta	Tee samad otsingud ja kontrollid põhivestluses, märgi "ühe protsessi režiim"
Tsükli keskel kasutaja vastab "stop"	Salvesta kõik kuni-faasini, anna selge järgmise-sammu juhis
Faili kirjutamine ebaõnnestus	Korda üks kord; teisel ebaõnnestumisel peatu ja teata

Olulised reeglid

• Tsükkel orkestreerib, ei dubleeri. Iga faasi loogika elab oma SKILL.md failis.
• Väravad on inimese otsuse jaoks, mitte näitamiseks. Kui pole päris otsust vaja, ära peatu.
• Riski-signaalid sunnivad plaani-värava ka --auto režiimis. EU/Eesti raami ei tühista lipp.
• P1 leid pärast review ei sõidu kunagi --auto režiimis edasi ilma kasutaja teadliku valikuta.
• Iga loodud faili tee teata kohe pärast loomist. Kasutaja peab nägema, kuhu tsükkel midagi kirjutas.
• Ära alusta tsüklit ilma teemata. Ebamäärane sisend toodab ebamäärase plaani, mis ebaõnnestub review faasis. Parem küsi 2–3 lauset.

Pipeline mode

Kui tsükkel käivitub ise pipeline'is (nt skedulleeritud või teise skilli kutsel):

• vaikimisi --auto, kuid riski-signaalid sunnivad ikka plaani-värava;
• P1 leid pärast review jätab tsükli ootele staatusega requires-review ja teavitab kasutajat;
• väljasta lõpus parsitav YAML kokkuvõte: faasid, failid, väravate olek, järgmised soovitatud sammud.

status: completed | gated | failed
phases_completed: [brainstorm, plan, veendu, review, work, salvesta]
files_created:
  - plans/...
  - knowledge/...
gates_triggered: []
risk_signals: []
next_action: "..."