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.


Can you explain it?

Physi­cist and sci­ence com­mu­ni­ca­tor Richard Feyn­man came up with anoth­er cri­te­ri­on, one that applies direct­ly to the non-sci­en­tist like­ly to be bam­boo­zled by fan­cy ter­mi­nol­o­gy that sounds sci­en­tif­ic. […] Rather than ask­ing lay peo­ple to con­front sci­en­tif­ic-sound­ing claims on their own terms, Feyn­man would have us trans­late them into ordi­nary lan­guage, there­by assur­ing that what the claim asserts is a log­i­cal con­cept, rather than just a col­lec­tion of jar­gon.

~ from Richard Feynman Creates a Simple Method for Telling Science From Pseudoscience (1966)

slip:4uoeri1.

Confronting scientific-sounding things on your own terms is actually very difficult. What he’s described is not meant to be a way to decide if something is true—that’s much harder. He’s giving you a tool for quickly spotting scientific-sounding rubbish.

ɕ


Not me, I’m certain

Three words matter much: Not me, I’m certain I am uncertain. I’m not simply uncertain. Not simply indecisive, beset by unknowns, nor stymied by possibilities.

The virtue of intellectual humility is getting a lot of attention. It’s heralded as a part of wisdom, an aid to self-improvement and a catalyst for more productive political dialogue. While researchers define intellectual humility in various ways, the core of the idea is “recognizing that one’s beliefs and opinions might be incorrect.”

But achieving intellectual humility is hard. Overconfidence is a persistent problem, faced by many, and does not appear to be improved by education or expertise. Even scientific pioneers can sometimes lack this valuable trait.

~ Michael Dickson from, Intellectual humility is a key ingredient for scientific progress

slip:4uteie8.

The compass for me is, “so what?” When I’m certain of something, I ask myself: So, what? Connecting that which I’m certain of, out into the world via, “so, what?” challenges me to look at the underpinnings of my beliefs, and the integration with my knowledge in total.

ɕ


Discovery

What people think of as the moment of discovery is really the discovery of the question.

~ Jonas Salk

slip:4a1159.


A cure for hiccups

[It] boils down to a simple breathing exercise. First, exhale completely, then inhale a deep breath. Wait 10 seconds, then—without exhaling—inhale a little more. Wait another five seconds, then top up the breath again. Finally, exhale.

~ Uri Bram from, The Cure for Hiccups Exists

slip:4uteie9.

Sometimes I straight-up do public service announcements. Here, have a cure for hiccups!

If you’ve thought about how proper breathing works, you’ll quickly realize those instructions involve incrementally, increasingly flexing your diaphragm muscle. (If that isn’t obvious, the Thoracic diaphragm page on Wikipedia has you covered.) The muscle spasm is part of a feedback loop involving two of our nerves, and intentionally activating the muscle breaks that feedback. The trick is that you need to really flex it… flex it much harder than you normally do when breathing.

Note that if you do the “hold your breath” part of the exercise by closing your glottis (what’s that?) and relaxing your diaphragm, you’re doing it wrong. The entire point of the exercise is to flex, flex, flex and hold tension in the diaphragm muscle.

ɕ


The gap

The Wrights’ story shows something more common than we realize: There’s often a big gap between changing the world and convincing people that you changed the world.

~ Morgan Housel, from When You Change the World and No One Notices

slip:4ucobo12.

On one hand, we could simply define “changed the world” to be when people have actually noticed, or when the change is wide-spread. On the other hand, it’d be much more interesting to acknowledge that the change happens at the moment of the advance—the moment the Wright Brothers figured out controlled, powered flight. (It’s the “controlled” part that really made them first.) The challenge for us creatives… for those of us out trying to change the world… is how do we act during the gap. Do we keep working, quietly changing the world further? Do we stop working and start marketing? Or… something else? To quote William Gibson: “The future is here, it’s just not evenly distributed yet.”

ɕ


Forget glowing noses

During the summer, when the sun spends months above the horizon, the inner parts of the animals’ eyes, a structure called the tapetum lucidum, gleam a shimmering gold. But as the landscape dips into the perpetual darkness of winter, their eyes turn a rich blue.

~ Katherine J. Wu, from Twice a Year, Reindeer Eyes Pull Off a Wonderful Magic Trick

slip:4utesi1.

Forget glowing noses; reindeer eyes are magic. This is a short, punchy, pop-sci article— and is exactly the sort of random, interesting thing I delight in trawling through RSS feeds to locate.

ɕ


Titan

Titan is like Earth with its rivers, lakes, and seas filled by rain, but as stated, this is liquid methane and ethane as opposed to liquid water on Earth. Like Earth, Titan also has sand dunes, but they are made of hydrocarbons instead of silicate-based substances. Also, much like Earth, Titan is known for having a seasonal liquid transport cycle, also known as the water cycle on Earth, linking atmosphere, land, and oceans.

~ Laurence Tognetti from, Titan is an Alien World, but Surprisingly Familiar – Universe Today

slip:4uuiti1.

Back in the 1980s I read a lot of science fiction weaving epic tales and describing alien landscapes. These days, I continue to read things which are weaving epic, and describing alien—but they are no longer fiction.

ɕ


Logical conclusions

In its original Latin use, the word genius was more readily applied to places — genius loci: “the spirit of a place” — than to persons, encoded with the reminder that we are profoundly shaped by the patch of spacetime into which the chance-accident of our birth has deposited us, our minds porous to the ideological atmosphere of our epoch. It is a humbling notion — an antidote to the vanity of seeing our ideas as the autonomous and unalloyed products of our own minds.

~ Maria Popova from, Darwin Among the Machines: A Victorian Visionary’s Prophetic Admonition for Saving Ourselves from Enslavement by Artificial Intelligence – The Marginalian

slip:4utesa2.

This is a delightful meander across time and authors.

ɕ


That’s… interesting

But in our Physics Project we’ve developed a fundamentally different view of space—in which space is not just a background, but has its own elaborate composition and structure. And in fact, we posit that space is in a sense everything that exists, and that all “things” are ultimately just features of the structure of space. We imagine that at the lowest level, space consists of large numbers of abstract “atoms of space” connected in a hypergraph that’s continually getting updated according to definite rules and that’s a huge version of something like this…

~ Stephen Wolfram from, On the Concept of Motion—Stephen Wolfram Writings

slip:4useoe1.

I’m not sure what to say about this. I am certain that Wolfram is not crazy and that he is brilliant, but he’s pretty far beyond what I can understand. (Picture me doing that slightly askew, squinting thing.) On the other hand, if they really are making the progress they seem to be… it’s going to be a neat time to be alive, in another decade when they get things sorted out.

ɕ