Module 5: Building Real Things

The Builder's Loop

Lesson 5.2 30–40 minutes 1 activity

Nothing Works the First Time (And That's Normal)

Here's something every professional builder knows that beginners often don't: the first version of anything is always broken. Always. Professional developers spend more time testing and fixing than they do writing the initial code.

This isn't a sign that something went wrong. It's literally how building works. The loop goes like this:

  1. Build something (a component, a feature, a page)
  2. Test it (try using it the way a real user would)
  3. Find what's broken or not right (there will always be something)
  4. Fix it (with AI's help if needed)
  5. Test again
  6. Repeat until it works the way you want

This is called the builder's loop, and it's not a sign of failure — it's the process. Knowing this ahead of time will save you so much frustration when things don't work right away. They're not supposed to.

Answer: "This is normal. Time to test, identify the issue, and fix it." Not "I'm bad at this" or "AI gave me broken code." The build-test-fix loop is the standard process for every builder at every level.

Testing Your Own Work

Testing means trying to use your project the way a real person would — and actively looking for things that break. Here's a simple testing approach:

1. The Happy Path: Use the feature exactly as intended. If it's a form, fill in all fields correctly and submit. Does it work? Does the data save? Does the display update?

2. The Edge Cases: What happens with unusual inputs? Leave a field empty. Enter a really long name. Enter a zero. Enter a negative number. Try clicking the submit button twice. Edge cases are where most bugs hide.

3. The Mobile Check: If your project runs in a browser, open it on your phone (or resize your browser window to phone-sized). Does the layout still work? Can you tap all the buttons? Is text readable?

4. The Fresh Eyes Check: Walk away for 10 minutes, then come back and try using your project as if you've never seen it before. Is it obvious what to do? Is anything confusing?

You don't need to do all four checks on every single component. But before you call a feature "done," run at least the Happy Path and a couple Edge Cases.

The Debugging Mindset: Errors Are Teachers

When something breaks, your first instinct might be frustration. That's natural. But experienced builders have trained themselves to feel something else: curiosity. "Interesting — why is it doing that?"

Every error contains information. A page that's blank tells you something different from a page with broken styling. A feature that almost works but gets one thing wrong tells you the core logic is right and you just need to adjust one piece.

The Debugging Process

  1. Describe the problem precisely: "When I click the save button, nothing happens" (not "it's broken")
  2. Identify when it started: "It worked before I added the new styles" or "It never worked"
  3. Narrow down where: "The button appears correctly, so the HTML is fine. The problem must be in the JavaScript that handles the click."
  4. Make one change at a time: Don't change five things at once. Change one thing, test, see if it helped.
  5. Use AI: Describe the problem with the expected/actual/code pattern from Lesson 3.2.

AI Collaboration Moment

Practice describing a bug from YOUR project to AI.

AI Prompt:

"I'm building a [project type]. I have a bug: [what I expected to happen] but instead [what actually happened]. This happens when I [steps to reproduce]. Here's the relevant code: [paste the section you think is causing the problem]. What's wrong and how do I fix it?"

Key Concepts

  • The builder's loop: build → test → find problems → fix → test again → repeat. This is how all software gets made.
  • Nothing works the first time. That's normal, not failure.
  • Test systematically: happy path first, then edge cases, mobile check, and fresh eyes check.
  • Debug with curiosity, not frustration. Describe problems precisely, narrow down where the bug is, and change one thing at a time.
  • When stuck, describe the bug to AI using the pattern: what you expected, what actually happened, steps to reproduce, and the relevant code.

Level Up: Coming Next

Lesson 5.3 — Guided Build: Your Core Screen. Now you'll apply these principles by building the main screen of your project with AI's help.

Continue to Lesson 5.3 →