Free Lesson

How to write a Design.md File

Hosted by Patrick Neeman

Sat, Aug 1, 2026

7:00 PM UTC (1 hour)

Virtual (Zoom)

Free to join

119 students

Invite your network

Go deeper with a course

Using Generative AI to Design and Prototype for Designers and Product Managers
Patrick Neeman
View syllabus

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

A user experience leader and super-IC for design teams building out enterprise applications that incorporate generative artificial intelligence, traditional artificial intelligence and machine learning. Experience includes developing design thinking adoption strategies within organizations, the conception of new product lines, iteratively redesigning existing products to improve engagement through product led growth, and the implementation of design systems in distributed environments.

See all products from Patrick

Sign up to join this lesson

By continuing, you agree to Maven's Terms and Privacy Policy.