Same loop every time, whether it's a weekend build or a client engagement. AI runs through all of it, not bolted on at the build step. It isn't a mood. It's a sequence, and I can teach it.
-
01
Analyse
User research, analytics, support tickets, industry reporting, all of it in at once. Claude synthesises across sources faster than I can read them. Then I argue with what it found until the pattern holds up.
-
02
Frame
Two or three core problems come out of that, written as problem statements. Not features. If I can't say who's stuck and what it costs them, it isn't a problem yet.
-
03
Prioritise
Each statement scored on business impact, customer impact and technical cost. Claude makes the case both ways, I make the call. The score isn't the decision. It's what makes the decision arguable.
-
04
Brief
A PRD for the top three. Problem, users, scope, out of scope, success measures, edge cases. Everything downstream runs on this document, so it's the one I spend real time on.
-
05
Context
Before anything gets generated, the repo gets its context. Brand, business rules, design principles, and a file that maps the design system to real components. The model is only as good as what it's standing on.
-
06
Ideate
Rapid divergence against the brief. Claude and the Figma MCP put up directions in an hour that used to take a week, and most of them get binned. They come out as working screens rather than pictures of screens, so the narrowing happens against something real.
-
07
Build
Claude Code, working to the PRD and the .md files rather than to a chat prompt. Same guardrails every time, which is what makes the output predictable instead of lucky.
-
08
Review gate
A separate agent reviews the build against the principles file and the acceptance criteria in the PRD before I do. It catches the drift I stop seeing after the fourth hour.
-
09
Ship and learn
Small, early, to real users, instrumented from day one. Cut what nobody touched, sharpen what they did, then take the data back to step 01.
Steps 01, 04 and 07 are where the model does the work. Steps 02, 03 and 06 are where I do. Getting that split wrong is how a team ships confident nonsense at speed.
The context layer
Prompts are disposable. Context is an asset, and it's the part a team can actually share. Every build starts from the same set of files sitting in the repo.
- brand.md
- Voice, tone, and the things we never say.
- design-principles.md
- Calls already made, so they don't get re-argued screen by screen.
- design-system.md
- Tokens, components, and what maps to what in code.
- business-rules.md
- Logic, constraints and edge cases that hold true regardless of screen.
- prd.md
- What this specific build is, and what it isn't.
- CLAUDE.md
- How the agent behaves in this repo. What to check, what to never touch, how to verify.
Writing these is the slow part, and it's the part that pays. The first build takes longer. Every build after it starts from a model that already knows the brand, the rules and the system, which is why the second one is fast and the tenth one is consistent.
The failure mode is real and I've hit it. Files go stale, the model keeps building confidently against last quarter's rules, and nobody notices until review. So each file has an owner and gets checked at the same gate as the code.
How I decide what tools earn a place
Written so another team can run it without me in the room. That's the test of whether it's a process or a preference.
-
Name the job, not the tool
One sentence on the job to be done and who's currently doing it the slow way. If I can't write that sentence, I'm shopping, not solving.
-
Rebuild something you've already built
Take a piece of work the team has already shipped the old way and do it again with the new tool. Document it and time it, then put that against what the first run actually cost. A benchmark beats an opinion.
-
Set the adoption bar before you start
It has to beat the current path on the measure we agreed, and a second person has to reach the same result from the written instructions. One person's magic isn't adoption.
-
Kill criteria and a review date
Both set on day one. If it hasn't cleared the bar by the date it goes, and I write down why, so nobody reopens the argument in six months.
Things I've killed on this basis: v0, Lovable, Bolt and Windsurf, among others. Each one was worth the two weeks it took to find out.