Mnemonic Memory

Overview

mnemonic/ is a numbered directory of design notes, decisions, tradeoffs, bug writeups, and reference checkout summaries. It is the project's long-term memory — load-bearing context that survives across conversations. ♫/000 is the index.

This is NOT documentation. It is internal working memory: why decisions were made, what was tried, what broke, what patterns were borrowed from where. A future session reading ♫/042 should be able to reconstruct the reasoning without the original conversation.

Reference notation

Entries are referenced with the ♫/NNN shorthand: ♫/000 is the index, ♫/100 is entry 100. Use it everywhere — prose, code comments, TODOs, other entries. The sigil is notation only; files on disk live at mnemonic/NNN-short-slug.md (♫/000 → mnemonic/000-help.md). Because ♫/ is a single distinctive sigil, grep -rn "♫/" finds every memory reference in the repo, and grep -rn "♫/042" finds every inbound reference to one entry.

When to Use

Proactively create an entry when: