lesson
25 min

Define the Right Thing

Turn a real problem into a clear problem statement and the smallest useful version of a tool.

What you will learn

By the end of this lesson, you can write a problem statement and describe the smallest useful version of a software tool.

Software is instructions for a computer

Software development is writing, testing, and improving the code that tells computers what to do. Apps, websites, and automations are all software.

The code is only part of the job. Most failed software projects did not fail because of bad code. They failed because the team built the wrong thing, or built too much at once.

Write the problem first

A problem statement names who has the problem, what they are trying to do, and what gets in the way. Use this pattern:

[Who] needs to [do what], but [what gets in the way].

Example: "Volunteer tutors need to know which students came last week, but attendance lives on paper sheets that get lost."

Notice what is missing: the solution. Do not write "We need an attendance app" yet. Maybe the fix is a shared spreadsheet. Maybe it is a clipboard that stays in one place.

Build the smallest useful version

An MVP, or minimum viable product, is the smallest version that solves the core problem for real users. It is not a broken or ugly version. It is a focused one.

StageWhat it includesExample: tutoring attendance
MVPOnly the core taskTutors mark who came. Leads see a weekly list
Version 1What real users asked for nextNotes per student, a simple search
Later, maybeNice-to-havesCharts, reminders

Build the MVP. Let real people use it. Then let their feedback decide what comes next.

Think in steps

Code follows steps. Before you write code, write the steps in plain words. Then turn each step into code. Try it in Python below. The first run downloads the Python runtime, so use Wi-Fi if you can.

students = ["Ana", "Ben", "Chris", "Dee"]
present = ["Ana", "Chris"]

for name in students:
    if name in present:
        print(name, "- here")
    else:
        print(name, "- absent")
This tiny program marks who came to tutoring. All names are made up. Run it. Then add "Dee" to the present list and run it again. The output check passes once Dee is marked here.
Python 3
Ctrl+Enter to run | Tab to indent | Python runs in your browser via Pyodide

Reflection

Private. Saved only in this browser. No one else can see it.

Go deeper: Software Development, Simply: How to Build the Right Thing, Faster, With Fewer Headaches

Ask. Answer. Build together.