The Method

Every batch here carries one of four labels. They describe how settled the contents are, not how much work went in or which room holds the work.

The whole point

Stop trying to finish things before you show them.

The Four States

Reagent

Raw. Gathered before I understood it. Most notes start here and a lot of them stay here, which is fine: an unprocessed note still says what caught my attention and when.

Tincture

Steeping. I’ve come back to it at least once and changed something. This is where most of the actual thinking is visible, because it’s the only state where the note is still moving.

Elixir

Stable. I can explain it without looking, and it has survived being used for something real. Rare, and slower to arrive than I expect every single time.

Failed batch

Wrong, kept on purpose, labelled with what went wrong.

How a Note Moves

The transitions are deliberately mechanical, so there’s no judgement call to avoid on a bad day.

Reagent to tincture isn’t “it got better”, only that a second pass happened. Revisiting is the promotion.

Elixir needs both halves. Explaining it without notes rules out memorised phrasing hiding a gap; having used it rules out understanding that only holds in the abstract. If either half fails it stays a tincture, and there’s no deadline on that.

What a Failed Batch Actually Is

This is the part worth being precise about, because the obvious reading is the wrong one.

A failed batch is a wrong conclusion, not a stalled effort.

It’s a note that said something, and that something wasn’t true. I thought the bug was in the proxy, it was in the DNS. I thought this pattern was the right shape, it collapsed under a case I hadn’t considered. That’s real information, it’s expensive to recover once forgotten, and it’s worth more six months later than silence.

What it is not:

• Not a project I stopped working on.
• Not something unfinished.
• Not losing interest.
• Not a gap between when I said I would do a thing and when I did.

Something I put down is a reagent that stopped steeping. It keeps its label, waits on its room’s shelf, and remains available if a later question calls it back. Nothing about it is a failure and nothing here marks it as one. That distinction is the whole reason this vocabulary is worth having: an apothecary has a word for a batch that came out wrong, and no word at all for a jar nobody has opened lately, which is exactly the right pair of facts.

The other thing a failed batch isn’t… Deleted. When something is corrected, the wrong version stays visible with the correction next to it rather than being quietly rewritten. Same rule I built into the Crawler’s Companion, a reference for the Dungeon Crawler Carl books that shows what was known at any point in the series rather than only what’s known now. Same reason as well. What I believed earlier is part of the record, and a shelf where every label was always right is a shelf that’s lying.

Building Something Up

Notes accumulate before they combine, not the other way round.

Several reagents on one subject eventually make it obvious that they’re about the same thing. That’s when a tincture gets written: not a summary of the reagents, but the thing they turned out to be evidence for. The reagents stay. They’re the work, and the work is often more useful than the answer.

A tincture that stops changing across a few visits has become an elixir, whether or not it feels finished. Feeling finished is not one of the criteria, because by that measure nothing ever would be.

Structure comes from links and from the rooms that collect broad kinds of practice. Within a room, shelves emerge from what actually connects; they are not a hierarchy guessed before the work exists.

The Mechanics

A published knowledge note carries one state tag and at least one subject tag in frontmatter alongside publish: true. The state says how settled the batch is; the subject says which room and shelf it belongs on. Navigation pages are exempt.

tags:
  - reagent      # the state. one of the four above
  - shaders      # what it's about
  - math         # only if it's genuinely about this too

The subject tags are what make The Rooms work without being maintained by hand. Quartz builds a page for every tag automatically and lists everything carrying it, so a room can link to a shelf once something has earned it. Write the note, tag it, and it appears on the shelf on its own.

About, or Merely Touched

A shelf is a view rather than a box, so a note appears wherever it genuinely belongs and there’s no single correct home to agonise over. RSA honestly is a maths note and a security note, and filing it under one would be a lie I’d have to remember later.

The test for each tag is the same one every time.

The whole test

Is this note about that shelf, or did it just touch it?

A shader that uses a dot product is shaders and nothing else. It touched maths, it isn’t about maths. A note on why that dot product gives the lighting angle is about maths, so it takes both. A* written to path enemies is game-development. The same algorithm written to understand A* is dsa.

Two tags is normal, three is a smell, and four means it’s more than one note. That last one isn’t a filing problem, it’s the note telling me it hasn’t been decomposed yet.

Tags Say What It Is, Links Say What It Touches

Everything a note merely touched gets a link instead of a tag, and the link goes to the specific note rather than to the shelf.

A sprite drawn for the game is design. It isn’t a game development note, it’s a drawing that happens to have a job. So it links to the note about the game, shows up in that note’s backlinks, and appears in the graph as an edge between them. Nothing is lost, and the Game Development shelf still means “notes about building games” rather than “notes adjacent to a game”.

That’s the difference worth keeping. Tags are membership, links are connection, and the graph is only interesting because the second one exists.

The Vocabulary

Fixed, because a tag invented per note is just a weaker topic route. One per shelf:

observatory game-development ai-engineering nand-to-tetris networking linux data shaders creative-computing design math dsa languages security neuroevolution art japanese stable quarters

Plus meta for notes about this place rather than about a subject, which is what the formulary carries.

A shelf gets its tag-page link added when its first note lands, not before. Quartz only builds a tag page once something is tagged with it, so linking all nineteen up front would produce nineteen links that look live and go nowhere.

Nothing is published without publish: true. That’s opt-in on purpose: a forgotten flag means a note is missing, never that something private is public.