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
7 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 7 · from the lesson Install and set up
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepThe first working version Set up your environment
Install Claude Code, run it in a new project folder containing your build brief, and have it scaffold the app and build the first screen. Confirm the dev server runs.
Done when
Commit the scaffold before you go on.
Step 2 of 7 · from the lesson The agentic loop
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepThe first working version Give the agent a way to verify
Add lint, type-check and build scripts to your project, then ask Claude Code to implement one feature and to run those checks until they pass before it reports back.
Done when
Add the commands to CLAUDE.md so every session uses them.
Step 3 of 7 · from the lesson Plan mode and Git
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepThe first working version Ship a feature on a branch
Create a branch, plan your next must-have in plan mode, build it in at least three commits with passing checks, and open a pull request against main.
Done when
Merge it once you have read every line.
Step 4 of 7 · from the lesson CLAUDE.md and memory
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepThe first working version Write your project memory
Create a project CLAUDE.md with your commands, conventions, constraints and the decision records from Unit 6. Commit it, start a fresh session, and verify that the agent follows it without being told.
Done when
Prune it whenever it passes a page.
Step 5 of 7 · from the lesson Managing context
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepThe first working version Run a long task cleanly
Take a feature that needs several steps. Keep a PROGRESS.md note updated by Claude Code, compact once in the middle, and finish the feature in a second session started from the note alone.
Done when
Use the same note pattern for every multi-day feature.
Step 6 of 7 · from the lesson Reviewing diffs
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepThe first working version Review a real pull request
Review your open pull request with the four-step checklist. Ask a fresh agent session to review it too, compare findings, fix what matters, and merge.
Done when
Add your checklist to CLAUDE.md as the project’s review standard.
Step 7 of 7 · from the lesson Codex CLI
Read the short notes and pictures.Do everything inside a blue frame.
ActivityBuild stepThe first working version Compare two CLIs
Run the same small task with Claude Code and Codex CLI on separate branches. Write a short comparison and merge the better branch.
Done when
Your first working version is complete and reviewed.
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.