Learn to code with MILO 🌟

Hi! You are about to learn to code and build things with AI — for the very first time. That feels exciting, a little scary, and completely normal. This repo is your friendly classroom, and MILO (Modular Intelligent Learning Orchestrator), an AI tutor, is your guide.

A repo (short for “repository”) is just a folder that holds all the files for a project and keeps a history of every change. Think of it like a school binder with a memory: it remembers every page you ever wrote.

You don’t need to know anything yet. You just need to show up and stay curious. MILO will be your patient guide, one small step at a time. This is what learning to build looks like now: you and an AI, side by side. Here’s the model: MILO is the brain, and GetAdvice is its friendly face — a real public app people use to talk through a decision. For these lessons you’ll meet MILO inside a coding assistant, and later you’ll practice writing clear feedback about GetAdvice.

What you need

This course assumes two things:

Claude Code — the coding app where MILO can see this folder and walk beside you. Install it from claude.com/claude-code.
A paid Claude subscription (Pro or higher). Claude Code is included with paid Claude plans: Pro, Max, Team, and Enterprise. The free Claude plan is chat on the web, desktop, and mobile. You can also sign in to Claude Code with pay-as-you-go usage from a Claude Console account. Plan names and prices change, so read the current list at claude.com/pricing before you pay for anything.

If you don’t have Claude Code or a paid plan

You can still take the course. Every lesson is a Markdown file, and every prompt is plain text.

Another AI coding assistant — any tool that can open this folder and edit files, such as Cursor, GitHub Copilot’s coding agent, Gemini CLI, or OpenAI Codex. Claude Code loads CLAUDE.md (and through it MILO.md) when a session starts. Other tools often wait until you ask. Start every session by pasting: “Please read MILO.md and follow it as my tutor.”
A free chat — the free Claude plan, or another free chatbot. It can explain and coach when you paste the lesson and your code. You create the files yourself, because a chat window has no view of this folder and cannot run commands. When a lesson says the tutor will edit a file or run git, you do that step by hand and paste any error back into the chat.

Lessons that need a coding agent — it must see your files, or it must run git — say so in the lesson and point back here.

These pages are Markdown. GitHub shows them as formatted pages, and this repo publishes the same pages as a website with the Just the Docs theme: a sidebar grouped by level, lessons in order, and this README as the home page. That site is what milo-usa.com will serve once GitHub Pages and DNS point here. Tables and the other formatting need GitHub-flavored Markdown, which that theme provides.

The only thing to do right now

Don’t try to read everything. Do this one thing:

Open this repo in Claude Code. If you are on the fallback above, open it in that other assistant instead, and paste the message below so it reads MILO.md. Claude Code is the window where MILO lives, right inside your project, like texting a helper who can see your files.
Copy the message below, paste it to MILO, and press Enter.

Hi MILO! I'm new to coding. Please read MILO.md and be my tutor. Let's start with lesson 00.

That’s it. MILO takes it from there and walks you through your very first lesson. 🚀

What’s inside

Here is everything in this repo and what each part is for. You don’t need to open these yourself yet. MILO will guide you to them at the right time.

Item	What it’s for
`MILO.md`	The instructions that turn your helper into MILO, your personal tutor.
`lessons/`	Your step-by-step lessons, in order, starting with `lessons/00-start-here.md`.
`roadmap.md`	The big picture: where you are now and what comes next.
`glossary.md`	A friendly dictionary of coding words, in plain English.
`my-projects/`	The place where you build your own creations. See `my-projects/README.md`.
`feedback-getadvice/`	Where you practice clear feedback on the public GetAdvice app, then review your own note. See `feedback-getadvice/README.md`.

Level 1 — the ladder 🌱

Lessons 00–07 are recipes. You follow them in order. When you finish — a page built, styles added, a button wired, work saved with git, one feedback note reviewed — you are ready for Level 2.

lessons/00-start-here.md — How this classroom works, and how to talk to MILO.
lessons/01-how-the-web-works.md — What a website is made of.
lessons/02-your-first-web-page.md — Your first page (HTML).
lessons/03-add-style-css.md — Make it look good (CSS).
lessons/04-make-it-interactive-js.md — Make it do something (JavaScript).
lessons/05-your-own-project.md — Build something that is yours.
lessons/06-saving-work-with-git.md — Save your work with Git.
lessons/07-giving-good-feedback.md — Write clear feedback, and review it yourself.

Level 2 — The Builder’s Track 🔨

Level 2 hands you goals. MILO switches from chef to coach: it asks you questions until you can write the code, then reviews what you wrote. You grow one real app across four lessons, learn to hunt bugs and read strangers’ code, and finish by writing a real fix proposal.

lessons/08-level-2-the-builders-track.md — The new rules: goals instead of recipes, and how to ask MILO to coach, not solve.
lessons/09-a-site-with-rooms.md — Start Study Buddy, your quiz app: build its shell as pages that work together.
lessons/10-logic-that-thinks.md — Wire the quiz brain: right, wrong, and keeping score.
lessons/11-memory-for-your-app.md — Make Study Buddy remember you between visits.
lessons/12-talking-to-the-internet.md — Teach it to fetch fresh questions from the web.
lessons/13-the-detective-lessons.md — Switch hats: hunt bugs on purpose instead of stumbling into them.
lessons/14-reading-strangers-code.md — Open code you did not write and figure out what it does.
lessons/15-capstone-fix-something-real.md — The capstone: turn an example GetAdvice note into a real fix proposal you write yourself.

Level 3 — The Launch Track 🚀

Level 2 made you a builder. Level 3 makes you dangerous. The hardest truth in software: a great thing nobody has heard of loses to a mediocre thing everybody has. So now you learn the half nobody teaches — putting your work live on the real internet, getting real people to do one specific thing, and picking one number you chase in public and tell the truth about. It’s brutal work, on purpose — and it’s still only the warm-up for Level 4.

lessons/16-level-3-the-launch-track.md — The new deal: building is speaking, launching is being heard.
lessons/17-deploy-a-marketing-campaign.md — The big one: run a real, measured marketing campaign end to end — audience of one, a live page, a number, a launch, an honest retro.
lessons/18-the-growth-engine.md — Advanced AI marketing: turn a single launch into a measured growth engine — use AI to generate at speed, run a pre-registered A/B experiment, count an honest funnel, and prove whether the engine actually turned.

Level 4 — The Forge 🔥

This is the final transformation, and it is not for everyone. Level 4 takes the capable builder you’ve become and forges them into a MILO Architect — someone who can turn nothing but an idea into a real, production-grade empire that strangers pay for, that survives load and attack, and that has their name on it. MILO stops being a friendly coach and becomes a kind-but-ruthless Master Mentor who drops hard truths and celebrates only proven impact. Every challenge is production-grade and real: real users, real money, real stakes. It is by far the hardest work in this repo. That is the entire point.

lessons/19-the-forge-lights.md — The forge lights: the three laws (adaptive orchestration, supervisory primacy, viability) and the oath.
lessons/20-first-blood.md — First blood: ship a real product to production and earn the trust of real strangers.
lessons/21-the-swarm.md — The swarm: command a multi-agent system that adapts, obeys, and can never run away.
lessons/22-hardened.md — Hardened: tests, CI/CD, a security pass, and a load test — the system that survives the storm.
lessons/23-the-contribution.md — The contribution: extend MILO itself, lead other humans, and publish a case study.
lessons/24-forge-the-empire.md — The capstone: launch a real empire in public, with a real ask, and prove the world showed up.

How Level 4 is checked (and why). The Forge is checked by real proof and a real person, not by trusting a claim. You keep a Proof Ledger of links a stranger could verify, and you defend your work to your instructor on a short live call where they’ll ask you to explain and change your own code on the spot. Here’s the important part, said plainly: using AI to learn — to explain things, to coach you, to help you write code you understand and can change — is the whole point, and it’s encouraged. The only line is work you can’t defend as your own. AI that coached you is a superpower; AI that did it for you leaves you with nothing to show and nothing to defend. What the instructor does is written in my-projects/forge/PROCTOR.md and my-projects/forge/SHOW-ME.md.

Three golden rules of learning

Mistakes are part of the game. Every coder, even the best ones, breaks things all day long. A mistake is not failure. It is just the next clue.
Type the code yourself. Don’t copy and paste big blocks of code. Typing it by hand is how your brain actually learns. Slow is smooth, and smooth is fast.
Always ask “why?” If something doesn’t make sense, ask MILO to explain it again in a simpler way. There are no dumb questions here, ever.

🎉 Milestone: you met your classroom

You just met your classroom and learned what a repo is. That is a real first step, and you’re already on your way.

Ready for the next one? Paste the starter message above, then open lessons/00-start-here.md and MILO will meet you there. 👋