Vibe Coder · Unit 8: Building With Claude Code · Project
Milestone 8 of 16
The first working version
Your app running on your computer, built with Claude Code.
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. Now the prototype becomes software. This milestone builds the first working version on your own computer with Claude Code, in small steps you can read, test and undo.
- 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
A clickable prototype
A version people can click through, shown to three of them.
Milestone 7Your product gains
A working app on your computer
That makes 8 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.
I am starting the first working version of my product with Claude Code. The folder contains my build brief. Read the brief. Before writing any code, give me a plan: the screens in the order you would build them, what you will set up first, and how I will check each step myself. Wait for me to approve or change the plan. Build one screen at a time, and after each one tell me what changed and how to test it.
Build it step by step
8 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 8 · from the lesson What Claude Code is
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepThe first working version Open Claude Code on an empty folder
Create a new folder named after your product. Open Claude Code in it from the Claude desktop app, and ask "What can you see in this folder, and what could we build here?" Add your build brief and design system files to the folder.
Done when
This folder is your product from now on.
Step 2 of 8 · from the lesson Your first app
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepThe first working version Run your first screen
Ask Claude Code to set up the app and build the first screen from your brief. Open it on localhost and compare it with your prototype. Ask for corrections until it matches.
Done when
You have a real app. Each lesson now adds to it.
Step 3 of 8 · from the lesson Plan first
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepThe first working version Plan your next feature
In plan mode, ask Claude Code to plan the next must-have from your ranked list. Read the plan, change at least one thing, and only then let it build.
Done when
Make this a habit for every feature that follows.
Step 4 of 8 · from the lesson CLAUDE.md
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepThe first working version Write your CLAUDE.md
Ask Claude Code to create CLAUDE.md, then edit it to cover the product, how to run it, your rules and your design system. Start a new session and ask "what are the rules of this project?"
Done when
Add a line every time you find yourself repeating an instruction.
Step 5 of 8 · from the lesson Reading what was built
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepThe first working version Understand your app
Ask Claude Code for a one-page map of your project and save it as "MAP.md". Then, for your last change, ask what changed and how to test it, and do the test yourself.
Done when
Update the map whenever the structure changes.
Step 6 of 8 · from the lesson Undo and save points
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepThe first working version Make your first save points
Ask Claude Code to set up Git and commit the current working version. Make a small change you do not like, rewind it, then make one you do like and commit it.
Done when
You will push these commits to GitHub in the Deploy unit.
Step 7 of 8 · from the lesson Fixing bugs
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepThe first working version Fix a real bug
Find something in your app that does not work as the brief says. Write a four-part report, let Claude Code fix it, test it yourself, and commit.
Done when
Keep a short list of bugs in "My build" and clear it before each milestone.
Step 8 of 8 · from the lesson The same build in Codex
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepThe first working version Compare two agents
Build your smallest remaining feature with Codex in a copy of the project, using the same brief. Write five lines comparing the two builds, and keep the better one.
Done when
Your first working version is done: screens that run, a rules file, save points and a bug-free main path.
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 9 is your Claude Code setup.