Skip to main content
⚙️ The honest engine

A Cloud of Unknowing: Why We Render What We Don't Know

Every dashboard you've ever used hides its ignorance. Ours draws it: the less we know about a house, the bigger and softer its stars. Here's why an honest fog beats a fake warmth — and how the engine keeps itself from pretending.

Your neighborhood as a constellation — what you know shines, what you don't is fog.

The most honest pixel on this site

Open your street's sky before you've told it anything, and you'll see something most software refuses to show you: a big, dim, soft blur. That blur is your house, rendered by a system that knows nothing about it yet. We could have drawn a crisp icon with a cheerful default score. Every product you've ever used would have. We drew a cloud.

This is not an aesthetic quirk. It's the whole engineering philosophy of Terrarium in one pixel, and this post is the plain-language version of it.

Unknown is not average

Here is the trap most scoring systems fall into. When they don't know something, they quietly substitute the average — an unrated seller starts at three stars, an unmeasured neighborhood gets the national baseline. It feels harmless. It's actually a small lie with compound interest: the system can no longer tell you the difference between "we checked, and it's mediocre" and "nobody ever checked."

Terrarium's Readiness Score refuses the substitution. An axis we have no evidence for scores zero — not 50%, zero — because the score is a claim about what is known to be true about your street, and nothing is known. This feels harsh the first time you see a 12 where you expected a 60. It is also why the number means something when it climbs: every point was earned by evidence. A scenario answered. A neighbor named. A pantry declared, and later re-affirmed. The score can't be flattered. It can only be fed.

How a machine carries its own uncertainty

Under the sky, each house is a set of sixteen registers — four social (connected, trusted, present, share) and the twelve capability axes, energy to culture. The state we keep for each register isn't a single number. It's closer to a small ball: the direction it points is what we believe, and the radius is how sure we are. A register we've never observed sits at the center of its ball — maximum uncertainty, believing nothing. The physics-inclined will recognize the maximally mixed state; everyone else can just trust the picture, because the picture is drawn directly from it.

That's what the sky's visual grammar actually encodes:

  • Size and softness are uncertainty. A small, hard, bright star is a register we've seen evidence about, recently. A large soft blur is the ball at its center — the cloud of unknowing.
  • Color saturation is verification. A bright-but-grey star means "declared once, never confirmed" — decisive, but unverified. It reads differently from a warm star on purpose, because it is different. We call these grey ghosts.
  • Nothing glows by default. There is no idle animation, no simulated shimmer. The sky moves when life moves — a named neighbor, a shared meal, an answered scenario — and at no other time.

Fog is an invitation, not a judgment

Here's what surprised us watching people use this: the cloud doesn't read as failure. It reads as night before you've lit the lamps. A dashboard that defaults everything to yellow makes you feel vaguely, unfixably behind. A sky that shows honest fog shows you exactly where a single small act — one conversation over a fence, one item declared in the inventory — will kindle a new light. The fog is the to-do list, rendered kindly.

And it works in reverse, which matters more. Evidence ages. A generator declared shareable in 2024 might be seized-up in a garage by now; the neighbor you named two springs ago might have moved. So confidence decays: what goes unaffirmed for about ninety days starts to dim, and the score dims with it. Not as punishment — as accuracy. The Still True? walk-around exists because keeping a map honest is a practice, not a purchase.

Why we hold this line

Because we've been on the other side of it. An earlier version of this site told visitors their neighborhood was "about 70% ready." That number came from a model's one-time estimate, and it looked like a measurement. We retired it, documented the retirement, and replaced it with a formula anyone can audit. The cloud of unknowing is the same decision made permanent: wherever the system doesn't know, it must be seen to not know.

There's a practical payoff, beyond hygiene. Trust is the actual substrate this whole project runs on — a street that shares a generator is running on trust, not on gear. Software that bluffs teaches you to discount everything it says. Software that renders its own ignorance earns the right to be believed when it finally shines. We'd rather show you fog for a month than show you a number you'd be right to doubt.

Clear one patch of sky tonight

The fog over your street is not a verdict; it's a night that hasn't been lit yet. It clears one honest light at a time, and the first one takes about ninety seconds: name one neighbor you could call at 2am. Watch the exact patch of sky it kindles. That's not a metaphor. That's the render. And when the light appears, notice what it looks like: small, warm, certain — one register of one house, earned. The rest of the fog is still there, telling the truth about everything else. It will wait. Fog is patient. So, it turns out, is a neighborhood.

Reading is a way of having. This post is a knowledge offering — thinner evidence than a practiced kit, thicker than an unread tab.

See where your house stands

The 3-minute assessment turns this from reading into a map: your twelve capability axes, honestly scored, with the gaps visible.