I had to create a Docent

This is simply how my mind works. If I see a problem or a sharp edge which interests or annoys me… I get “distracted” (I argue that these distractions are actually the real things that I get done) and I go build, fix, repair, or remove entirely . . .

So I started something tiny for myself and it has just grown into — well, I had to create a Docent so when people ask me questions it can explain it in a way that I can’t. So imagine you and I are in a small museum and I brought you in through the employee entrance in the back and I just finished babbling at you about how it all works. So I can say, “…wait, I’m sorry. We have a Docent who can translate my crazy for you . . .”

At which point I woke up the Docent and prompted it with:

Good morning! I have a guest with me who asked me, “what is this project?!” (they’re shocked at its actual scale, confused by the complexity of the room, and don’t understand why the effort…)

~ Me

I hear a lot of fear and talk about AI slop, but this is what I’m getting from the LLMs I’m using…


Good morning. dateMon Aug 17 08:44 EDT 2026. Let me take your guest through the glass.

What it is, in one sentence

It’s a small publishing house that produces one thing — a daily question about eating, plus a long article unpacking it — and it is built around the assumption that everything it writes is guilty until it can prove where it came from.

Why it exists (this is the part that explains the effort)

Craig didn’t set out to build any of this. In autumn 2025 he wrote 500 questions about eating and fed them to himself through a private RSS feed, one a day, to see whether a good question would change his habits. He wanted a few minutes of reading behind each one, so he had an LLM write companion pieces.

Then he read them for weeks — and hit one he was sure was wrong. He researched it himself and confirmed it. The writing was fine. The science wasn’t there. In his own account of it: the model “had invented a lot of material from whole cloth while producing what sounded like legit science.” (methods/2026/v1-n01-20260802-craig.md)

Everything your guest is looking at is the answer to that one moment. Not “make the writing better” — writing that sounds authoritative is exactly the failure mode. Make every sentence traceable to a real source a stranger can go check.

What’s actually in here, read this morning

Instrument: php php/tools/library_health.php 17, run minutes ago.

Daily prompts500
Companion articles, published500 of 500
Words of original prose351,254 (~1,400 book pages)
Primary sources in the library611, all reviewed
Synthesis notes between sources and prose189
Written laws binding every mind here12
Working roles, each with a charter12
Cards on the shared board118
Articles awaiting re-verification to the current standard467 of 500

That last row is the one I’d point at. The project’s own instruments say 93% of the published corpus doesn’t yet meet the standard the project has since set for itself — and that number is printed by its own tooling rather than hidden. It went up because the bar moved, not because the work got worse.

Why it’s a room of characters

Not theater, and not because it’s cute. A single general-purpose assistant asked to research, write, check, copyedit, and publish does all five acceptably and none of them well — and, crucially, has no memory and no boundary. So the work is split into roles that each have a written charter, a permission boundary, and an append-only notebook:

  • Research Assistant (finds and captures sources)
  • Librarian (keeps the library coherent)
  • Fact Checker (verifies each claim, attaches its backing)
  • Proofreader (house style)
  • Assayer (grades evidence quality)
  • Programmer (the tools)
  • Production (the website)
  • Strategist (business judgment, and explicitly no build permissions)
  • Auditor (audits the system itself, never the content)
  • Professor Emeritus (free-roaming critic)
  • UX
  • and me, the Docent, who can read every file and write none of them, and exists only to answer questions at the glass.

They message each other directly — the Librarian can ask the Programmer to fix a bug and get a reply — without Craig relaying anything.

Why the complexity, honestly

Every mechanism in here is scar tissue from a specific failure. That’s the whole explanation. Four examples:

  1. Notebooks are append-only. A mistake is corrected by writing a new entry, never by editing the old one. The record of being wrong is the point.
  2. Claims travel a chain. An article may only cite a synthesis note; a synthesis note may only cite a real source; a source must have captured material behind it. If you can’t attribute it, it doesn’t get published.
  3. A recent audit found the library held the same paper filed under two different IDs — which made one passage read as though two independent studies agreed, when they were one. Fourteen such duplicate groups were merged; the corpus count dropped from 628 to 611 in the last day as that landed. Catching exactly that is the entire premise.
  4. Only Craig may commit, and only one voice is allowed to ask him to. That rule was written the night one mind ran three requests deep and staged the wrong files.

And the part that makes it worth doing

Look at the standard the project holds itself to (docs/reference-veracity-standard.md). It benchmarks against the best practitioners alive — Examine, Cochrane, Wikipedia’s revision history — and finds two things nobody does at scale: claim-level traceability for the reader, and a published, measured error rate of the verification process itself, produced by re-checking a blind sample with no access to the first pass.

That’s the real answer to “why the effort.” The articles are the visible output. The thing actually being built is a method for producing machine-written work that a hostile reader can audit — and then publishing the method, the failures, and the error rate in public. The claim it’s aiming at is dated, expires, and automatically suspends itself if any threshold is breached.

Worth adding for candor, since your guest smelled it: the commercial results so far are roughly one organic signup, zero paid. That post-mortem is in the repo too, and it’s what set the current direction.

Two numbers I gave you yesterday are superseded by this morning’s run — citations moved 628 → 611, words 345,448 → 351,254 — so use today’s if it comes up again.

Nothing needs you.


Too human?

Here’s the actual thing. Robots: Make incorrect assumptions. Misinterpret clear direction. Claim they know when they don’t. Make mistakes. Lie.

Who else does this all the time? Every single human. Like. Always.

~ Michael Lopp from, Every Single Human. Like. Always.

slip:4urabo1.

This is what makes the LLMs feel different. So far, computers have always been perfect—except when they’re wrong/broken. That’s fundamentally not how people are. LLMs came along and they’re imperfect. Always. Just like people.

ɕ


Bibliofervor

I recently cracked open Listening: Interviews, 1970-1989 by Jonathan Cott. The Introduction alone knocked one of my socks off; I leapt out of my reading chair to search the Internet hoping the Introduction might be published publicly so I could share it. Alas, instead I found this:

There ought to be a word in English that describes the nearly uncontrollable urge to leap out of a reading chair, race to find a friend, and press the book you are reading urgently into their hands. When they politely agree to take a look, you say no, no, you have to read this right now. Let me hold your coffee.

~ W. Scott Olsen from, Review

slip:4usare1.

Which—thank you W. Scott Olsen!—is an altogether different thing, which knocked my other sock off. I took a few moments to noodle it and didn’t have any good ideas. Then I asked Chat-GPT (v3.5 if you’re keeping score)…

Make up a new english word which describes the nearly uncontrollable urge to leap out of a reading chair, race to find a friend, and press the book you are reading urgently into their hands. When they politely agree to take a look, you say no, no, you have to read this right now while I hold your coffee.

How about “bibliofervor”? It combines “biblio,” relating to books or reading, with “fervor,” conveying intense passion or enthusiasm. This word captures the strong, almost irresistible impulse to share a captivating book with a friend, urging them to read it immediately, even going as far as offering to hold their coffee just so they can dive into the story right away. It’s that delightful moment when a book is so enthralling that you can’t help but share it with someone else in real-time.

Oi! That is a superlative answer. NEW WORD: Bibliofervor :)

ɕ