Vibe Coder · Unit 6: Thinking in Products · Project
Milestone 6 of 16
Your product spec
The problem, the people, the first version and how you will measure it.
One product, built in sixteen steps
Vibe Coder has one project. You pick an idea in Unit 1 and every unit adds a piece to it, until Unit 16 launches it. Most first products fail by being too large. This milestone fixes the problem, the people and the smallest version worth building, and chooses the one number that will say whether it worked.
- 1Your builder’s kitA one-line product idea, your role, and five working accounts.
- 2A fact-checked product briefOne page on your idea, tested against how the models really behave.
- 3Your product project in ClaudeA project with instructions and files, and your first real piece of work from it.
- 4A brand kit and research fileA name, images and market research for your product, with a second opinion.
- 5Your prompt libraryThe prompts you will reuse to build the product, each one tested.
- 6Your product specThe problem, the people, the first version and how you will measure it.
- 7A clickable prototypeA version people can click through, shown to three of them.
- 8The first working versionYour app running on your computer, built with Claude Code.
- 9Your Claude Code setupProject instructions, a custom command and a skill made for your app.
- 10One AI featureA feature in your app that calls a model, with its key kept safe.
- 11An automated workflowYour app connected to a tool you already use.
- 12Sign-in and saved dataAccounts and a database behind your app.
- 13A tested, locked-down appEvery flow checked, and each person able to see only their own data.
- 14A launch videoThirty to sixty seconds, with voice, music and sound.
- 15Your app, liveOnline at its own address, updating every time you save.
- 16Your launched productThe finished product, in front of people, with a page that shows your work.
You start with
Your prompt library
The prompts you will reuse to build the product, each one tested.
Milestone 5Your product gains
A spec: the problem, the people, the first version and one measure
That makes 6 of 16 pieces in place.
Your role
The steps change with your role. Choose yours to see your version of this milestone.
Start with this prompt
Paste it into Claude or ChatGPT, or into Claude Code once you are building. Fill in the parts in square brackets with your own product.
Here is my product brief and my research so far: [paste both] Help me write the spec for the first version. I want the problem in two sentences, one specific person it is for, the three things the first version must do, a list of what it will not do yet, and one success measure. Work with me one step at a time. Ask me one question, wait for my answer, then go on. Do not write the finished thing for me: show me a draft, tell me what is weak about it, and let me decide. Push back whenever I add something the first version does not need.
Build it step by step
6 steps, one from each lesson of the unit. Do each step after its lesson. A box you tick here is ticked in the lesson too.
Step 1 of 6 · from the lesson Start from a problem
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepYour product spec Write your problem sentence
Using your research and competitor gap, write your problem in one sentence. Read it to three people who might have it and note their exact words. Start a document called "Product spec" with the sentence and their reactions.
Done when
Everything else in the spec follows from this sentence.
Step 2 of 6 · from the lesson Who it is for
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepYour product spec Describe your first user
Write five lines describing the one kind of person your first version is for, using your interview notes. Add it to the spec, and update your project instructions with it.
Done when
From here on, ask of every feature: would this person use it?
Step 3 of 6 · from the lesson Scope it small
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepYour product spec Scope your first version
Write the one job in a sentence. Brainstorm features with Claude, then sort them into "Must have" and "Later". Aim for five must-haves or fewer and add both lists to the spec.
Done when
The must-have list is exactly what you will prototype.
Step 4 of 6 · from the lesson Write the brief
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepYour product spec Write your one-page brief
With Claude, turn your problem sentence, user description and scope into a one-page brief with the five headings. Test it on one person, fix what they misunderstood, and replace the old brief in your project files.
Done when
Keep this file current. It is the source of truth for the build.
Step 5 of 6 · from the lesson One success measure
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepYour product spec Set your success measure
Write your one measure, a target and a date. Add it to the top of your product spec, and add the sentence "We will know it works when..." to your brief.
Done when
Your product spec is complete: problem, user, scope, brief and measure.
Step 6 of 6 · from the lesson Prioritising
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepYour product spec Rank your must-haves
Score each must-have for value and effort, rank them, and write a one-line reason for each. Add the ranked list to the spec.
Done when
You will build in this order in Unit 8.
When it is done
Every box above is ticked, and you can show the result to someone who has not seen it before. Then move on: milestone 7 is a clickable prototype.