Structure Beats Magic
← All concepts
Method & workflow

Write-Only Knowledge

Easy to produce, impossible to read back — notes, code and models that made sense while you wrote them and never again.

From "write-only code" — technically elegant, comprehensible at the moment of writing, impenetrable afterwards. Write-only knowledge is the same failure applied to everything else you produce: notes, models, captures, generated artifacts. Easy to add to. Impossible to read back.

The tell is that it feels productive. Output accumulates, the folder grows, the graph gets denser — and none of it can be used, because using it would require re-deriving the context that was never written down.

Where it comes from

Capture without structure. A note that made sense in the moment because you had the whole situation in your head. Six months later it is a sentence fragment with no anchor.

Cleverness. In engineering, "clever code" is an insult for a reason: it optimises for the writer's satisfaction over the reader's comprehension. The same instinct produces elaborate note-taking schemes that only their author can operate.

Generation without curation — the modern version, and the sharpest one. AI produces models, diagrams, records and code faster than any human can read them. Volume is not understanding. A thousand generated artifacts nobody has ever read back is a thousand write-only artifacts, and the system is now less navigable than before, not more.

The distinction that matters

Readable ≠ retrievable ≠ understandable. Search solves retrieval; it does nothing for understanding. You can find the file and still not know what it means or why it exists. That gap is where write-only knowledge hides — it passes every mechanical test and fails the only one that counts.

The fix is structural, not editorial

You do not fix this by writing better notes. You fix it by making orientation a built artifact: a map at every layer (Maps Everywhere), decisions recorded with their alternatives, the reasoning captured while it is still live. The test is simple — can this thing tell you what it is, without its author present?

Generation scales. Comprehension does not. Everything produced faster than it can be read needs a curated layer above it, or it is write-only by default.

Related concepts

The neighbourhood

How this connects