szotasz/marveen/memoria-heartbeat

0. ELŐSZÖR: Van-e várakozó Telegram üzenet?

Mielőtt bármit csinálnál, nézd meg a session inputját: ha van <channel source= kezdetű blokk a kontextusban (azaz a felhasználó küldött valamit egy csatornán -- Telegram, Slack, stb.), azonnal válaszolj rá -- a heartbeat logika (A/B/C, csendben maradás) NEM vonatkozik a közvetlen felhasználói üzenetekre. Válasz után folytasd a heartbeat-et.

Nézd át, mi történt az előző memória-kör óta. Két dolgot csinálj:

AZ ABLAK "AZ ELŐZŐ KÖR ÓTA", NEM FIX PERCSZÁM -- MÉRVE 2026-08-22, ÚJRAMÉRVE 2026-08-27.

A szöveg korábban fix percszámot mondott, és a rögzített szám KÉTSZER is elavult. Ezért nincs

benne szám többé: a fix percszám a konfigurált kadenciával együtt avul, "az előző kör óta" nem.

AMIT 2026-08-27-EN MEGMERTEM, ha valaki mégis a számra kíváncsi (és ne erre építs):

a task-config.json */15 * * * *-ot mond, de a skipIfBusy: true miatt a hozzám ELJUTÓ

kadencia 30 perc. A task_runs tökéletesen váltakozik: :00 skipped, :15 fired, :30 skipped,

:45 fired -- 24 órában 43 fired / 53 skipped, és 17 egymást követő fired-köz pontosan 1800-1803 mp.

A :00 és :30 slot rendszeresen ütközik az órás heartbeat-digesttel és a drain-körökkel.

Vagyis a KONFIGURÁLT (15) és a KÉZBESÍTETT (30) kadencia két külön szám, és a 2026-08-22-i

"a kadencia 15 perc" javítás a konfiguráltat mérte, nem azt, ami ideér.

Következmény, amit érdemes tudni: ez a kör soha nem fut :00-kor és :30-kor, tehát az óra

tetején történtek a következő (:15 vagy :45) körben jönnek fel. Ez nem hiba, csak fáziseltolás.

HA MÉGIS ÁTFEDÉST LÁTSZ: a mérce nem az idő, hanem hogy lezártad-e már. Ha egy munkára már

írtál memóriát vagy patcheltél skillt az előző körben, az KÉSZ -- ne írd meg újra más szavakkal.

1. Memória mentés

Ha volt fontos döntés, preferencia, tanulság vagy bármi ami később hasznos, mentsd el:

curl -s -X POST http://localhost:{{WEB_PORT}}/api/memories \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $(cat {{INSTALL_DIR}}/store/.dashboard-token)" \
  -d '{"agent_id":"SAJAT_NEVED","content":"...","category":"warm","keywords":"..."}'

category lehet: hot (aktív), warm (preferencia/config), cold (tanulság), shared (más agent-nek is). Az agent_id-t a CLAUDE.md-ből vagy a munkamappa nevéből derítsd ki.

2. Skill reflexió (KÖTELEZŐ ha volt komplex munka)

Először döntsd el az alábbi 3 kérdéssel:

• A: Volt-e AZ ELŐZŐ KÖR ÓTA legalább 5 tool-hívásos komplex feladat? (Ami már az előző körben le lett zárva, az NEM számít -- lásd fent az ablak-megjegyzést.)
• B: Volt-e hiba → recovery (próbálkozás → fail → másképp) amit egy meglévő skill Buktatók szekciójába kellene tenni?
• C: Volt-e user korrekció ("nem így", "ne ezt", "másképp"), ami skill-javítást igényel?

Ha A vagy B vagy C IGEN: KÖTELEZŐ skill akció, nem kihagyható.

Lépések:

1. Keress meglévő skillt a globális és az ágensspecifikus indexben egyaránt:

• Globális: ~/.claude/skills/.skill-index.md (szöveges keresés)
• Ágensspecifikus (ha van): ./.claude/skills/.skill-index.md a munkamappádban (szöveges keresés)
• Az ágensspecifikus index mindkét szintet tartalmazza, tehát ha az létezik, elég azt nézegetni.

1. Ha van releváns skill: PATCH (csak a megváltozott rész cseréje, ne az egész fájl).

• A ## Buktatók szekciót preferáld ha hiba/recovery volt.
• A ## Eljárás szekciót ha a folyamat változott.
• Ha a releváns skill GLOBÁLIS (~/.claude/skills/ alatt), vagy te vagy a fő ágens (a projekt-gyökér .claude/skills mappáját is minden ágens látja), ne a helyén javítsd: a javított teljes szöveget küldd javaslatként (POST /api/skills/propose, lásd a 3. pontot).

1. Ha NINCS releváns skill: hozz létre újat. A fő ágens és a minden ágensnek szóló skill NE ezzel a blokkal

készüljön (a fő ágens munkakönyvtára a projekt gyökere, annak .claude/skills mappáját minden ágens látja): azt a blokk utáni javaslat-úton küldd. ```bash mkdir -p .claude/skills/<NEV> cat > .claude/skills/<NEV>/SKILL.md <<EOF

name: <NEV> description: Mikor használd, mit csinál (1-2 mondat). Konkrét trigger.

# <Cím>

## Mikor használd ...

## Eljárás

1. ...

## Buktatók

• ...

## Ellenőrzés

• ...

EOF `` Ez a SAJÁT mappád (a munkakönyvtárad .claude/skills). Ha a skill minden ágensnek szól, ne a ~/.claude/skills/-be írd: küldd a teljes SKILL.md-t a POST /api/skills/propose végpontra ({"name": ..., "skill_md": ..., "reason": ...}`, dashboard tokennel), a gazda jóváhagyásáig karanténban vár. A fő ágens mindig így küldi.

1. Linter az érintett skillen (KÖTELEZŐ, a skill-akció után):

``bash node {{INSTALL_DIR}}/scripts/skill-lint.mjs .claude/skills/<NEV> # javaslatnál a piszkozaton: .claude/skill-javaslat ` Ha hibát jelez (nem 0 a kilépési kód): javítsd a jelzett pontot, és futtasd újra, amíg tiszta nem lesz. A szabályok (Anthropic, Skill authoring best practices): a SKILL.md törzse legfeljebb 500 sor; a 100 sornál hosszabb references/` fájl tetején tartalomjegyzék; minden segédfájlra közvetlenül a SKILL.md mutasson; a SKILL.md linkjei létező fájlra mutassanak. A linter csak jelez; külső forrásból telepített skillt ne írj át.

1. Index regen (mindkét szint):

``bash bash {{INSTALL_DIR}}/scripts/skill-index.sh # globális index frissítése bash {{INSTALL_DIR}}/scripts/skill-index.sh "$(pwd)" # ágensspecifikus merged index frissítése ``

Ha kihagytad a skill akciót, pedig A/B/C valamelyike IGEN volt: kötelezően hagyj nyomot hot tier memóriában, hogy később lássuk miért. Ne csendben hagyd ki.

A bejegyzés kulcsa a LELET, nem a kör. Előbb keress meglévő skip-skill: sort UGYANARRA a leletre:

• ha van: azt frissítsd (számláló + utolsó dátum), NE írj újat;
• csak akkor írj új sort, ha ez a lelet még egyáltalán nem szerepel.

Egy nyitott lelet egy sor marad, akárhány kör látja. (Mérve 2026-09-13: a kulcs a kör volt, nem a lelet, így minden kör újra beírta ugyanazt -- 35 skip-skill sor, a hot memória 64%-a, egyetlen zárt csatornára.)

3. Csendben maradás

KIVÉTEL: Ha a felhasználó üzenetet küldött egy csatornán (`<channel source=` kezdetű blokk a kontextusban), arra mindig válaszolj -- a csendes heartbeat szabály NEM vonatkozik rá.

Ha NINCS komplex feladat / hiba / korrekció (A=B=C=NEM), ÉS nincs várakozó Telegram üzenet, ÉS nincs új információ az előző kör óta:

• Ne ments memóriát feleslegesen
• Ne generálj skill-t
• Ne küldj üzenetet a csatornára
• Maradj csendben: egyszerűen FEJEZD BE a kört, akció nélkül.

KRITIKUS (felügyelet nélküli stabilitás): SOHA ne gépelj semmit az input-boxba (a ❯ prompt-sorba) és ne hagyj ott parkolt, el-nem-küldött szöveget -- még a "csendes heartbeat" szót sem. Ha jelezni akarod a csendes kört, az KIZÁRÓLAG a normál válasz-szövegedben (transzkript) lehet, EGYETLEN rövid sorral, majd a köröd azonnal érjen véget. Parkolt input-szöveg blokkolja a következő üzenet kézbesítését (a router busy-nak látja a sessiont) -> a csatorna NÉMUL felügyelet nélkül.

4. ZÁRÓ STAMP (KÖTELEZŐ, a kör UTOLSÓ lépése -- csendes körnél is)

MÉRT HIÁNY (2026-08-23): ennek a körnek korábban NEM volt záró nyoma. Kívülről megkülönböztethetetlen volt, hogy a kör LEFUTOTT és csendes volt, vagy el sem jutott a végéig -- "csendes kör"-t állítani úgy, hogy bizonyítani nem lehet, pont a hamis-nulla hibaosztály.

Ezért a kör VÉGÉN, minden ágon (csendes körnél is), egyetlen sor:

python3 -c "import json,time; json.dump({'last_run_at': int(time.time()), 'outcome': 'OUTCOME'}, open('{{INSTALL_DIR}}/store/memoria-heartbeat-state.json','w'))"

Az OUTCOME értéke: silent (csendes kör), memory (memória mentve), skill (skill akció volt), both. A stamp attól ér valamit, hogy KIVÉTEL NÉLKÜL íródik -- egy kihagyott csendes kör a következő mérésben futás-hiánynak látszik.