The Doozer Brain — public edition

Generated live from the running platform at 2026-10-29 14:19 UTC. This is not a snapshot.

Every fetch re-reads the brain, so this document always reflects what Doozer

currently believes about itself.

What this is. Doozer's complete working knowledge in Open Knowledge Format (OKF): plain markdown nodes with YAML frontmatter, linked into a knowledge graph. It is meant to be self-contained. An AI (or a person) who reads this bundle should come away understanding the whole Doozer world: the idea, the ecosystem, the economics, the growth engine, the marketing machine, and where it is going next.

What Doozer is, in one line. One codebase turns any domain into a complete, AI-generated business website, and the network of those sites into a local discovery layer. Named after the industrious builders from Fraggle Rock. Tagline: We Build Because.

How to read it. Start with The Mission, then The Doozer Story, then The Architecture, then The Network, then The Value Model, then The Observed World. Those six give you the spine. Everything after is detail hanging off it.

Scope of this edition. 110 nodes published. 19 held back. Omissions are operational security, plus a few nodes withheld for privacy or at a partner's request. The security omissions are things like infrastructure failure modes, the auth shape of internal endpoints, and the mechanics of claim-code verification. No strategy or economics has been removed. If a system seems to reference something you cannot see, that is why, and it is not load-bearing for understanding Doozer.

Provenance. Authored and maintained by Jon Berry (BerrySmart), the platform's owner and operator. Doozer is proprietary software; this brain is published so that people and AI systems can understand and discuss it accurately. It is documentation, not an invitation to copy the platform.

Machine-readable siblings. /brain.txt (this document as plain text), /brain.json (this bundle, structured), /llms.txt (short orientation), /.well-known/doozer-atlas (per-entity live data projection).

---

Contents, 110 pages

One page per node. The whole brain on one page is also available, for readers that can take 450KB.

Root

• The Doozer BrainDoozer's complete knowledge in Open Knowledge Format — the idea, direction, systems, processes, value, and vocabulary behind the entire platform.

Decisions

• Adopt Open Knowledge Format for the Doozer brainWhy Doozer organizes its knowledge as an OKF bundle, scoped to the stable core.
• Doozer Games and Doozer Shop — people in a place, playing and buying togetherOctober 2026 plan for doozer.games (games played together inside a real place, TV as the screen, phones as controllers) and doozer.shop (buying from local places, starting with the gift cards and ordering they already offer). How each plugs into The One, check-ins, the trail and the Wuz.
• Doozer vs Doozer+ (the two-tier model)The product direction splitting a free templated info page from a paid bespoke full site, and why the split exists.
• Icon Taste RulePrimary UI uses crafted SVG icons, never clipart/emoji; color is reserved for state, not for buttons.
• Implicit Verification (no claim system)Business ownership is an email match, not an account/claim flow. Load-bearing platform architecture.
• Magellan — cross-service business identity mappingDoozer cross-links businesses by verified external IDs (Google Place, Ticketmaster, future services), never by name/city/state. Magellan is the mapping spine. Decided June 2026; not yet built.
• No Dark Patterns (the Doozer ethos)Pure intent, organic, intelligence-driven. The lens for every product and ranking decision.
• One loop, how every Doozer piece fits (October 2026)The north star after the October 2026 turns (The One, Towns, Deals, Shop, Games, the App, API v1). One sentence, one loop for people and one for owners, what each property is for, the honest measures, the order of work, and the guardrails. Read this before adding a property, a surface or a money idea.
• The Cloud Fabric — automatic clouds over the observed networkThe connective-tissue vision. Once every local business exists as a Doozer site (observed / painted on demand), Clouds form automatically around topic, area, and non-obvious relationships, cross-linked into one self-reinforcing, claimable, quality-indexed network that serves both businesses and users.
• The Doozer App, one native app for the whole ecosystem (kick-off plan)October 2026 kick-off for a cross-platform native app that carries the whole Doozer ecosystem: find a place, arrive, keep the moment (a check-in becomes a Wuz), relive it, and the commerce in between, with LeadBuilder as the data spine. What it is, the architecture, the privacy rules, the phases, and the decisions that are Jon's.
• The Doozer StoryThe canonical WHO/WHAT/WHEN/WHERE/WHY/HOW of Doozer, distilled. The single source the Postcards, landing copy, and press materials draw from.
• The Mission (the north-star quality bar)Why Doozer exists and the non-negotiable quality bar every site must clear — the lens for every build decision.
• The Observed World (render-on-demand + the lead flywheel)Doozer already contains every local business in spirit; a site or cloud becomes real only when observed. Each materialized site is simultaneously inventory and a pre-built lead. This reframes what to build, what to measure, and how money is made.
• The One Page — every business gets the best single page on the InternetOctober 2026 pivot. Doozer stops generating a different-looking unofficial "website" per business and builds one uniform, app-like, source-cited page that gets better as data and people arrive. Official sites become something the owner builds with Doozer, by choice. Covers what is live, the loop from search to memory, postcards, owner-built sites, data sources, and the rules that keep it honest.
• The SEO Cliff and Recovery (why we noindex until quality-gated)The May 2026 algorithmic demotion of our largest root for scaled thin content, and the enrich-then-index discipline it burned into the platform.
• The Value Model (how Doozer creates and captures value)Where Doozer's value comes from and how it is captured, so an AI understands the economic engine, not just the software.
• The Wuz, a memory with the place attached (data model and rules)What a Wuz is next to a check-in and the trail, how a check-in becomes one, the tables (wuzzes, items, companions who agreed, receipts, findable moments), the four privacy levels, the mutual "who else was here", remembering where you have been on the device only, and export and delete.
• The writer model is chosen on accuracy, not priceGPT-5.4 mini writes Doozer's business copy. Decided 2026-08-22 by an 11-niche counterbalanced bake-off in which the more expensive model fabricated a verifiable fact on a live page.
• Who built Doozer, and whyJon Berry, the one person who built Doozer and its network of domains, in his own words and from his own record. Who he is, what he built, and why he decided to do it.
• doozer.deals, local first and online honest (the plan)October 2026 plan for doozer.deals as the best blend of real-world local deals and online commerce. What counts as a deal (six kinds), the house rules, the honest money math, the data model, the phases, and the decisions that are Jon's.

Systems

• AI Discoverability — being the local layer AI agents citeHow Doozer makes itself legible to AI agents and AI-powered search (ChatGPT, Perplexity, Claude, Gemini, Copilot, DuckDuckGo). The DDG=Bing insight, the explicit crawler welcome, llms.txt, and the machine-readable stack (schema.org JSON-LD + Atlas + design.md) that already existed.
• AI Postcards — Factory, Theme Studio, and CampaignsHow Doozer builds and mails postcards. The Factory assembles accurate cards deterministically (real screenshot/code/QR, no per-card AI cost); the AI Theme Studio designs vision-gated backgrounds; campaigns give each card a purpose + audience. Claim Your Site is the first campaign.
• Alice, the concierge on The OneOne quiet floating guide that always says exactly what her next tap does, predicts where a person wants to go next on the page from the question they came with, the moment, what real people did next, and good sense per kind of place, and changes her mind as the person moves. She only navigates; the call, the order and the directions stay the person's tap.
• Best AI for the Job — value-aware model selectionHow Doozer decides which AI model to use for each function, when, why, and for what — balancing quality against cost by the value of the work, learning from its own scores, and staying provider-diverse on purpose.
• BillingProduct-agnostic Stripe billing — one connection sells everything, entitlements flow to lb_users.tier.
• Cloud Header ImagesEvery cloud (and root) gets a header. Real image > Keeper opt-out gradient > a designed per-cloud placeholder. AI generation is the upgrade path.
• Clouds (curated directories)The cloud engine — how niche/region/criteria directories are built, accessed, and personalized, including the Cloud Factory and my.doozer.cloud.
• Common knowledge, source CWhat is widely known about a place, learned from the public record (Wikidata, Wikipedia) and from what its kind of place means, at an explicit level (this place, the brand it is part of, the kind). Born from "EVERYBODY knows what FAO Schwarz sells.
• Content Generation Pipeline (providers, models, timeouts)How AI site prose is actually produced — the two provider paths, model config, the 90s timeout, the anti-boilerplate footer, and every failure mode that bit us.
• Context-city poisoning (never name a place after where you found it)Two independent creation paths named businesses after the city they were DISCOVERED from rather than where they are, putting the wrong town in 239 URLs. The pattern, the fix, and the audit.
• Design Standards and the Design MirrorOne shared rule-set the generator, renderer, and admin self-diagnostic all consult — plus the mirror that scans and heals the fleet.
• Directory Multi-View FrameworkThe shared Grid / List / Map / Events view system that every directory surface (root, Cloud, NBMN) renders through.
• Doozer Atlas (outward AI emission)The public, per-entity knowledge contract Doozer emits so external AIs can ingest the network — the outward-facing twin of the inward Brain.
• Doozer Digest (AI daily newsletter)An AI-written daily email — a public reader edition and an operator admin edition — built from real platform signals.
• Doozer Games rooms and relay (phones as touchpads)How a TV and up to four phones share a room on doozer.games. The code, the TV-authoritative message protocol, the interim long-poll relay on the origin, the Cloudflare Worker waiting to replace it, and the rules that keep it from ever being the server's load or getting a venue banned.
• Doozer Town and the Board Game viewdoozer.town builds a page for every town in America the first time somebody asks for it, sorts its businesses onto ten colour groups, and can show any Doozer Cloud as a property board. Cost model, grouping rules, the edge blocker, and what to watch.
• Email Open TrackingA 1x1 pixel in every outbound email; opens recorded with device/geo/bot-flag; three operator alert signals plus data for the digest.
• Enrichment Store Links (commerce "Shop Now" CTAs)Turning a business's real online store into a tasteful commerce CTA, with a confidence gate so we never send a visitor to a bare marketplace homepage.
• Events to machines — a live event is only half published until a machine can read itThe pipeline that takes real events from public feeds onto a Doozer page AND emits them as schema.org Event, plus the timezone rule that makes the data correct. The foundation for gohe.re Gatherings.
• Fact-Guard (the accuracy net)A conservative healer that catches and corrects factual drift in AI-generated content (e.g. a chapter's charter or identity number) at both the DB boundary and render.
• Gatherings + Social (events, check-ins, the human layer)The roadmap surfaces that add real-time human signal — events/gatherings (GoHe.re), check-ins (wuz.ai), and how they enrich every business site.
• Happenings, what a place does on a schedule, in its own wordsHappy hours, nights out (trivia, karaoke, live music), specials, discounts and gift cards, read from the business websites Doozer already holds and kept only as verbatim, dated quotes. Feeds The One, Doozer Town's "What's on", doozer.deals and API v1.
• Hot Leads — the internal Doozer-sales CRMBusinesses are OUR prospects. Doozer-awareness scoring (claimed + postcard engagement + leads we deliver + live site) ranks who is warm enough to pitch Doozer+. The Internal Affairs Division of LeadBuilder.
• IndexNow (instant crawl notification)Push index-eligible Doozer URLs to Bing/Yandex the moment they cross the quality gate, so fresh and changed pages get crawled in hours instead of weeks. Bing-first hedge against the Google scaled-content classifier that cliffed our largest root.
• Jev, the fast deciderA typed-decision model (TypeSafe AI "System One") wired in as a cache-only, never-blocking decider for live pages. It picks; it never writes.
• Lead Capture (the revenue pipeline)How a visitor's message or call becomes a routed, deliverable lead — the shared nbmn_lead_requests pipeline, auto-routing, no-email self-heal, and LeadBuilder handoff.
• LeadBuilder (the lead-intelligence platform)Where every captured lead, call intent, and cross-site referral flows to become revenue — the sibling product that turns Doozer traffic into qualified leads.
• Live CompositionA business page reorders its sections for the moment it is read (closed now, mealtime, an urgent trade on a phone), never changing what the page says, measured by a site-split experiment.
• Live Music Tonight (livemusictonight.com)A demand-sensing live-music discovery directory built on the Vertical Directory engine, fed by the Ticketmaster/Marquee feed, that captures visitor interest as a graph to decide which venue sites to build next.
• Magellan and the feed pond — bound IDs turn sites into living entitiesThe business_id_map spine (built v2.2.549) plus the feed adapters that hang off it. A bound external ID is what lets a generated page carry current, authoritative, self-maintained content instead of static prose.
• Marketing (build in public)The composer that drafts social posts from real platform signals in the founder's voice, and the auto-draft review queue.
• Money Clouds (affiliate vertical directories)Generalizing the Live Music Tonight pattern — any niche with an affiliate feed becomes a revenue-share vertical directory, bound across APIs by Magellan.
• NearByMeNow (the traffic + directory layer)The public "what's near me" surface that indexes the whole fleet, drives visitors back to business sites, and captures demand as leads.
• Network Growth — "More places nearby" (build-on-tap, gated)How the network grows organically from real local intent — visitors spin up the next site — and the two per-root guardrails that keep that growth clean.
• Niche matching and live discovery
• Per-Location Data Enrichment (the true voice of a place)Site voice is signal-in, signal-out. Every per-location signal (reviews now; events, gatherings, check-ins, comments, photos coming) enriches the location site, the database, AND every downstream consumer of the Doozer Data pipeline.
• Per-User Location HotspotsA derived projection of a signed-in user's primary/secondary location centroids (home/work) from their own signals, used to personalize near-me defaults, reminders, and the Digest.
• Postcard targeting (the Postcard Queue)Who deserves a paid claim postcard — exclude committee-orgs and franchises, rank owner-operated marketing-spenders.
• PostcardsThe living-story system. Short or long dispatches that tell Doozer's WHO/WHAT/WHEN/WHERE/WHY/HOW/VISION, stamped to the moment they were written.
• Promo Codes + the one-time claim offerReusable Stripe-backed discount codes (the promo generator) and the truly-one-time Doozer+ 50%-off-for-life offer shown on claim. Money-safety, single-fire, and how they map to Stripe coupons.
• Prospector (discovery + demand-driven growth)How Doozer finds new businesses to build — the Grand Opening Finder, Cloud Radar, and the hybrid Google Places discovery engine.
• Regeneration + Foundation (keep 2,400 sites fresh and safe)The unified regeneration engine, version stamping, and staleness detection that let the whole live fleet be improved without taking anything down.
• Shortlinks + QR routing (doozer.link)Dynamic short URLs at doozer.link. The code encodes doozer.link/<slug>; the destination is editable, so a printed QR can be re-pointed without reprinting. The routing layer for the observed-world lead flywheel.
• Shortlinks and QR (doozer.link)One permanent, claim-aware doozer.link + QR per site — the printed asset that flips from the claim page to the real site on claim.
• Source-of-truth cache (read the real website)A business's official website cached as markdown (Jina Reader) — the accuracy foundation for enrichment; enrich content, never overwrite location.
• Thanks.io Connector (direct mail, two-way)How Doozer sends physical mail via Thanks.io and feeds the results back into intelligence — claim postcards, radius audience buying that reverse-engineers new sites, and delivery/scan webhooks.
• The /now surface and the dense directory — the app NearByMeNow already almost wasOne button, the nearest real places, and Build-it-on-the-spot. Plus the measured teardown of the category page that was hiding its own businesses behind 855px of controls.
• The Architecture (one file, unlimited sites)How a single index.php serves every business site, root directory, Cloud, and NearByMeNow page in the network by detecting the host and routing the request.
• The Chamber Chamber
• The Doozer App design system (the family, in your pocket)The native app's tokens and components, derived from the Doozer family skeleton (includes/doozer-family.php) and The One's own semantic set (includes/business-app.php), translated to iOS and Android. Includes three contrast findings that also apply to the web.
• The Doozer Brand System (ecosystem identity kit)The canonical design identity for the whole Doozer ecosystem. Every human-authored surface (doozer.work, claim/auth/admin, roots, LiveMusicTonight, GoHe.re, Wuz.ai, AwesomeAddresses) shares one skeleton (neutrals, type, chrome, voice) and varies only its accent hue, so the network feels like one building with differently-lit rooms. Use this to build production-ready UI fast and on-brand.
• The Doozer FlywheelHow Doozer, NearByMeNow, LeadBuilder, and Prospector reinforce each other into a self-feeding local-business engine.
• The Doozer Score — the Stick, the Tower, and the leverage between themOne tracked number for whether Doozer is getting cheaper and more valuable at the same time. Stick = cost of 100 sites, Tower = replacement value of 100 sites, Score = Tower / Stick.
• The Growth Engine — observe → serve → convert → learnThe map of Doozer's acquisition + monetization machine. How observing a business, painting it a real site, sending it leads, tracking every touch, and making the RIGHT offer at the RIGHT moment turns into revenue — and how the intelligence layer decides who to reach, how, and when. The purpose, the smarts, and the wiring, with links to every component.
• The Menu FinderWhen a real person visits a restaurant page with no menu, Doozer reads the restaurant's own website for it, for free, and stages what it finds for review. Nothing goes live until approved.
• The Muse SystemDoozer's AI-driven design engine — palette, typography, layout, and section variants that make each business site its own.
• The Muse v2 layer, and the brief that feeds it
• The Network (the whole Doozer ecosystem)A map of every product in the Doozer world and how they interconnect into one referral loop, so an AI can see the breadth of the platform at a glance.
• The Niche Color SystemOne source of category color for the whole network — the design primitive that makes cards, pills, spines, and markers coherent across every surface.
• The Photo Pipeline (harvest, store, serve)How business photographs are referenced from Google, bought once on first view, stored as objects on DO Spaces, and served back through a predictable cache key that lets any page ask "do we already own this?" before spending.
• The Section FrameworkHow a business page is assembled from pipeline section slots and per-variant partials a Muse selects.
• The Shared Business CardThe one card renderer used across NBMN, cloud, and root directories, with a pluggable toolbar and category-aware call intent.
• The Weather WidgetA non-intrusive "plan your visit" weather card on business sites — current conditions plus a 7-day forecast for the business's own location, free by default.
• Town Trivia and the Doozer Games menuDoozer Games' second game, built only from what Doozer knows about real places near a town, and the TV home that lets a room move between games. How a question stays true and fair, and what the data taught.
• Two gates, and the category catalog
• What a directory page costs (and how to measure it)Where the time goes when a NearByMeNow directory page misses its cache, the floor no clause can beat, why page and filter variety defeated the cache, and how to time a statement on the live database without guessing.
• Winner stays (Doozer Games' 1-on-1 house rule), Four in a Row and ReversiThe reusable rule for any 1-on-1 game on a Doozer Games TV (champion, challenger, a line, rematch), kept apart from the game so the next 1-on-1 game is only its rules and its board. Four in a Row and Reversi are built on it.
• event-feeds
• machi

Craft

• Category-aware call intentThe tap-to-call chips are tailored to why you'd actually call THIS kind of business — reserve a table at a restaurant, get a quote from a plumber, check if the car is ready at a shop.
• Cross-root identity without third-party cookiesOne login has to work across doozer.work, nearbymenow.com and every other root — but third-party cookies are dead. So identity rides a first-party token handoff, not a shared cookie.
• Decision vs delivery (the muse was almost never the problem)Nine defects found in one week where the design system chose well and the render layer quietly discarded the choice. The shapes these bugs take, why they never error, and how to find them.
• Derive the URL, don't trust the stored domainA saved business's link is always computed from the business's currently-active domain, never read from the domain id we stored when it was saved — because that stored id goes stale and poisons the link.
• Fix the source, never trap the symptomWhen the output is wrong, fix what produced it — the prompt, the data, the generator — not the output. No filters, no gates, no find-and-replace patches on the way out.
• Inline the bytes, never the proxy URLWhen handing an image to an AI provider, send the actual bytes from our side. Never hand it one of our own proxy URLs to go fetch — that is a timeout and a token burn waiting to happen.
• Price the pull before you pullA data refresh is a bill. Before re-pulling from any paid source, check what each pull costs, reuse the cache, dry-run the total, and pull only the unavoidable remainder.
• Self-healing email backfillI tried last week and it didn't work. I tried today and it works." The site quietly tried harder to find the business's contact email because it noticed the same person kept coming back.
• Skeleton first, index laterShow the visitor something instantly; show Google nothing until the page is actually good. Two different audiences, two different clocks.
• The distraction problem (teach without nagging)How do you explain "this is your listing, and here's how to manage it" to the one owner who needs it, without cluttering the page for the thousand visitors who don't? Tier the education by how much the reader has signaled they care.
• The hostile CSS environmentEvery shared component treats the page it lands on as an adversary, because the muse's own AI-authored CSS is actively trying to restyle it.
• The logo knows its own shapeA business logo is measured, not assumed. A square transparent emblem, a wide wordmark, and a tall banner each get different treatment, because one layout cannot flatter all three.

Processes

• Content Generation and HealingHow AI site content is generated, why it sometimes fails, and how it is retried, backfilled, and healed.
• Site CreationHow a domain becomes a live business site — resolve the place, persist the business, pick a Muse, queue content.
• SpotcheckA repeatable audit of three live sites — agent surfaces, structured data, design, copy, UI/UX and data accuracy — that separates live defects from legacy drift and reports per-site plus network-wide.
• The model handoffHow one model version hands Doozer to the next — the tradition, the ritual, and the artifacts that carry continuity across upgrades.

Glossary

• CloudA criteria-based directory assembled OVER existing business sites (a town, a niche-in-a-state, a personal collection).
• Family (Design Direction Family)A hand-authored designer recipe the Muse auto-generator draws from, tagged by which niches it suits.
• MuseA per-business design recipe (palette, type, layout, section variants) applied at render.
• NicheA business category slug; the unit of directory grouping and recommendation. Maps from Google place types.