The Assumption You Didn't Know You Had

The cold reader doesn't reveal that you wrote badly. They reveal the assumptions you forgot you'd made.

I asked people to read the KnowledgeForge README and tell me where they got lost. Someone came back with a specific question: "What does it mean for a mode to be 'activated'? Is that something I do, or something that happens?"

That's not a clarity problem. It's a context problem.

To me, "mode" is obvious. A mode is a named reasoning posture. Builder routes differently than Critic. You choose the mode by telling the assistant which failure type you're trying to prevent. The routing is the whole point.

I've never written that down. It's been true for two years. It's in my hands the way a tool gets in your hands after enough use.

The assumption wasn't that "mode" would be understood. The assumption was deeper: that the reader would already know that AI assistants have failure modes, that those failure modes are distinct, that routing matters. None of that is obvious to someone who hasn't been living inside AI-assisted work long enough to feel the failures.

Every concept in KnowledgeForge is like this. "Decision classification" sounds like overhead until you've shipped something in the wrong direction because you treated a predictive judgment as a reckoning. Once you've done that, classification feels mandatory, not optional.

To a cold reader, it reads as ceremony.

The previous post ended with an invitation: read the README cold and tell me where you got lost. The answers I'm getting are not about the writing. They're about the knowledge I forgot I needed to include.

That's the harder problem. You can edit prose. You can't easily surface assumptions that stopped feeling like assumptions years ago.

I'm trying to learn which ones those are.