The problem nobody talks about in vibe coding

AI coding tools are fast. Genuinely impressive. But there is a pattern that keeps showing up: you describe your product, hit go, and what comes back is functional and completely generic. Right structure maybe. Wrong feel entirely.

The tools are not broken. The problem is context. You are asking AI to build something with taste before you have told it what your taste actually is.

What DESIGN.md actually is

DESIGN.md is a plain-text file. That is it. No special format, no code to install, nothing that requires a developer to set up. It captures your design identity: colours, typography choices, spacing rules, in a format both humans and AI can read without friction.

The format was introduced by Google Stitch, but it works across any AI coding tool. Cursor reads it. Claude Code reads it. Figma Make reads it. You drop the file into your project before you start, and the tool has full context before it builds a single screen.

Why this matters more than most people realise

Think about how a creative brief works. Before any designer touches a project, there is a document that explains the brand, the visual direction, the tone. It exists so nobody has to guess.

DESIGN.md is that document for AI. Without it, every project starts from the same generic baseline. With it, AI starts from your baseline.

For designers, this means your Figma decisions actually travel with the project instead of disappearing the moment an AI tool takes over. For developers who vibe code, it means the output looks considered rather than assembled.

How to start without building from scratch

A DESIGN.md file follows a consistent structure: overview, colours, typography, elevation, components, and a do’s and don’ts section. You can write one from scratch, but the faster move is to start from a template built for a style close to your product direction, then swap in your specific values.

Fifteen minutes of editing gives you a file that changes every AI build that follows. That is a good trade.

The file that changes how AI sees your product

The gap in vibe coding is not the tools. The tools are good. The gap is communication between what you want and what AI builds. DESIGN.md is one plain-text file that closes it.

Free open-source library of ready-to-use files launching at 02ui.kit.com/md. New files every week.