KHOWD™ · Code Made Beautiful™

Structure before syntax.

KHOWD is a visual language for software architecture. Typed nodes placed in three-dimensional space, joined by a small set of verbs. The same drawing reads three ways: as a system to a founder, as a spatial design to a designer, as a build specification to an engineer. Nobody has to read a line of code to understand it.

In build · the language and its renderer are complete · the editor is next

The renderer, running live. Nine primitives, ten connections, KHOWD’s own grammar. Drag to orbit, click a node to read it, pinch or ⌘ scroll to zoom.

Why it exists

Founders think in systems. Most of them do not speak syntax.

So the conversations that decide how their company is built happen in a language they cannot read. KHOWD moves those conversations into a form everyone at the table can hold: the diagram is the source, and the code is its translation.

The test: a founder reads a KHOWD diagram and understands the system, what it is, how it flows, what depends on what, without reading a line of code.

X
Flow · time

Left is where a request enters, right is the outcome. Reading across is reading what happens.

Y
Abstraction

Up is the surface people touch, down is the foundation and the data. Height is how close to the human.

Z
Dependency depth

Front is the critical path, back is what supports it. Orbiting the scene reveals what leans on what.

The node library

Nine shapes. Each one means one thing, always.

Shape encodes type and is never reassigned. Once you know the nine, you can read any system drawn in KHOWD.

PANE
the surface · Interface

What the human touches: frontends and interfaces.

CORE
the worker · Compute

Where work happens: servers, logic, functions.

VAULT
the vessel · Data

Where state lives: databases and stores.

GATE
the doorway · Network

Controls passage: gateways and load balancers.

DUCT
the channel · Messaging

An asynchronous channel: queues, pub/sub, streams.

WARD
the guard · Security

Verifies and protects: authentication, tokens, firewalls.

RELAY
the accelerator · Network

Speeds delivery: CDN, cache, edge.

WITNESS
the observer · Observability

Watches only: logging, metrics, tracing. Always off the flow.

BEACON
the trigger · Messaging

A non-human trigger: cron, scheduler, timer.

The colour law: the viewport and all chrome are colourless. The only saturated colour in a scene encodes a domain. Violet is security only, red is fault only, grey is observation only.

The connection grammar

Seven verbs for everything that moves.

Nodes are joined by verbs, not arrows. Line weight carries throughput and the speed of the particles carries latency, so a glance shows where the pressure is.

Flow

The caller waits: a synchronous request and response.

Signal

Fire and forget: an asynchronous event nobody waits for.

Tether

Structure only: a dependency with no live data.

Sealed

Trusted traffic, downstream of a WARD.

Broadcast

One source, many listeners: publish and subscribe.

Stream

Live in both directions: a WebSocket.

Fault

The unhappy path: an error or fallback. Red means this and nothing else.

Three readings, one artifact

Nobody translates. Everybody reads.

Founder

The system, and what it costs to change.

The lit flow path dominates. Observation hides. External services are labelled by name, so it is clear what you own and what you rent.

Designer

The spaces, and what belongs together.

Membranes and the system perimeter come forward. Flow dims to context, so structure and grouping can be judged at a glance.

Engineer

The specification, in full.

Every type, every protocol, the whole observation layer revealed. The same drawing, now read as a build.

Where it stands

Built in the open, one locked phase at a time.

Each phase is finished and locked before the next begins. Nothing below is claimed before it runs.

01
The visual language

Nine primitives, seven verbs, the colour law, the Heat system, three readings.

Complete
02
KHOWD drawn in KHOWD

Its own architecture mapped in its own grammar, every primitive exercised.

Complete
03
The renderer

All nine primitives in 3D, animated connections, orbit and select. It is running above.

Complete
05
Viewport and camera

The three axes built into navigation, focus mode, depth atmosphere.

Planned
06
The three readings, live

Founder, Designer and Engineer emphasis inside the 3D scene.

Planned
07
Authoring

Place, drag and connect nodes. Draw your own system.

Planned
08
Export and share

Images, shareable links and generated documentation.

Planned
The second instrument

The library. Code made beautiful, for your own commands.

Every builder keeps a private stack of commands they run again and again. The KHOWD library holds them: paste a command, and KHOWD highlights it, names it, files it by family and by the system it touches, and keeps it on the device it was saved on.

  • Named in one grammar: VERB → TARGET · CONTEXT.
  • Placeholders marked, so a command becomes a pattern.
  • Stored locally. Nothing is sent anywhere.

The library is in private use by its founder and opens to others later.

Owner sign-in
DEPLOY → CF PAGES · khowd

cd ~/khowd && npx wrangler pages deploy public --project-name {{project}}

BUILD → SITE · scaffold

mkdir -p ~/{{site}}/public

KHOWD is also a word: the weight that precedes the word. Read it here.