Free Lesson
How to write a Design.md File
60 min
Aug 1, 2026 3:00 PM
Virtual (Zoom)
In this video
What you'll learn
Write token frontmatter
Draft a valid YAML block defining your tokens so the system can understand them.
Map semantics to tokens
Pair human rationale with machine-readable values so they are in agreement.
Spot design drift fast
Diagnose where your design decisions scatter today and what that quietly costs.
Test against an agent
Hand your file to an AI tool and it can read exactly where it had to guess.
Why this topic matters
Design is now built by more than designers — engineers, agents, and AI tools all reach for the same decisions, and they can only use what's written down. The teams pulling ahead are the ones whose visual identity lives in one readable, versioned file instead of a dozen tools that quietly disagree. Learn to author that file and your intent survives every handoff and every session,
You'll learn from
Patrick Neeman
Sr. Principal UX Designer