Memoing¶
Core Idea¶
Memoing produces a parallel, contemporaneous, durable record of the in-flight reasoning that generates an artifact — decisions, alternatives, doubts, frame-shifts — kept alongside rather than folded into the artifact. The point is anti-collapse: absent the trace, "we deliberately chose X over Y" and "we never considered Y" become indistinguishable.
How would you explain it like I'm…
The Building Notebook
Saving the Path, Not Just the Result
The Parallel Trace
Broad Use¶
- Qualitative research: Analytic memos are the engine of category emergence, distinct from descriptive fieldnotes.
- Software engineering: Architecture Decision Records capture each decision's context, alternatives, and rationale in version control.
- Laboratory science: The bound, paginated, time-stamped, signed lab notebook sits alongside the apparatus and its outputs.
- Clinical practice: Progress notes carry the clinician's in-flight reasoning — assessment, differential, plan — beside the patient record.
- Law: Attorney work product is recognized as a distinct, valuable object and protected by privilege.
- Machine learning: Experiment logs, model cards, and ablation rationale carry reasoning alongside the trained model.
- Audit: Workpapers form the regulated chronological record of sampling decisions, exceptions, and resolutions.
Clarity¶
Surfaces the distinction between the artifact and the reasoning that produced it, relocating a class of failures — an undebuggable model, an unexplained code branch — to their actual cause, the absent trajectory.
Manages Complexity¶
Compresses a high-dimensional reasoning trajectory into a streamlined parallel trace at low marginal cost — eighty contemporaneous words per decision — averting an otherwise intractable later reconstruction cost.
Abstract Reasoning¶
Yields the artifact-trajectory distinction, the real-time-versus-post-hoc point (reconstruction is biased by hindsight), the signal-not-noise trainable filter, and the protection dimension (the trace must be shielded to stay honest).
Knowledge Transfer¶
- Lab notebook → software: The contemporaneous, append-only, dated discipline ports directly to architecture decision records.
- Grounded theory → ML: Letting emerging analysis direct the next move ports as follow-up runs guided by prior runs, rationale preserved.
- Clinical → operations: Contemporaneous assessment under time pressure ports as live incident-timeline capture.
Example¶
A single eighty-word grounded-theory memo — "merged 'reluctant compliance' into 'strategic accommodation' because the former implied an attitude the data did not support; considered keeping them separate but the markers were identical" — preserves a distinction the finished category scheme alone cannot recover.
Relationships to Other Primes¶
Foundational — no parent edges in the catalog.
Children (1) — more specific cases that build on this
- Provenance decompose Memoing — Memoing is one GENERATING PRACTICE that produces provenance (traceable origin) for reasoning. The file: 'provenance is the achieved traceability; memoing is the human reasoning-capture that yields it.' Recorded as the produced-component relation; provenance is far broader than memoing (art, data lineage), so NOT a reparent of provenance — a part-of/yields edge only.
Not to Be Confused With¶
- Memoing is not Sensemaking because memoing is the practice of externalizing and preserving reasoning in a durable trace, whereas sensemaking is the cognitive activity of constructing understanding.
- Memoing is not Versioning because memoing records the reasoning that moved between states (the why-of-the-move), whereas versioning records successive states of the artifact (the what-at-each-checkpoint).
- Memoing is not an Audit Trail because memoing captures the human why — decisions and rejected alternatives — whereas an audit trail is a machine-generated record of what was done.