The whole thing fits in one picture.
Start here and never lose the thread: a production plane of agents makes greetings into a shared catalog; a control plane lets a human watch, gate and pause; a serving loop turns the catalog into each person's morning; all of it runs on Cloudflare. Every page below is a zoom into a region of this same picture. Hover a region; click to zoom.
Three things to know before zooming.
The zooms.
Top-down: stop at any level and you still hold the right picture.
- zoom 1ArchitectureTwo planes, one spine, a human can pause anything.→
- zoom 2CloudflareEverything Cloudflare — the substrate drawn from the IaC, not by hand.→
- zoom 3AgentsOne anatomy for every agent; every model is a config value; the workbench — tools, full prompts, traces.→
- zoom 4QAWhy QA exists and how the QA Agent is built.→
- zoom 5ToolingHow the tools connect — and how this repo is itself built by agents.→
- zoom 6FeedDiversity is the objective; the LLM writes the policy, never serves the feed.→
- zoom 6Data & privacyState · stream · features, and DPDP as architecture.→
- zoom 7Starter kitKarkhana — hand it to your coding agent.→
Go deeper
In the repo
- docs/SYSTEM-DESIGN.md
- docs/ARCHITECTURE.md
- agents/* · services/* · apps/* · packages/* · infra/