Hero framing exploration · 2026-05-21

Picking the right framing.

An observation-led preamble (00) followed by nine candidate heroes (01–09). Each candidate tries a different angle — discipline, outcome, comparison, question, plain-English on-ramp — with its own copy, layout, and background. The preamble is designed to sit above whichever hero wins; the heroes are designed to stand alone. Scroll, pick winners. Previous landing (v10.15) preserved at 94c3802.

00 · preamble

Observation-led preamble · designed to sit above any hero

Observation: HTML has emerged as a key substrate* for AI-assisted work.

* I know, I know — "substrate" is overused.

Two leading voices, same direction:

Markdown has become the dominant file format used by agents to communicate with us. But as agents have become more and more powerful, I have felt that markdown has become a restricting format. I've started preferring HTML as an output format instead of Markdown — and increasingly see this being used by others on the Claude Code team.
— Thariq Shihipar · @trq212
at the end of your query ask your LLM to "structure your response as HTML".
— Andrej Karpathy · archive

So the question becomes: what do you do with all that HTML?

Scroll the framings ↓
01 / 09

Discipline · research-led

A discipline for HTML artifacts.

AI tools emit HTML by default. Capsule is the contract that makes those artifacts durable, inspectable, and re-readable years from now.

Read the spec → View on GitHub
12rules
5required blocks
0network deps
02 / 09

Outcome-led

Sealed HTML. Built to last.

One file. No network. Built to be re-opened years from now — by humans, and by the LLMs they ask to continue the work.

Read the spec →
03 / 09

Substrate · question

HTML is the substrate. Now what?

An open spec for what to do with the HTML that AI tools already give you — so it survives the chat it was born in.

Read the spec →
04 / 09

Contract · interop-first

A contract for HTML artifacts.

Manifest. Provenance. Integrity. No network. The same envelope whether an LLM, a build script, or a human writes it.

Read the spec → Full spec
05 / 09

Max-short · benefit-led

HTML you can keep.

Sealed. Self-contained. Provenance-bearing. One file you can email, archive, or fork.

Read the spec →
06 / 09

Comparison · familiar anchor

Like a PDF, but inspectable.

PDFs are sealed and closed. Capsules are sealed and open — programmable, inspectable, re-renderable. The HTML profile for work worth preserving.

Read the spec →
07 / 09

Visual-led · brand-first

HTML Capsule

A profile of HTML for sealed, self-contained artifacts. One file. Twelve rules. Zero network.

Read the spec →
08 / 09

Problem · why-this-exists

Where does AI's HTML go?

Capsule is the discipline that makes AI-generated HTML durable, inspectable, and shareable beyond the platform that produced it.

Read the spec →
09 / 09

Context-led · plain-English on-ramp

HTML you can keep.

AI tools increasingly produce HTML: reports, maps, demos, dashboards, visual notes, and interactive documents.

HTML Capsule is an open spec for saving that work as one self-contained .html file. A Capsule includes its own content, styles, metadata, provenance, and validation rules, with no required network access.

It is not a new file format. It is a stricter way to package HTML so the work can be archived, shared, inspected, and continued later — by humans, tools, and LLMs.

One file. No network. Built to last.

Read the spec → View examples
About this page · exports · manifest

This page is itself a Capsule per Core v0.3.0 (full spec v0.3.4). Five required blocks, all inline. No network, no analytics. Validates against the reference validator. Mode: hero_framing_exploration — the eight numbered sections above are candidate framings; this layout is temporary.

Manifest

Loading manifest…