CrocoBrain concept

Knowledge debt

Code has technical debt; your notes have knowledge debt. Every written claim starts decaying the day you write it — and nobody has ever blocked out a Friday to “update my notes.”

Your notes decay

The half-life of working knowledge is measured in weeks. A client's positioning, a tool's price, the state of a market, what someone thinks: all of it moves constantly. The note written six months ago describes a world that no longer exists — with the same assurance it had the day it was true.

This is not a writing flaw. It is the nature of the material: operational knowledge is perishable, and a note system that ignores this turns, mechanically, into a museum.

Worse than a missing note: a wrong note that sounds sure of itself

A missing note sends you back to verify at the source: that is a cost, not a danger. A stale note that reads with authority gets believed — quoted in a proposal, baked into a decision, passed along as is. The error propagates with your signature on it.

This is where the debt metaphor earns its keep: the interest compounds. Every decision built on a stale claim breeds further stale claims, and the more complete the system looks, the more false safety it inspires.

Maintenance always loses

The classic answer — reread, date, revise on a schedule — fails for a simple reason: maintenance always loses to the work. No client pays for an afternoon of note gardening. Revision is forever next week's task.

Demanding more discipline means prescribing the cure that already failed. If the freshness of your knowledge depends on a ritual nobody keeps, it is structurally doomed.

CrocoBrain's answer: arbitrated freshness

The lazy fix would be recency-wins: the newest information silently overwrites the old. CrocoBrain refuses. When a recent source contradicts what your brain believes, the contradiction is surfaced, never silently resolved — and your arbitration is recorded: a rule, a context, or a tension you choose to keep open.

Debt is also tracked on the missing side: gaps. Wiki notes that exist but were never linked, zones of the brain left thin, entities cited everywhere with no dedicated page, questions you asked that your brain could not answer. The debt stops being invisible: it has a list.

The owner stays the judge

None of this rewrites your notes for you. The brain flags, proposes, asks — it does not rule. A note that deserves reconfirming asks you for it; it is not rewritten behind your back. That is more demanding than an automatic synthesis, and it is the price of a system you can believe.

Knowledge debt never disappears — it becomes visible, dated, arbitrable. And a claim arbitrated yesterday is worth more than ten notes written a year ago. The natural sequel to this essay: living memory.

Knowledge debt — your notes are decaying