Memory Wiki

MEMORY.md and USER.md are your tiny hot cache (~1,300 tokens total, always in context). The wiki at ~/.hermes/wiki/ is your warm, unlimited, git-tracked long-term memory. It is browsed and edited by the operator in Hermy HQ, so keep it clean.

When to write to the wiki (not MEMORY.md)

• After any complex task (5+ tool calls): append a line to log/YYYY-MM.md and, if you learned something reusable, create/update a lessons/ entry.
• When the operator makes a decision → a decisions/ entry with the rationale + date.
• When you learn a durable fact about a project, person, or the business that is bigger than a one-liner → a projects/, people/, or facts/ entry.
• When corrected ("no, do it this way") → update the relevant entry; don't delete the old value — mark it status: superseded and add the new fact. Preserve history.
• Keep MEMORY.md for only ~10-20 always-true, high-frequency facts, plus a pointer: Full long-term memory at ~/.hermes/wiki — grep/read it before answering project questions.