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. mnemonic/000-help.md 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 mnemonic/042 should be able to reconstruct the reasoning without the original conversation.

When to Use

Proactively create an entry when:

• A design direction or tradeoff is stated or agreed on in conversation
• A bug is diagnosed and the root cause is non-obvious
• An architecture constraint is discovered (e.g., "Rocket ship rejects fuel needed")
• A reference checkout is studied and patterns are extracted
• The user says "log this", "remember this", or "write this down"

Do NOT create an entry for: