Design, code and AI, in one workflow

I run some of my recent projects with AI agents. I frame, pilot and rough out the design. Then the agents build the project and write the code, through successive iterations, and I review and polish it. Here are five steps of my workflow, shown on three different projects, to illustrate the tools I used and the frictions I fixed along the way.

My favorite environments
  • Figma
  • Claude Code
  • Claude
  • Claude Design
  • Notion
  • GitHub
  • Vercel
  • Next.js
  • Astro
  • Tailwind CSS
  • Gemini
  • Datadog
  • Umami

Framing

Before any code or design, I decide what the project is, who it is for and where it stops. Then I turn that into a rulebook and skills that every agent session starts from.

Researching

I research until I can write constraints that the design and the agents must respect. The result is a written constraints document, not a pile of references.

Designing

Wireframes come first and fix the structure and states of each screen. The design system lives in one place that the code reads, the design tokens, and is never hardcoded in components.

Building

I write the brief and the acceptance criteria, then review. I check every result in the product itself, not only in the code. When an agent gets something wrong, the lesson becomes a rule.

Testing and releasing

Before pushing a change made by an agent to production, I test it on a secondary branch. I run a quality assurance review, the design QA, comparing the coded version with my design. I log each gap as a comment, through Vercel or GitHub, to turn them into backlog tasks.