GoodWhale
0 / 10
Build with AI · Beginner track

Build real software
by talking to AI.

A hands-on, self-paced path to building, debugging, and shipping your own small web tool — with an AI assistant doing the coding. No coding required from you.

10 steps · ~14–16 hours · go at your pace Built for Claude.ai Inspired by AI Singapore's AIxTech

Start here

Welcome. By the end of this guide you'll have built one small but real web tool — a simple expense tracker — and you'll have debugged it, made it safer, documented it, and shipped it. You won't write a single line of code. You'll direct an AI that does.

The one idea, if you remember nothing else: You don't write the code. You describe what you want clearly, give the AI the right context, and check that it actually works. That's the whole job.

Everything you'll learn stacks into three skills — a ladder. You'll spend almost all your time on the first two rungs.

Rung 1
What you say
Asking for what you want, clearly. (Prompting.)
Rung 2
What it sees
Giving the AI the right background. (Context.)
Rung 3
The environment around it
The advanced stuff. You'll just taste it. (Harness.)
🔒
One rule from minute one: never paste anything private into the AI — real names, NRIC numbers, customer details, passwords. Always use made-up data. We'll explain why in Step 5; until then, just don't.

How to use this: work top to bottom, at whatever pace suits you — an hour here, an evening there. Each step builds the same project, so it all adds up to something real. The "Your turn" boxes are where the learning happens — actually do them. Tick a step off when you're done; your progress saves in this browser.

A note on screenshots-that-aren't: Claude's interface changes often, so a button might sit in a slightly different place than described. The idea is what matters, not the exact pixel.

1 Get going · ~45 minMake something real in the next 15 minutes
Why this matters

The fastest way to believe you can do this is to do it. So before any theory, you're going to make a working tool — right now.

Watch it happen

You type a plain request. Claude writes all the code and shows you a live, working version you can click — that preview panel is called an Artifact. You never have to look at the code.

Your turn

Go to claude.ai, start a new chat, and paste this:

Paste into Claude
Make me a tip calculator. I type in a bill amount and pick a tip percentage, and it shows me the tip and the grand total. Make it look clean and work well on a phone.

Watch it appear in the preview and try it. Now change it — without touching any code:

Paste into Claude
Now add a box where I can split the total between a number of people.
What just happened

You built and changed working software by describing it in plain English. The AI wrote every line; your job was saying what you wanted, clearly. AIxTech calls this whole skill working with an AI coding assistant — and you just did your first round.

Watch out

"Did I just code?" Not quite — and that's the point. You didn't write code; you directed something that did. That shift, from writer to director, is the whole idea behind this guide.

You now have

A working tip calculator, and proof this is for you. Next, we make your requests far more powerful.

Why this matters

A vague request gets a vague result. The single highest-value skill in this whole guide is learning to brief the AI the way you'd brief a sharp new colleague: who they're helping, what you want, and a little context.

Watch it happen

"Build an expense tracker" makes the AI guess everything and probably miss what you meant. "You're helping a hawker-stall owner — build a phone-friendly tool to log daily expenses by category and show a weekly total in Singapore dollars" gets far closer, first try. The difference is role + goal + context.

Your turn — your project starts here

First, feel the difference. In a fresh chat, try the lazy version and notice what it assumes:

Paste into Claude
Build an expense tracker.

Now the real thing — this brief becomes your project for the rest of the guide:

Paste into Claude
You're helping a small business owner in Singapore who isn't technical. Build a single-page expense tracker. I want to: add an expense with an amount in SGD, a category, and a date; see a list of all my expenses; and see this week's total. Keep it clean and easy to use on a phone. Here's an example expense to test with: 4.50, "Ingredients", today's date.

Before it builds anything big in later steps, get it to think first:

Paste into Claude
Before you build, give me a short plan of how you'll structure this. Wait for me to say "go" before writing it.
What just happened

You gave the AI a role, a goal, and context — and got a much better result. In the AIxTech curriculum this is prompt engineering, and it's rung one of the ladder: what you say. That last move — approving a plan before work begins — is called "plan mode."

Watch out

Beginners under-specify because they assume the AI "knows what they mean." It doesn't — it fills the gaps by guessing, and wrong guesses cost you time. When in doubt, say more.

You now have

The first real version of your expense tracker, and a brief you can reuse. But the AI forgets between chats — so next, you'll make your context stick.

Why this matters

The AI only knows what's in front of it right now. Managing what it sees — its context — is a skill of its own, and it fixes the most common beginner frustration of all.

Watch it happen

In a long, messy chat, the AI starts to "forget" earlier decisions and gets worse. That's not it breaking — it's the context getting cluttered. The fix: keep your standing instructions somewhere stable, and start fresh when a chat gets noisy.

Your turn

In Claude.ai, create a Project (think of it as a folder for this build). In the Project's instructions, write your house rules — the things the AI should always follow:

Paste into your Project's instructions
We're building a simple expense tracker for a non-technical small-business owner in Singapore. Always keep everything in one file. Use Singapore dollars. Don't add features I didn't ask for. Keep the design clean and mobile-friendly.

Now start a new chat inside the Project and keep working on your tracker. Notice it already "knows" the rules without you repeating them.

What just happened

You gave the AI persistent context — a brief pinned to the wall, not just a one-off sentence. That's context engineering, rung two of the ladder: what it sees. The gradual decline you saw in long chats has a name too — context rot. In the real AIxTech course, those house rules live in a file called AGENTS.md (Claude's own tools call it CLAUDE.md) — now you know what it's for.

Watch out

A prompt is a single sentence to the AI right now. Context is the standing brief it carries into every reply. Don't re-type your rules into each message — put them where they persist.

You now have

Your project living in a Project, with house rules that stick. Next: letting the AI do things, not just talk.

Why this matters

Older AI just chatted. Newer AI can act — search the web, run code, make you a file. When an AI can take actions and use tools, we call it an agent. This is the leap from "answer machine" to "thing that does work for me."

Watch it happen

Instead of describing a sample spreadsheet, you can ask the AI to actually make one and hand it to you. Instead of guessing a fact, it can look it up. It takes steps, like a colleague would.

Your turn

In your project, ask Claude to produce something, not just describe it:

Paste into Claude
Make me a sample file with 10 example expenses I can use to test the tracker — a mix of categories and dates — and give it to me to download.

Watch it create the file and hand it over. (Depending on what you ask, Claude may also run a quick calculation or search the web to get something right.)

What just happened

You used Claude as an agent — it took an action and produced a real file, not just text. Under the hood, agents reach tools through plumbing with names like MCP (Model Context Protocol) and skills. You don't need to build those — just know that's what lets an agent connect to things.

Watch out

"Agent" sounds like science fiction. Keep it plain: an agent is a model plus the ability to take actions and use tools. That's all it means.

You now have

Test data for your tracker, made by the AI. More power means more ways to get hurt, though — so before we go further, let's make you safe.

Why this matters

AI-built software fails in a few specific, predictable ways. A beginner who trusts the AI blindly will, eventually, ship something broken or leak something private. Knowing the handful of risks — and a quick check for each — is what separates a responsible builder from a lucky one.

Watch it happen

The AI is fluent and confident even when it's wrong. It can invent a software add-on (a "package") that doesn't exist. It will happily use any data you give it — including data you shouldn't share. None of this is malice; it just does what it's told, convincingly.

Your turn — run this 3-point check on your tracker
  1. Did it invent something? If the AI ever tells you to install or add a named tool or package, challenge it:
    Paste into Claude
    Is that a real, widely-used package? If you're not completely certain it exists, don't use it — find another way.
  2. Did I share anything private? Scan your chat. Never paste real names, NRIC numbers, customer details, or passwords to "test" something. Use fake data — like the sample file from Step 4.
  3. Am I trusting unchecked output? For anything that matters, verify it yourself, or ask the AI to double-check its own work.
What just happened

You ran a safety pass. That fake-package risk has a name — slopsquatting: the AI confidently names a package that doesn't exist, and a bad actor may have already registered that exact name to plant malware. It's real — a made-up "huggingface-cli" package was downloaded roughly 30,000 times. And the private-data rule is Singapore law: the PDPA governs personal data, so don't feed it to a chatbot.

The grown-up version

Singapore built tools for exactly this. IMDA's AI Verify is the national framework for testing AI responsibly; Project Moonshot is its open-source toolkit for testing AI apps (usable even by non-technical people); and IMDA's Starter Kit names four risk areas to test for — hallucination, undesirable content, data disclosure, and vulnerability to adversarial prompts. Your 3-point check is the beginner version of that list.

Watch out

The biggest trap is reading confident as correct. The AI's confidence is not evidence. Check.

You now have

A safer project and a habit that scales. Next, a tidy workspace so mistakes surface before you ever see them.

Why this matters

You can't spot mistakes in code you can't read. So you let the machine catch them for you. Two simple, automatic helpers act like spell-check for code — and the AI sets them up.

Watch it happen

Ask the AI to add basic quality checks, and it quietly flags sloppy bits and obvious errors as it works — catching problems before they ever reach you.

Your turn
Paste into Claude
Add basic quality checks to this project — a linter and type checking — and explain in plain English what each one catches. Then show me an example of a mistake each would catch.

Read its plain-English explanation. You're not configuring anything by hand; you're asking the AI to set up its own safety net.

What just happened

You added the basics of an AI-minded tech stack. Linting is a grammar-checker for code — it catches messy, error-prone style. Type-checking catches a whole class of bugs, like putting text where a number should go. The AI runs them so it can check its own work.

Watch out

These sound deeply technical. They're not your job to understand in detail — only to know they exist, and to ask the AI to use them.

You now have

A project that checks itself. Now let's adopt the way professionals actually work.

Why this matters

The beginner's trap is "looks done → isn't → endless fiddling." The fix the pros use: decide what "done and correct" means before you build. Write the goal, write the check, then build to pass it.

Watch it happen

For a new feature, you first write one plain sentence describing it, then have the AI write a simple test — a yes/no check of whether it works — and only then build. When the check passes, you're actually done.

Your turn — add a feature this way
Paste into Claude
I want the weekly total to reset every Monday. Write that as a one-paragraph spec, then write a simple test that would tell us if it's working — for example, expenses from last week shouldn't count toward this week. Show me the spec and the test before building anything.
Paste into Claude
Now build it so it passes that test, and tell me when the test passes.
What just happened

You did spec-driven and test-driven development in miniature — AIxTech's professional workflow, in beginner form. You defined the target, then aimed.

Watch out

Writing the test before the thing feels backwards. Reframe it: you're writing down what success looks like, so both you and the AI can see the moment you've hit it.

You now have

A feature you can trust, because it's checked. But things still break — so next, fixing.

Why this matters

Debugging is where beginners quit. The secret: you don't need to read the code. You need to give the AI the right clue and run a tight loop.

Watch it happen

When something breaks, the screen usually shows an error message. You copy that exact message back to the AI, tell it what you did, and it fixes the cause — then you test again. Show the symptom → get a fix → test → repeat.

Your turn

Break it on purpose, so you can practise the fix:

Paste into Claude
Change something small so the weekly total stops working — I want to practise fixing a bug.

Now fix it the right way:

Paste into Claude
Here's exactly what's happening: [describe what you see on screen, and paste any error message]. Here's what I clicked just before it. Find the cause, fix it, and tell me in plain English what was wrong.

Then lock it in so it can't sneak back:

Paste into Claude
Write a simple test for this so it can't silently break again.
What just happened

You ran a closed-loop debugging cycle and used AI test generation — exactly the AIxTech debugging-and-testing skills. Notice the skill wasn't reading code; it was feeding back a precise symptom.

Watch out

Beginners say "it's not working." That gives the AI nothing. Always paste the exact error and the exact steps — specific symptoms get specific fixes.

You now have

A debugged, tested tracker. Now make sure future-you understands it.

Why this matters

In six months you won't remember how your tool works. Documentation is how a solo builder avoids getting stuck — and it's something the AI writes for you in seconds.

Watch it happen

Ask the AI to explain your project in plain English and to draw a simple diagram of how it fits together. You get a guide for future-you, for free.

Your turn
Paste into Claude
Write a short README for this project that a non-technical friend could follow to use it. Keep it simple.
Paste into Claude
Now draw a simple diagram showing how the parts of the app fit together, as a diagram I can actually see.
What just happened

You generated AI-assisted documentation — including a diagram-as-code (the AI writes a diagram from a description). Bonus: good docs also make the AI better at editing your project later, because it re-reads them.

Watch out

Docs feel optional, so people skip them. Treat them as a gift to future-you — two minutes now saves hours later.

You now have

A README and a diagram. You've done the full loop on one real project — here's where it scales.

Why this matters

Hard jobs go better when you split them across two AI "workers" who hand work to each other — and you run the hand-off. You'll do this for real now, by hand. It's the steepest step, and the most satisfying.

Watch it happen

One AI builds; another checks. You pass the work between them. Doing the hand-off manually is the best way to feel what "orchestrating agents" actually means — before any tool does it for you.

Your turn — a two-agent hand-off
  1. Builder. In one chat:
    Paste into Chat 1 (Builder)
    You're the builder. Add a "monthly summary" view to the tracker that shows totals per category for the month. When you're done, write me 3 bullet points: what you changed, and what someone should check to make sure it works.
  2. Reviewer. Open a second, separate chat:
    Paste into Chat 2 (Reviewer)
    You're a meticulous QA tester. Here's a feature someone built, and their own notes on it: [paste the builder's work and its 3 bullet points]. Find anything broken, missing, or risky. Be specific.
  3. Hand back. Take the reviewer's findings to the builder chat:
    Paste back into Chat 1 (Builder)
    A reviewer found these issues: [paste them]. Fix them, and tell me what you changed.
  4. Ship it.
    Paste into Chat 1 (Builder)
    Tidy everything up, make sure it still works well on a phone, and give me the final version to share.
What just happened

You ran a two-agent hand-off — one of AIxTech's most advanced topics (multi-agent orchestration, context passing, artifact hand-offs), done by hand. Here's the punchline: the coordinating you just did manually is exactly what harness engineering automates — the rules and feedback loops built around agents so they stay reliable. Agent = model + harness. That's rung three of the ladder, and the honest horizon of where this field is heading.

Watch out

"Two agents" sounds automated and magical. What you actually did was pass an artifact between two roles. That's the real, unglamorous heart of it — and you did it.

You now have

A tool you built end-to-end and shipped — and you've personally touched all three rungs of the ladder, the third by being the harness yourself.

You did it. Here's what to keep.

The one thing to remember: you don't write the code. You describe precisely, give context, and verify. Everything else is detail.

What you say What it sees The environment around it
Explore the real AIxTech course → You've done a beginner's lap. AI Singapore's AIxTech is the full, funded version — built for professionals, with hands-on access to assistants like Claude. If you enjoyed this, that's your next step.