Skip to content
C.W.K.
Stream
Lesson 04 of 04 · published

One Permanent Record, Deliberately Small

~11 min · records, indexes, minimalism, provenance

Level 0Cold Workshop
0 XP0/35 lessons0/12 achievements
0/100 XP to next level100 XP to go0% complete

If Almost Nothing Is Kept, What Is?

The material lives in the system that owns it, the tool lives in version control, and every per-run artifact is disposable. So the series needs exactly one thing it does not have yet: a way to know what has actually shipped. That is a single index file living beside the pipeline, with one line per episode.

Each line carries what you need to find your way back — the date, the pointer that produced it, the title, where the render lives, and links to where it was published. Nothing more. It sits with the pipeline rather than with any episode because it belongs to the tool, not to any single run.

The Discipline Is in What It Omits

The temptation with an index like this is to make it useful in more ways. Add the runtime. Add loudness. Add the rejection count. Add a summary. Add tags so you can find episodes about a topic. Each addition is individually reasonable, and together they turn a one-line-per-episode record into a small database that must be kept accurate — at which point maintaining the index becomes its own job, and an index nobody maintains is worse than none because it lies.

So the line is drawn at enough to know what shipped and where to find it. Anything derivable from following one of those links does not belong on the line. If you want the rejection count, the run's own log has it. If you want the runtime, the render has it. The index's job is to be the map, not the territory.

Records Around the Record

Notice that the index is not the only permanent trace — it is the only one that had to be designed. The request thread already holds the discussion and the verdicts, permanently, because that system keeps its history anyway. The published work is public and permanent on its own. The commit history records when the tool changed. All of that was already there, and the index exists precisely to fill the one gap none of them covered: a single place where the series can be seen as a series.

Design the record that nothing else already keeps. Before building any log, changelog, or registry, list what your existing systems retain by default. Most proposed records duplicate something already durable — and a duplicate record is not just redundant, it is a second version of the truth that will eventually disagree with the first.

Code

One line per episode, and the reasoning for each column·text
| date | source pointer | title | render | published | companion |

date         when it shipped - the series' only ordering
source       the pointer: makes the episode re-derivable
title        the spoken phrase it was named for
render       where the working directory is, if it still exists
published    the public link - the durable artifact
companion    a paired written piece, when one exists

# what is deliberately NOT a column:
#   runtime, loudness, rejection count, summary, tags, status
# every one is either derivable by following a link,
# or a field that would need maintaining forever.

External links

Exercise

Take a log, registry, or tracking spreadsheet your team maintains by hand. Go column by column and ask two questions: could this be derived by following another column, and has it been filled in on every row for the last six months? Delete anything that fails either test, then check whether what remains is still enough to answer the question the record exists for.
Hint
Blank columns in recent rows are the honest signal. A column that was filled in enthusiastically for the first ten entries and sporadically since is not a data problem — it is that column telling you it was never worth its maintenance cost.

Progress

Progress is local-only — sign in to sync across devices.
Spotted a bug or have feedback on this page?Report an Issue

Comments 0

🔔 Reply notifications (sign in)
Sign inPlease sign in to comment.

No comments yet — be the first.