Atomicity and Decomposition
Break complex ideas into their smallest meaningful units.
One idea per container
A note that captures exactly one idea can be understood without its original context, linked to any argument, and recombined indefinitely — a note that captures two ideas can do none of these things reliably.
Unique identifiers prevent confusion
Every distinct idea needs a unique, stable address — without one, you cannot reference it, link to it, or build on it reliably.
Decomposition reveals hidden complexity
You do not understand something until you can decompose it — and the act of decomposition will show you exactly where your understanding breaks down.
The smallest useful unit
The smallest useful unit is the level of decomposition where each piece carries independent meaning — small enough to be precise, large enough to be self-contained.
Compound ideas hide dependencies
An idea that looks like one thing is often several things fused together, each carrying unstated assumptions that silently constrain what you can do with it.
Atomicity enables recombination
Small self-contained pieces can be assembled into new structures that monoliths cannot. Atomicity is what makes recombination possible — and recombination is how almost all innovation actually works.
Name things precisely
A precise name converts a fuzzy intuition into a findable, retrievable, composable object — and the act of naming changes what you can think.
Separate claims from evidence
A claim and its supporting evidence are different objects that should be stored separately.
Separate observations from interpretations
What you saw and what you concluded from it are distinct and must not be fused.
Context belongs with the atom
An atomic note should carry enough context to be understood without its original source.
Granularity is a choice not a discovery
You choose how finely to decompose based on your purpose — not on some inherent "correct" level of detail. The same material supports different grain sizes for different uses.
Questions are atomic too
A well-formed question is as valuable an atom as a well-formed answer.
Definitions are load-bearing atoms
The definitions you use quietly shape every conclusion built on top of them.
Duplication signals missing abstraction
When you write the same idea twice you have not yet named the pattern they share.
Atomic does not mean isolated
Each atom exists in relationship to others — atomicity is about self-containment not loneliness.
Version your atoms
Ideas evolve. Your system should let you see how any atom changed over time — not just what you believe now, but what you believed before and why it shifted.
Tags are lightweight relationships
A tag is the simplest way to declare that two atoms share something in common.
Sequences emerge from atoms
Ordered series are built by linking atoms together not by writing one long document.
Refactoring ideas improves thinking
Restructuring your notes restructures your understanding.
Atomicity is a practice not a rule
The goal is not perfect decomposition but steadily improving your ability to decompose.
The self-validating artifact
A knowledge atom becomes trustworthy at scale when it carries its own verification machinery: claim, provenance, falsifier, confidence, expiry, links. Six fields turn a note from prose you must re-read into an artifact a gate — human or machine — can check, decay on schedule, and challenge. It is Shannon's error-correcting code applied to knowledge: structured redundancy that lets the record detect its own corruption.
Contradiction is signal
When a new claim agrees with what you already hold, you learn almost nothing. When it contradicts, you learn that one of two artifacts is wrong — and finding out which is the highest-value work available to you at that moment. A knowledge system that surfaces contradictions at save time turns its most uncomfortable events into its most productive ones.