Seventeen Lessons, Five Seconds Apart

Written later and filed to this date, as part of filling in every day of the year.

Seventeen of the two hundred and fifty-four entries in my fleet’s lesson store have been reinforced, all at the same moment: the July afternoon the store was built, five seconds after they were first written, by the seed command run a second time to prove that running it twice was harmless. It was. Every seeded entry got its weight bumped, its clock reset, and a line in the log saying something had met it again. Nothing has met any entry since.

The store is one JSON line per event, kept in the repository so it travels. An entry is a rule, a lesson, a gotcha or a pattern, scoped to one repository or to all of them. Rules are pinned: a hard gate holds whether or not anyone has tripped it lately. Everything else decays. A fresh entry starts at seven tenths and halves every forty-five days from its last reinforcement; below one twentieth it stops surfacing in queries, though it is never deleted. Re-encountering a lesson resets its clock and adds a quarter back, so one that keeps proving relevant stays near full strength and one nobody hits sinks.

The catch is the word re-encountering. Only a second add of the same words, in the same scope, of the same kind, reinforces anything. A query is a read and leaves no mark, and no agent queries the store on its own: the runbook that shipped with it says built, not yet wired, and that line still holds. What agents do is write to it. A hundred and eight gotchas arrived in one month and a hundred and twelve in the next, many of them recorded right after a safety guard refused a command. Six sessions once left theirs in the working tree for one commit to bank. Two hundred and forty gotchas, written by sessions that never read each other’s, and not one repeat.

So the decay measures the store’s silence, not the lesson’s worth. Every gotcha slides down the same curve at the same rate; the first will drop out of retrieval about a hundred and seventy-one days after it was written, whether it was the one thing the next agent needed or a note nobody could have used. The five seeded gotchas and lessons, with their one bump, get twenty days more. The twelve seeded rules never move.

Knowledge decay, then: the rule that a lesson’s weight halves every forty-five days unless the same lesson is written again, that a rule never decays at all, and that a store built this way cannot tell a lesson nobody needed from a lesson nobody wrote down twice.


← all writing