typmem-learn

Capture one durable fact as a recipe card under ~/.typmem/memory/learnings/. A learning is what you now know about the world — useful to anyone, indefinitely, even someone who never saw the painful session that produced it. A learning is valid and usable the moment you capture it — it does not wait for any review. typmem-judge later tidies learnings and may propose that the strongest ones be promoted to precedents/ or rules.md, but that is optional and non-blocking.

Learning vs retro — read this first

• Learning = recipe card. "What I now know about the world." A distilled fact. No story, no timeline, no I. True regardless of which day or project hit it. → goes here.
• Retro = diary. "What happened to me." Status, decisions-in-flight, dead ends, follow-ups. → goes to typmem-retro.

The test: "Will this still matter after the work that produced it is finished?"

• Yes → it is a learning. Capture it here.
• No → it is retro material. Do NOT write it here; it belongs in typmem-retro.

What makes a good learning

• Atomic — one fact per file, so each can be searched, judged, and promoted on its own. If you have three facts, write three files.
• No I, no timeline, no story. State the fact, not the journey that produced it.
• Self-contained — understandable by someone who never saw the work behind it.
• Specific and actionable — a constraint, a gotcha, a pattern, a how-things-work truth. Not a vague impression.