Atrium-Hermes

Memory Flush

Promote important recent log entries into MEMORY.md

Atrium-Hermes 0 Updated 4mo ago
GitHub

Install

npx skillscat add atrium-hermes/atrium-lighthouse/memory-flush

Install via the SkillsCat registry.

SKILL.md

${var} — Topic to focus on. If empty, flushes all recent activity.

If ${var} is set, only flush entries related to that topic.

Read memory/MEMORY.md for current memory state.
Read the last 3 days of memory/logs/ for recent activity.

Steps:

  1. Scan recent logs for entries worth promoting to long-term memory:

    • New lessons learned (errors encountered, workarounds found)
    • Topics covered (articles, digests) — add to the recent articles/digests tables
    • Features built or tools created
    • Important findings from monitors (on-chain, GitHub, papers)
    • Ideas captured that are still relevant
    • Goals completed or progress milestones
  2. Check each candidate against existing MEMORY.md content — skip if already recorded.

  3. Remove stale entries — this is as important as adding new ones:
    a. Open Improvement PRs section: Run gh pr list --state open --search "improve:" --json number,title,url and compare against any "Open Improvement PRs" section in MEMORY.md.

    • If all listed PRs are now merged/closed, remove the section entirely.
    • If some PRs are merged, update the list to reflect only current open ones.
      b. Next Priorities section: Cross-check each listed priority against recent logs and current repo state. Remove priorities that are already done (e.g., "Merge open PRs" if 0 open PRs exist). Add any newly urgent priorities surfaced by recent logs.
      c. Lessons Learned: Remove lessons that are now outdated or resolved (e.g., a workaround for a bug that was later fixed).
      d. Skills Built table: If the table has grown beyond the last 10–15 entries, archive the oldest rows to memory/topics/skills-history.md to keep MEMORY.md under ~50 lines.
  4. Update memory:

    • Add brief entries to MEMORY.md (keep it under ~50 lines as an index)
    • If a topic needs more detail, write to memory/topics/<topic>.md instead
    • Update tables (recent articles, recent digests) with new rows
  5. Do NOT rewrite the whole file — make targeted additions and removals.

  6. Log what you promoted or removed to memory/logs/${today}.md.

If nothing worth promoting or removing, log "MEMORY_FLUSH_OK" and end.

Categories