Working Surfacelink · 9 Oct 2026
05
A shopkeeper seen from behind at a shop counter, drawing a rough sketch of a screen on paper with a closed laptop set aside, the whole scene drawn with wide empty margins on every side.
ElGuerre

Why design before code when an AI agent builds the screen in minutes: sketch, mockup and prototype

Juanlu ElGuerre · 8 October 2026

How-to · prototyping · design systems · Decision records

Read the original
Takeaway

Juanlu ElGuerre, building an ecommerce platform with an AI agent, designs each screen before any code and found three conflicting rules by sketching a review screen first.

Summary

Juanlu ElGuerre is a developer building Tendero, an open-source ecommerce platform, with the AI coding agent Claude Code. In the first week he skipped design, and the screens that shipped worked but did not look like a shop. He now fixes the design system first, then a rough sketch, a mockup and a clickable prototype, before any code.

Key points
  • He sketched a screen where a person approves or rejects product claims that an AI model extracted. The sketch exposed three rules that contradicted each other before any code existed.
  • The rule that colours come only from the design token file had no test for five days. A later check found 575 hand-written colours in two design files that the test never read.
  • The AI agent reads the instruction file CLAUDE.md at the start of each session. It opens a written decision record only when a rule in that file names the record by number.
  • His prototypes use real catalogue data. One showed a wok described as carbon steel but recorded as stainless steel.
Implication

A team building with an AI agent can sketch a screen before coding to find rules that disagree, and can turn each design rule into an automated test. This is an inference drawn from one developer's account of his own project.

Plays
Design

Sketch a screen in rough grey lines before any code, and check whether the rules written for it contradict each other.

Engineering

Turn each written design rule into an automated check that blocks a code change breaking it, for example a colour typed by hand where a named design-system colour belongs.

Derived by Working Surface from the article; more in the Playbook. Source line: This is the real reason to sketch: it is the cheapest place to find out that your rules disagree with each other.

Source issue

9 October 2026: when AI agents take on routine work, teams write down in advance what a person still decides, put those rules where the agent reads them, and keep the people who approve able to understand the work.