witcheer's Wingtips #15: a compaction rewrites your history into a working brief

Republished in his own words, with credit.

Back to wingtips

#15 · a compaction rewrites your history into a working brief

· Memory & context · CLI / Desktop / Gateway

Hermes Wingtips #15: a compaction rewrites your history into a working brief

when a long session reaches the compaction point, Hermes doesn't drop the middle turns, it rewrites them into a structured brief with fixed slots:

goal / constraints / progress / key decisions / relevant files / next steps / critical context.

that brief carries the working state forward, and the raw turns stay in state.db where session_search can still reach them.

so a compaction is your agent re-reading its own notes, not losing the thread.

(1) work in the brief's shape: state goals and decisions in plain words, so they map straight into the slots that get kept

(2) for anything that must never drop, put it in MEMORY.md, which reloads on every session no matter how many compactions happen

All tips are written by witcheer and collected here with credit. Card images stay on his X posts.

witcheer says each tip ran on a real Hermes box before it shipped. Hermes changes fast, so check your version and the linked doc.