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 Abstractions¶
Current abstraction Memoing Prime
Parents (1) — more general patterns this builds on
-
Memoing is a kind of Logging Prime
Memoing is event-time durable logging specialized to the reasoning trajectory that produces a parallel primary artifact.
Children (3) — more specific cases that build on this
-
Analytic Memo Domain-specific is a kind of Memoing
Analytic memo is memoing specialized to qualitative inquiry, where the contemporaneous reasoning trace develops codes, categories, relations, and theory between evidence and claims.
-
Reflexive Journal Domain-specific is a kind of Memoing
A reflexive journal is memoing specialized to observer stance, preserving in-flight assumptions and reactions alongside analysis and linking them to the decisions they shaped.
-
Peer Debriefing Domain-specific is part of Memoing
Peer debriefing contains memoing because its output is a contemporaneous parallel reasoning trace of probes, alternatives, changes, and defended choices alongside the evolving analysis.
Hierarchy path (1) — routes to 1 parentless root
- Memoing → Logging → Observability
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.