The Semi-Finished Product Filed Under “Knowledge”
In most people’s mental model, notes only have three tiers: see information → turn it into knowledge → use it to create. The act of “recording” in between gets quietly filed under “knowledge.”
But as I said in the overview, records deserve to stand alone as their own layer. Because it’s an independent intermediate form: it’s relevant to you, but not necessarily useful forever; it might just be something you’ll need someday, or something you’re using right now to clarify your own thinking. That kind of thing doesn’t yet qualify as knowledge — only what’s structured for repeated future reuse counts as knowledge.
A record is an index — it’s semi-finished knowledge.
Recognizing this cures a very common ailment: mistaking “recorded a lot” for “learned a lot.” Recording doesn’t equal mastery, just as prepping ingredients doesn’t equal cooking a finished dish. Calling records semi-finished does not diminish them. They are the first site where raw input becomes something I can inspect later. That makes the record layer worth protecting, even though I cannot honestly rank its conversion rate against every other learning method.
This essay is about how to make good use of that “first site.”
Records Have More Than One Shape
Writing is my default because sentences expose gaps, but it is not the only way to pin experience to time:
| Medium | Good for | Minimum context to keep |
|---|---|---|
| Text note | reasoning, questions, decisions | source, time, task, next action |
| Voice memo | motion, fatigue, accessibility, spoken reflection | transcript or locator, speaker, consent |
| Screenshot or photo | visual state, UI, whiteboard, physical evidence | origin, timestamp, identities checked |
| Code diff or commit | what changed in a system | repository, revision, intent, test result |
| Experiment output | observation under conditions | setup, inputs, environment, result |
| Decision log | why one path was chosen | options, evidence, owner, consequences |
The medium changes; the requirement does not: a future reader must be able to reconstruct what happened without borrowing the context still sitting in my head.
Records move through five explicit states:
| State | Meaning |
|---|---|
captured | the observation exists, with a minimum passport |
clarified | fact, interpretation, uncertainty, and next action are separated |
reviewed | a human checked source, sensitivity, and whether the record is still intelligible |
promoted | the record passed the knowledge admission gate and points to the resulting card |
discarded | it has no durable value or cannot be used safely; the reason is logged |
A minimal capture card looks like this:
captured_at: 2026-07-11T14:20:00+08:00
source: "meeting notes; participants consented to internal notes"
context: "deciding why the publishing job skipped one article"
observation: "the job treated a future +08:00 date as future content"
interpretation: "timezone handling may explain the missing page"
sensitivity: internal
next_action: "reproduce with a production build and inspect the date"
It is deliberately incomplete. Its job is not to sound wise. Its job is to preserve enough reality for the next pass.
The Act of Writing Is Itself a Retrospective
Let’s start with the action that works best for me: write often enough that important observations do not expire in memory. Daily writing is one possible rhythm, not a moral standard.
Writing can be a form of reflection. I often do not write because I have figured something out; I figure out which parts remain vague by forcing them into sentences. Words are developer fluid for thought: gaps and shaky logic become easier to inspect once they have a visible form.
My own useful change was smaller and easier to verify: after keeping decision records, I could return to a failed implementation and distinguish what I observed from the explanation I invented afterward. The record did not make me wiser automatically. It made revision possible.
Friction is not automatically progress; pointless formatting can be painful too. The useful friction is specific: separating observation from interpretation, naming missing evidence, and committing to a next action. AI should reduce transcription work without removing those decisions.
There is a more practical reason too: only what leaves a durable trace can be reviewed, structured, or challenged later. Text, audio, images, diffs, and experiment output all qualify. A record pins fleeting experience to time; its passport keeps that pin from losing its label.
Records Need to Be Low-Friction: Complete First, Perfect Later
Since recording matters this much, it needs to happen as easily as possible. The first principle of recording is low friction.
Perfectionism is one source of friction: waiting until the thought is complete, a long block of time appears, or the wording feels ready. The useful response is to lower the presentation bar without removing the evidence floor. Capture before polishing, but never detach the record from source, time, and reason.
In tool terms, this means an entry point that opens quickly and can store the minimum passport. I sometimes use Flomo; a local text file, voice recorder, issue tracker, or paper notebook can serve the same role. The workflow is tool-independent.
Separating quick capture from careful refinement is still the key design: capturing may be fast and messy; it must not be careless with people, secrets, or provenance. Credentials and private keys are never captured. Customer or regulated data follows the approved system, not a personal note app. Private material stays encrypted or local when required. Screenshots are checked for names, tokens, and unrelated identities before storage or model access.
The retention and privacy behavior also depends on the product and feature. Anthropic’s current API and data-retention documentation is a useful reminder that chat, files, API features, and third-party integrations do not all share one retention model. Tool convenience does not override consent or policy.
Give Records a Structure: The Five-Step Retrospective
Low friction solves “whether to record,” but if records stay forever at the level of a running diary, they are hard to evaluate. Besides quick capture, I use a review structure before promotion.
My earlier five-step retrospective was a useful start. The version I use now separates evidence from interpretation:
- Fact: what happened, without interpretation?
- Problem: which constraint or failure mattered?
- Action: what changed, by whom, and when?
- Result: what observable outcome followed?
- Evidence: which source, diff, log, output, or quote supports that result?
- Interpretation: what do I currently think it means?
- Counterexample: what would weaken or reverse that interpretation?
- Next step: test, clarify, promote, keep as context, or discard?
This turns recording from passive bookkeeping into active processing. A record is not promoted because it sounds insightful. The knowledge gate asks whether its claim is clear, its source traceable, its scope explicit, at least one real use or test recorded, counterevidence preserved, and an owner willing to approve the next review date.
With this structure in place, your records stop being a pile of fragments and become a series of semi-finished products carrying problems and actions, ready to be structured upward. They’re already standing at the door of the knowledge layer.
Next-Day Polish: Using a Cooling-Off Period to Push Records Toward Knowledge
There is one more useful default in my record layer: reread after some distance.
For ordinary reflections, I often review yesterday’s record today. The delay is a personal window, not a universal law. Incidents, security events, meeting decisions, consent, and volatile experimental context must be clarified immediately while evidence and participants are still available.
Why revisit later at all? Distance may reduce some of the author’s automatic gap-filling and make the text easier to read as evidence rather than intention. It does not guarantee insight. Running the record under cold water only helps if the source and context were preserved before they evaporated.
The significance of this step goes far beyond “making it read more smoothly.” It’s the key step that pushes a semi-finished record toward reusable knowledge:
- A short review window is easier for me to sustain, but its value is measured by corrected gaps, not minutes spent;
- The process of editing forces you to re-judge: what did this record actually distill? Is it worth promoting to a formal knowledge card? Anything you can’t fix or can’t clarify gets tagged “needs restructuring” — a sign it isn’t ready yet;
- One sentence to sum up its payoff: trade enough time for another perspective, but never delay the context that cannot be recovered.
The workflow is therefore capture → clarify → review → promote or discard. Cubox, RSS, Flomo, Notion, a Git repository, or a local folder may implement pieces of it; none defines the process. Records sit in the middle because they receive raw input upstream and provide inspectable candidates to the knowledge layer downstream.
Where AI Helps — and Where It Must Stop
AI can transcribe a voice memo, extract timestamps, deduplicate records, ask what is missing, compare a note with its source, and draft a clarification checklist. It may not:
- invent the context that the capture failed to preserve;
- turn an interpretation into an observation;
- fabricate a first-person experience, participant consent, or test result;
- infer success because the record has no outcome;
- promote a record without the human evidence gate.
From a diff to a tested card
Here is a sanitized end-to-end example:
- Captured: a code diff changed an article date from an ambiguous local timestamp to
+08:00; the capture stored repository revision, failing page, and build output. - Clarified: the record separated observation (“production omitted the page”) from interpretation (“timezone caused it”) and added a reproduction task.
- Reviewed: a production build reproduced the omission before the change and included the page after it. A reviewer checked that no unrelated edit explained the result.
- Promoted: the knowledge card became “future-dated Hugo content is omitted from production unless configured otherwise,” scoped to this site’s build settings and linked to Hugo documentation.
- Corrected later: a later test showed
draftstatus could produce the same symptom, so the card gained a counterexample and diagnostic order.
The valuable output was not the original sentence. It was the chain that let another person reconstruct, test, and correct it.
I monitor that chain with:
| Metric | Question |
|---|---|
| Source completeness | do records preserve source and capture time? |
| Context-missing rate | how often can a reviewer no longer reconstruct the event? |
| Review completion | how many due records actually receive review? |
| Promotion rate | how much capture becomes candidate knowledge? |
| False-promotion rate | how often is promoted knowledge later rejected for missing evidence? |
| Reconstruction success | can another person reproduce the record’s reasoning or event? |
| Human-correction rate | how often does a reviewer repair AI transcription, classification, or synthesis? |
The Test: Have You Changed
One final judgment call, to help you tell whether recording is actually working.
My earlier test was: a good record is not merely well-written; it should improve a later decision. I still believe that, with one addition: change is an outcome dimension, not proof of quality by itself.
A wrong record can change a decision too. The fuller test asks: was the claim supported, can another person reconstruct the context, did the next decision improve against its stated criterion, and were later corrections preserved? Beautiful prose is optional. Accountability is not.
Get recording right, and you have a machine that continuously processes information into semi-finished products. But a semi-finished product is still not a finished one — it needs to be structured, called on repeatedly, before it truly becomes your capability.
That’s the job of the next stage: the knowledge layer. We’re going to turn the knowledge base, from a bookmark folder that keeps growing bigger, into a genuine “capability sediment zone” that actually does work. See you in the next essay.
This is the third essay in the “From Information to Creation” column. Previous: Layer One · Information . Next: Layer Three · Knowledge .

Responses