Maison Cler · Claude Code Bookclub · Self-Study
From idea to built.
A beginner's guide to Claude Code — and why it changes everything for founders, operators, and builders.
Maison ClerSomething changed
you had two options.
Most ideas died between the idea and the execution.
That gap just closed.
Maison ClerThe new reality
This isn't hype.
The question isn't whether to learn this.
The question is: how long can you afford not to?
Maison ClerIn this module — you'll learn
By the end, you'll be able to explain Claude Code to anyone — and start building your first real thing.
Maison ClerPart A · A new category
Two kinds of AI help
You type something. It replies. You ask for an email. It writes one. You paste a problem. It explains.
That's conversational AI — useful, but reactive. It waits for you. It answers one question at a time.
Agentic AI is different.
Maison ClerWhat "agentic" actually means
Helps you think through it. Step by step. With you guiding every move.
Just goes and does it. Reads files. Makes decisions. Takes actions. Comes back only when there's a real choice.
Agentic AI acts toward a goal — not just toward the next sentence.
Maison ClerWhy this matters for you
It's the difference between having a conversation and having a contractor.
Maison ClerWhere you are now
Next: Anthropic makes several tools. Which one is which — and which one builds real software?
Maison ClerPart B · The Claude family
You already know this one
The chat interface in your browser. Conversational. Great for thinking, writing, problem-solving.
But Claude.ai is still a chat window. You type. It replies. Nothing gets built. Nothing gets saved to a project. Nothing gets deployed.
It's the equivalent of texting a really smart friend.
Maison ClerThen there's this one
Claude's desktop tool — designed for people who want to automate tasks on their computer without writing code.
Think: file management, document workflows, repetitive tasks across your apps.
More powerful than Claude.ai — but still at the level of your desktop.
Maison ClerAnd then there's this one
This is where things get serious.
Not a chat window. A full AI agent that lives in your terminal — and can read your project files, write code across multiple files, run tests, fix errors, commit changes, and ship working software.
You describe what you want to build. It builds.
It understands your entire codebase — not just the message you just typed.
Maison ClerThe simple map
| Claude.ai | Cowork | Claude Code | |
|---|---|---|---|
| Where it lives | Browser | Desktop app | Terminal / Browser |
| What it does | Thinks & writes with you | Automates desktop tasks | Builds actual software |
| Best for | Thinking, drafting, researching | File & task automation | Shipping real products |
Claude Code is the one that builds.
The rest of this module is about Claude Code.
Maison ClerWhere you are now
Next: Here's what Claude Code can actually do for your job — whether you build, sell, market, or run operations.
Maison ClerPart C · Why it matters
Five examples, five different jobs.
Hours yesterday. Minutes today.
If you're a founder
The old way
2 weeks
Hire a freelancer for €1,500. Wait. Slack-iterate. Wait again. Compromise on the design.
With Claude Code
30 min
Brief it. Get the page. Iterate five times before lunch. Live on a real URL by dinner.
If you're in sales
The old way
4 hrs
LinkedIn tab. Company site tab. News tab. Copy. Paste. Scribble. Repeat fifty times.
With Claude Code
12 min
Hand Claude the list. It enriches each profile, scores fit, drafts the opener — formatted in your CRM template.
If you write product copy
The old way
2 hrs
Stare at the spec sheet. Try one. Hate it. Try again. Eventually settle for "fine."
With Claude Code
8 min
Five descriptions, on-brand, in three tone options each. You pick. You ship.
If you do competitor research
The old way
4 hrs
Thirty tabs. Landing pages. Pricing screenshots. A Notion table by hand. Forget half of it by Friday.
With Claude Code
12 min
Claude pulls each site, extracts pricing, value props, ad messaging — and gives you a one-pager you can act on.
If you run operations
The old way
45 min
Pull from Stripe. Pull from Shopify. Paste into a sheet. Format. Format again. Realize you missed Friday's data.
With Claude Code
3 min
"Pull this week's numbers and format my report." It does. Same template, every time.
The pattern
That's the whole shift. Not "code instead of work." More like:
brief, review, ship — five times faster, every time.
Part D · Meet your contractor
Meet your contractor
You don't need to become a builder. You don't need to learn how to lay bricks or wire electricity.
What you need is a great contractor — someone you hand a brief to, who knows their craft, and who comes back with results.
Claude Code is that contractor.
You describe the house. It builds.
Maison ClerBut it lives in a terminal — what's that?
The terminal is just a text-based way to talk to your computer — like talking to your file system directly. Claude Code lives there because it needs access to your actual project files. It reads them. Edits them. Creates new ones.
Good news: Claude Code also runs in your browser at code.claude.com.
So you don't have to be technical to start. Just a browser, a folder, and a brief.
Maison ClerThe loop · how a session works
You describe the outcome. It figures out the path.
Maison ClerKitchen analogy
You don't tell them how to cook. You say:
They handle the shopping list, the prep, the timing, the plating. You stay focused on the experience you want to create.
You are the chef-owner. Claude Code is the head chef in your kitchen.
Maison ClerWhat it looks like on screen
Files
Editor
Claude Code
Files on the left. Code in the middle. Claude Code on the right. Everything in one place.
Maison ClerWhere you are now
The rest of this module is about how to talk to your contractor well — so what comes out actually matches what you wanted.
Maison ClerSection 1
In this section — you'll learn
First — what it isn't
The mental model
You brief it. It builds.
Maison ClerThe catch
They complete what you ask for.
The quality of what you get back is directly proportional to the quality of your brief.
Maison ClerThe freelancer test
What you get: garbage. Stock photos. Lorem Ipsum. Generic template.
What you get: something usable. Same designer, different brief.
Kitchen parallel
Bad order
The chef has no idea what you want. Sweet? Savory? Vegetarian? You'll get whatever's coming up.
Clear order
"4 eggs, guanciale, pecorino, black pepper. No cream. Twenty minutes." The chef does it right — and fast.
Where you are now
But: even with the right mindset, most builds still go wrong. Here's the #1 way it happens.
Maison ClerSection 2
In this section — you'll learn
How it plays out
A simple car. Four wheels, engine, drives forward.
Ten minutes in, you get an idea:
Claude adds wings. Now you're excited.
Claude adds a hull.
Maison ClerThe result
that doesn't drive,
doesn't fly,
and sinks.
Meanwhile, Claude spent the first 20 minutes building a login system and a user database — before it built the car.
Maison ClerWhy builds fail
You kept adding features before the first one worked. Every new idea felt small ("just add wings!") but each one made the whole thing more fragile.
Left to itself, Claude builds plumbing first — auth, databases, error handling. The thing your user actually touches comes last, if at all.
The rule
Everything else comes later.
Maison ClerWhat the rule looks like in practice
Email generator?
First thing that should work: type a topic, get an email.
Product page?
First thing: the page renders with real content.
Not a CMS. Not an admin panel. Not a login.
And when a new idea hits mid-build?
Say this:
Write it down. Come back later. Nine times out of ten, the idea is still good — the timing was wrong.
Kitchen parallel
Imagine you order pasta. Five minutes in, you change your mind — "actually, make it pizza." Halfway through, you say — "you know what, sushi instead."
You'd get a plate of raw, half-cooked everything.
Same dynamic with Claude. Pick the dish. Let it finish.
Maison ClerWhere you are now
Next: Now we get into how to actually write the brief. There's a name for it. It's called a spec.
Maison ClerSection 3
In this section — you'll learn
A spec is just three things
What it does
The job it performs.
What it looks like
The format, the style, the layout.
What it must NOT do
The boundaries. The walls.
That third one is the secret weapon.
Maison ClerThe secret weapon
Constraints are
more powerful
than instructions.
Kitchen first — bad order vs good order
You'll get something. Maybe a stew. Maybe a salad. You won't know until it lands.
The cook knows exactly what to make — and what to skip.
Now the same idea, in code
A tool that generates product descriptions for your ecommerce store.
Same idea. Two briefs. Two very different results.
Maison ClerBad spec vs. good spec
What Claude builds: a full Next.js app with a database, user accounts, history, settings page, and a paid API integration — all before you've seen a single description.
What Claude builds: exactly that. A working tool in under 5 minutes.
Same idea
The only difference was the brief.
Maison ClerYour product intuition is the technical skill
You've used thousands of apps. You know what good feels like. You know when a checkout flow is annoying. You know when a dashboard is confusing.
You know what "clean" means, what "fast" means, what "too much" means.
That intuition IS the spec.
Maison ClerUse what you already know
Each one is a complete spec. Claude has seen all those apps. Your reference library is your technical vocabulary.
Maison ClerWhere you are now
But here's the catch: every new session, Claude forgets all of this. Even your perfect spec is back to zero. How do we fix that?
Maison ClerSection 4
In this section — you'll learn
The goldfish problem
Here's something that trips up almost everyone the first time they use Claude Code:
Claude forgets everything between sessions.
It doesn't remember your project setup. It doesn't know your tech stack preferences. It doesn't know that your checkout page has a quirky architecture, or that you always want TypeScript.
So it has to rediscover all of this every single time. That's slow. And it leads to inconsistent results.
Maison ClerWhat that's like
And re-explaining everything from scratch.
Brand voice. Tech stack. The rule about never deploying without permission. Every. Single. Time.
Maison ClerThe fix
A simple text file in your project folder. Claude Code reads it automatically at the start of every session.
Think of it as the onboarding document you'd give a new contractor before they touch your project.
Still abstract? Let's try a few angles.
Maison ClerAngle 1 · Cooking
Same dish. Spaghetti carbonara. Same kitchen. Same ingredients on the counter.
Two very different dinners come out of it. Why?
Maison ClerSame goal · different prep
You
You've made pasta before. How hard can it be? You guess at quantities. Forget the pepper. The eggs scramble.
Edible. Not memorable.
Carbonara
By Gordon Ramsay · pinned to wall
Same kitchen. Wildly different dinner. The recipe was the only difference.
Maison ClerStill not landing?
Angle 2 · Buying a house
You walk into an agent's office. They ask: "What are you looking for?"
If you say "a place to live" — they'll show you 50 random listings. Most won't fit. You'll waste your weekend.
If you hand them this:
Now they show you 5 perfect matches.
CLAUDE.md is your house brief — but for your project.
Maison ClerHalfway there
Angle 3 · The contractor walkthrough
A good contractor doesn't just show up and start working. Before they start, you walk them through the house:
That walkthrough is your CLAUDE.md.
Not magic. Just a really good brief — written once, used every time.
Maison ClerThree angles · one idea
The brief is what changes everything.
Maison ClerWhat goes in a CLAUDE.md?
Plus: your brand voice, your "never do this" rules, and what Claude got wrong before.
Maison ClerMake the recipe even better
Instead of cramming everything into one CLAUDE.md, split your business context into a few files. Like a chef who keeps separate notes for ingredients, dietary rules, and supplier lists.
Claude reads all of these at the start of every session. Now when you say "write a product description," it already knows your brand voice, customer, and competitive angle — without you explaining.
Maison ClerThe progressive disclosure trick
Start with 10 lines. The basics.
Then, every time Claude does something you don't like — builds a login when you didn't ask, uses the wrong colors, deploys without permission — add a rule.
After two weeks, your CLAUDE.md will be perfectly calibrated. It will have caught every bad habit Claude has and corrected it.
This is the file that makes Claude feel like it knows you.
Maison ClerWhere you are now
But: even with CLAUDE.md, sessions get long and messy. Claude starts making weird choices halfway through. Why?
Maison ClerSection 5
In this section — you'll learn
The whiteboard mental model
Every message you send, every response Claude gives, every file it reads, every error it encounters — all of it gets written on the whiteboard.
Maison ClerWatch the whiteboard fill up
Same as a chef during dinner rush. Order #1, #2, #3, "table 6 is allergic to nuts," send back the steak… eventually they forget which one was medium-rare.
Maison ClerThe #1 reason sessions go bad
Because the whiteboard is full.
Maison ClerThe fix
Erases the whiteboard. Completely. Fresh start.
This is the single highest-ROI habit you can build. When a session is degrading, type /clear and start over.
Your CLAUDE.md gets reloaded automatically. Claude still knows your project, your rules. It just loses the clutter.
Maison ClerTwo rules of thumb
Building a product page? That's one conversation.
Need to fix a bug? /clear, new conversation.
Want to add a feature? /clear, new conversation.
It feels efficient. It's not.
Claude has to reconstruct context from a messy whiteboard. A fresh start with a good CLAUDE.md is almost always faster.
The middle ground
Sometimes you can't afford a full reset. /compact squeezes the whiteboard — keeps the important context, removes the noise.
Deep in a build and switching tasks would lose momentum. Long but still productive. Want Claude to refocus.
Starting a new task. Claude is making mistakes. You're frustrated. (Seriously — /clear and a calm re-prompt fixes most problems.)
Where you are now
Next: The handful of commands you'll use every day.
Maison ClerSection 6
Three commands · the ones that matter
Fresh start.
The most important one. Use between tasks. Use when things feel off. Use liberally.
Compress, don't reset.
For long sessions still going well — but getting heavy.
Generate a starter CLAUDE.md.
Run in any project folder. Claude scaffolds one based on what it finds. Edit from there.
Giving Claude a screenshot
When something looks wrong, don't try to describe it. Show it.
Then say:
Like showing the chef the dish that came back to the pass — they can taste the problem instantly.
Maison ClerMaking Claude plan first
When you're starting something complex, tell it to think first:
Claude lays out the approach — what files, what structure, what order. You review, adjust, then say "go."
Why this works: you catch bad decisions before any code is written. This prevents the boat-with-wings problem.
Maison ClerWhere you are now
Next: Even with a great CLAUDE.md, you'll do the same kinds of tasks over and over. There's a name for that — and a fix.
Maison ClerSection 7
The repetition problem
you'll find yourself doing the same kinds of tasks over and over.
You can describe these from scratch every time. But there's a better way.
Maison ClerWhat are Skills?
Pre-packaged workflows you can trigger on demand. Think of them like standard operating procedures — but for your AI contractor.
Instead of re-explaining your SEO process every time, you create a skill called /seo-review. Claude Code knows exactly what to do. Every time. Consistently.
Maison ClerThe restaurant SOP analogy
It doesn't rely on the chef inventing the bolognese fresh every Tuesday.
They have a recipe. A process. A standard. New staff learn it. Experienced staff follow it. The result is consistent — because the knowledge is baked into the operation, not just kept in one person's head.
Skills are your restaurant's recipe book.
They turn great one-off results into reliable, repeatable output.
Maison ClerWhat Skills enable
Skills are how Claude Code stops being a tool you use — and starts being a system that runs.
Maison ClerSection 8
What tool for what job
But a rough sense helps:
| What you need | What to use | Example |
|---|---|---|
| Show an idea, mockup, prototype | HTML file | Character card, landing page draft |
| Build a tool people use in a browser | Next.js | Calculator, dashboard, generator |
| Save data between sessions | Supabase | User accounts, product lists |
| Run without you pressing a button | Trigger.dev | Daily reports, automated emails |
| Make something smart | Claude API | Generation, analysis, scoring |
You don't memorize this. When you start a build, Claude picks the right tool — if your CLAUDE.md mentions the stack.
Maison ClerThe only rule to remember
If an HTML file can do the job, don't build a Next.js app.
If a Google Sheet can track your leads, don't build a CRM.
You can always upgrade later. You can't easily downgrade.
Maison ClerZoom out
Together, these three things turn a powerful tool into a reliable business system.
Maison ClerWhat this unlocks for founders
The thing that used to be called "you need to hire a developer" — is gone.
Maison ClerWhy now?
This technology is six months old for most people. The learning curve is real but short.
The people who start now will have six months of practice by the time the rest of the market catches up. The contractors, developers, and agencies who rely on the old model are already feeling the shift.
The question was never "is this the future?"
The question is: are you early, or are you late?
Maison ClerYour first step
You need to open Claude Code, describe one thing you want to build, and let it run.
Everything else — the CLAUDE.md, the Skills, the workflows — comes from using it. From doing the thing.
Start small. Start today. The system builds itself as you learn it.
Maison ClerBefore Session 2 · homework
Something for your business. Not a toy. Something you'd actually use.
Then write the spec — the three sections you now know:
Bonus: fill in the company-context/ templates so Session 2 already knows your brand.
Bring it to Session 2. We'll build it live.
Maison ClerWhat we covered today
Remember this · the system
The agent that builds.
The brain that remembers you between sessions.
The playbooks that repeat consistently.
= A system that runs.
Maison ClerRemember this · four rules
Brief like a contractor
Quality in, quality out. The brief is the work.
Build what users touch first
No infrastructure before the workflow works.
Constraints beat instructions
The "must NOT" is the secret weapon of every spec.
/clear is your best friend
Fresh whiteboard for every new task. CLAUDE.md reloads automatically.
Remember this · the whole shift
That's the whole shift.
Maison ClerLet's get to work.
See you in Session 2.
Maison Cler