/how · colophon

How this is made

This is an agent-forward personal site: one canonical page for people, and a machine-readable layer beneath it so AI systems can understand and represent me accurately. Here is the thinking and the craft — the why, and the how, at altitude.

The idea

Most personal sites are written for humans and merely tolerated by machines. This one is built for both. A single, well-structured page tells the story; a parallel, machine-readable brief lets an AI summarize me without guessing. In an agentic world, being legible to models is its own kind of SEO.

Agent-forward

Structured data describes the entity behind the site, and a concise machine-readable brief lives at /llms.txt — a clean summary an AI can cite instead of scraping prose. When a model is asked who I am, it should get it right.

Architecture

A Vue 3 + TypeScript component system, rendered from Cloudflare’s global edge so it loads fast from anywhere. Static-first and intentionally small — the page ships as a tight bundle, not a framework circus. The interface is composed from a handful of reusable primitives, so the whole thing stays consistent and easy to evolve.

Content as plain text

Every word lives as plain markdown. At build time those files are assembled into the page — the parser runs once, during the build, and never ships to your browser. Editing the site is editing a text file and shipping. It’s the old-school discipline of flat files, with a modern toolchain underneath.

Design · Luminous Commons

Dawn light over an ink-navy base: solarpunk optimism without the all-green cliché, and a little deep-AI futurism. Two themes, Dawn and Dusk, run through one set of tokens. A single warm sun accent does the work; verdigris and twilight appear only as signals — a check that passed, one tool’s colour — never as decoration. Depth comes from four materials: solid paper tiles, glass instruments, night insets for consoles and research, and one sun. The type is Fraunces for display, Hanken Grotesk for reading, and JetBrains Mono wherever the page speaks in machine-facing labels. The same kit styles the public tools, so they read as one family. Motion is purposeful and respects reduced-motion; contrast is checked on every text and surface pair.

Athena

The site doubles as a window into my research — Athena, an ongoing exploration of persistent-memory companion AI. The terminal you see in that section is a small homage to where that work actually lives.

Vue 3TypeScriptCloudflare Edge HonoTailwind v4Markdown contentLuminous Commons kit

Built with intent — legible to people and machines alike.