Build Log / Walkthroughs / 001 — Idea to Live
v 1.0 2026-05-09
A workflow · in four steps

A simple workflow for prototyping app ideas, end to end.001

A short, repeatable loop for taking an app idea from a sentence to a working prototype — chat, design, code, all inside Claude. This is how each step works, what it produces, and how it hands off to the next one.

Step 01
The idea
Brain
Step 02
Ideation & brief
Claude Chat
Step 03
Design & mockup
Claude Design
Step 04
Build & run
Claude Code
01
of 04
Step 01 · Origin

Start with the idea, not the tool.

Every loop starts the same way: a single sentence on a notepad. No spec, no wireframes, no stack decisions — just the rough shape of an app idea and a hunch it's worth a quick prototype.

Fill in
The original idea, in your own words. One or two sentences is plenty — the looser the better, because the next step is where it gets sharpened.

The temptation here is to jump straight into building. The reason this workflow has three steps before code is that each one clarifies what comes next. Skipping the upstream steps usually means paying for them downstream in rewrites.

Photo 01 Drop the original note, sketch, or screenshot here Suggested: 16:9 — the napkin sketch or Slack message that started it
FIG 01The starting point — before any tool gets involved.
02
of 04
Step 02 · Ideation

Talk it through in Claude Chat.

02
Pressure-test the idea, then write a brief.
Tool · Claude Chat
In progress

Chat is where rough ideas get pulled apart and put back together. The goal of this step isn't a finished product — it's a brief sharp enough that the next tool in the chain (Design) can actually act on it.

The pattern is simple: describe the problem out loud, then ask Claude to play it back. That alone tends to surface two or three assumptions that haven't been spoken yet. From there it's a back-and-forth — who is this for, what's the one job it has to do, what does success look like in the prototype.

What to ask for

A short brief covering audience, the single primary action the prototype should drive, the tone of voice, and a rough content outline. Nothing about colors, layout, or stack — those are deliberately downstream decisions.

Fill in
Paste the actual prompt you opened the chat with, and the brief Claude produced at the end. Both are useful — the prompt shows the seed, the brief shows what came out the other side.
Photo 02 Screenshot of the Claude Chat conversation Suggested: a long thread, or the moment the brief was finalised
FIG 02The chat thread that turns an idea into a brief.

The point of the chat step isn't to write the answer — it's to find the question.

Working note

What the step produces

  • a.A one-paragraph description of the audience and the job the prototype does for them.
  • b.The single primary action — everything else sits in service of this.
  • c.A content outline — sections, in order, with one line of intent each.
  • d.A short tone-of-voice note — a few words on how the copy should feel.

That brief is the artefact that hands off to the design step. If it's vague, design improvises — and improvised design is hard to undo later.

03
of 04
Step 03 · Design

Hand the brief to Claude Design.

03
Turn the brief into something you can look at.
Tool · Claude Design
Iterating

Design is the first time the idea has a body. It stops being words and starts being a layout, a typeface, a colour, a rhythm. The brief from the previous step goes in almost verbatim, and the first pass comes back fast.

What Claude Design produces isn't a static screenshot — it's a working HTML mockup you can poke at. That changes the conversation. Instead of debating "should the headline be bigger?" in the abstract, you ask for it bigger and see.

How to drive it

Start broad — a few different visual directions side-by-side — and converge once one feels right. From there it's small, specific edits: tighten the hero, simplify the nav, swap out a pattern that isn't pulling its weight. Every round takes minutes.

Fill in
Add a sentence or two on which direction you picked and why. This is the most interesting decision in the whole chain — it's where taste shows up.
Photo 03a Early direction A An option that was explored and set aside
Photo 03b Early direction B Another option that was explored
FIG 03A couple of directions Claude Design generates before one is picked.
Photo 04 The chosen mockup, full-bleed Suggested: a clean screenshot of the final design pass
FIG 04The direction that makes it through to the build step.

Why this step is in the loop

Sending a brief straight into a code tool works — but the result tends to be generically nice, and the rest of the day disappears into tweaks that are hard to picture in the abstract. Designing first means that by the time code starts, the visual decisions are already made and visible.

Design isn't decoration here — it's the contract between the idea and the build.

Working note
04
of 04
Step 04 · Build

Pass the design to Claude Code.

04
Turn the mockup into a working prototype.
Tool · Claude Code
Running

The handoff is where the earlier steps pay off. Point Claude Code at the design, name the stack, and let it scaffold the project. Because the design is already settled, code's job shrinks from "invent a prototype" to "build this specific thing" — which is what it's good at.

What the handoff looks like

A short prompt with the design attached, the framework choice, where the prototype should run, and any content that needs wiring in. Claude Code takes it from there — sets up the project structure, writes the components, and runs a local preview to click through.

Fill in
Stack details: framework, hosting, any integrations. And — if you remember — the actual prompt you used to kick off the build. Readers always want to see the prompt.
Photo 05 Terminal or IDE view of Claude Code working Suggested: a moment with files appearing or commands running
FIG 05Claude Code mid-build — turning the mockup into a real codebase.

Where to steer it

Code isn't fully autopilot. There are a handful of places worth stepping in — judgment calls that benefit from a human looking at them once. Component structure, accessibility, and a couple of copy tweaks that only make sense once the prototype is real.

  • a.Component structure — a quick look to make sure it'll be nice to live in.
  • b.Responsive behaviour — resize the window, fix the places it breaks.
  • c.Copy in context — rewrite the lines that read fine in the brief but feel off on a real page.
  • d.Run it — a local preview, or a single command to share a link.
Photo 06 The live site, shipped Suggested: a clean screenshot of the deployed page
FIG 06The output of the loop — a real, working prototype.
Fill in
Drop the live URL here, plus anything you'd want a reader to click on first.
Reflection
Notes

Why the loop has four steps.

Three tools, three artefacts, one prototype. The interesting part isn't speed — speed is the obvious one. It's that the final result tends to be sharper for having gone through three deliberate handoffs instead of one long prompt.

  • 01Each step has one job. Chat clarifies, Design decides what it looks like, Code builds it. Nothing does two jobs at once.
  • 02The artefacts are the contract. A brief, a mockup, a codebase — each one concrete enough that the next step can act on it without guessing.
  • 03The human stays in the loop. Every handoff is a natural review point. You're not approving 5,000 lines at the end — you're approving a brief, then a design, then a build.
  • 04It's faster, but that's a side effect. "Fast" stops trading off with "considered". Both hold because the considering happens upstream where it's cheap.
Fill in
Anything you'd add about how this fits into how you already prototype — or where it doesn't.

The tools keep changing. The shape of the loop — idea, brief, design, build — doesn't seem to.

End of post
That's the loop. Four steps, three tools, one prototype.