VMD Document

Visual Decision Room

format: product-design-brieftheme: system-specaudience: founder-designer-builderfidelity: visualsurfaces: browser-page deck pdf design-handoff

Replace The Design Deck With A Living Source

decision-room

claim

One VMD file can become a visual web page, a presentation deck, a PDF report,
and a design handoff without losing source meaning.

evidence

The source names the decision, the evidence, the layout, the visual system,
and the fidelity boundaries before any renderer draws pixels.

PPT

deck frames become slides

PDF

report same source, fixed output

Design

spec tokens and components

Web

page browser-native render

visual-proof

The Output Still Has To Feel Designed

style tokens

ink #0f172a editorial text

accent #0f766e decision signal

surface #ffffff document surface

highlight #f59e0b visual proof marker

matrix

light document -> high-fidelity artifact

top leftVMD design brief

top rightgenerated design board

bottom leftMarkdown outline

bottom rightone-off HTML or slide file

editable source -> designed output

AI-readable source

The model edits intent, hierarchy, state, and evidence instead of chasing
every DOM node or slide object.

Human-grade visual output

The renderer makes the artifact feel like a polished report, deck, spec, or
browser-native document.

artifact-surfaces

One Source, Multiple Artifact Classes

Presentation

Slides are a view over frames, not the only editable source.

PDF report

A fixed artifact can be generated after semantic validation.

Design file

Tokens, components, states, and decisions remain upstream from handoff.

Browser page

HTML and CSS stay the render target, not the mandatory authoring surface.

timeline

1AI drafts editable VMD source slots
2Renderer creates a polished visual artifact
3Reviewer edits the VMD source, not scattered output objects
4Exporters produce web, deck, PDF, and design-handoff surfaces

preserve-island

Preserve The Hard Part Without Making Everything Raw

Preserved design fragment

This region can keep exact HTML/CSS while the rest remains semantic.