Blog
Technical articles about DESIGN.md, design systems for AI agents and vibe coding.
All posts
Real Brands: design systems from real companies your AI agent can read
22 Brazilian brands documented in the DESIGN.md format. No other catalog has them. Now designmd.app does.
DESIGN.md + AGENTS.md + RULES.md: which file does what
The definitive map of context files for AI agents — DESIGN.md, AGENTS.md, RULES.md, .cursorrules, CLAUDE.md. Know exactl…
DESIGN.md at scale: when tokens aren't enough (and what to add)
DESIGN.md solves visual tokens but AI agents still guess component behavior. Here are practical extensions to take your…
Beyond tokens: teaching your component library to AI agents with DESIGN.md
Tokens are just the first step. Learn how to document components in DESIGN.md with slots, variants, and anti-patterns so…
Cursor Rules vs DESIGN.md — What Goes Where?
Cursor rules control how your AI agent behaves. DESIGN.md defines what it designs. Here's the architectural split and ho…
Design Tokens vs DESIGN.md — Complementary or Competing?
Figma design tokens and DESIGN.md solve different problems. One feeds build pipelines, the other feeds AI agents. Here's…
How AI Coding Agents Read Your Design System (And Why Most Get It Wrong)
AI coding agents can't extract design tokens from screenshots or raw CSS. Here's how DESIGN.md gives them parseable, per…
Minimalism vs Maximalism in 2026 — Which Design System Wins?
A practical comparison of minimalist and maximalist design approaches for AI-generated interfaces. When to use each, wit…
Glassmorphism vs Neumorphism vs Flat Design — Choosing a Visual Language for AI Agents
Three dominant UI aesthetics compared through the lens of DESIGN.md. Which one produces the most consistent AI-generated…
AI-First Design in 2026 — Why Your Agent Needs a Design System File
AI agents generate UI faster than ever, but without a DESIGN.md they produce inconsistent results. How AI-first design w…
Dark Mode vs Light Mode — How to Handle Both in a Single DESIGN.md
Most design systems pick one mode and bolt on the other. Here's how to build a DESIGN.md that handles both without doubl…
Anti-Design and Brutalism 2.0 — When Breaking Rules Is the Design System
Brutalist web design is back in 2026, but smarter. How to encode intentional chaos into a DESIGN.md without confusing yo…
How to Use DESIGN.md with Cursor — Complete Setup Guide
Configure DESIGN.md in Cursor for consistent AI-generated UI. Step-by-step setup with .cursorrules integration and pract…
How to Create a DESIGN.md from Scratch
Step-by-step guide to writing a DESIGN.md file for your project. Define colors, typography, spacing and components in Ma…