Skip to main content
Handbook/Set Up/Page 7 · The System

What You Are Really Building

Share

Share this page

Pass it to someone who needs it.

Star on GitHub

Key takeaway: Build the system, not just the app

You have an agent and an empty project. The obvious next move is to start asking it for features, and that move is exactly how a weekend app gets born and how it dies a month later. What separates the projects that survive is not talent. It is that they build a second thing alongside the app, starting on day one.

1.3.1Your project has two halves

The introduction put it as a factory and a car. Here is the same thing without the metaphor.

Every project has an app: the screens, the features, the thing users touch. It also has an AI operating system: the rules, plans, checks, records, and agents that produce that app and keep it alive. One is the output. The other is what makes more output possible.

1.3.2The operating system runs two departments

An operating system is not one thing. Yours runs two cycles, on the same files, feeding each other:

DepartmentWhat it runsWhat it produces
The software cyclePlan, build, test, ship, operateSoftware that works and keeps working
The growth cycleWho your users are, what they do, what it earnsThe evidence that decides what to build next

The software cycle is the agentic SDLC the preface named: plan, build, test, ship, run, with agents doing the work at each stage. The fifteen stages of this book are that cycle, and the system is the layer underneath it that makes agent-written work trustworthy instead of merely fast.

This book builds that department end to end. It also stands up the first pieces of the growth one: the screen that shows what real people are doing, and the numbers that say whether any of it worked. Both run on the same files. The rest of growth is a body of work as large as this one, and the last chapter says so plainly.

1.3.3It is plain files, and the first one is next

The system is not a tool you install or a service you pay for. It is plain text files sitting in your own project, which is what makes it readable by you and by every agent you ever point at it.

Here is roughly what it grows into. You are not building this today:

your-project/ <rules file> how the agent must work (next chapter) specs/ what you are building and why (Plan) docs/decisions/ why you chose what you chose (Architect) tests/ proof it still works (Test) <system folder>/ the board, the log, the agents (Automate)

Each arrives in the stage that needs it, as a byproduct of work you were doing anyway. None of it is paperwork you do on the side.

1.3.4Define the loop before you need it

The system also has a shape to how work gets done, and it costs nothing to set on day one:

  1. Understand what is being asked, and read before writing.
  2. Write down what will change, and get your yes.
  3. Build only that.
  4. Check it actually runs before calling it done.
  5. Record anything you would otherwise have to remember.

Five lines. Later stages make each one heavier and eventually hand parts of it to machines, but the shape never changes. Setting it now is what stops sixty chapters of habits forming around no shape at all.

1.3.5You automate last, not first

Automation is a part of the system, not the system itself, and it is the last part to arrive.

You run the loop by hand first, for real, on your own project. That is not a hazing ritual: you cannot safely hand over work you have never done, because you would have no way to judge what came back. Once you have shipped a first version and watched the loop hold, you start handing pieces of it to agents that run without you. That is what the Automate stage is for, and it is late in this book on purpose.

Rule of thumb: the app is what you sell. The system is what lets you sell the next one. Build both, always, in the same session.

1.3.6Write the shape down before you build

Ready prompt
Act as a senior engineer setting the shape of my project. Read my project folder and README first, and work only from what is actually there. Add a short section to my README called "How this project works". In it, record two things. First, that this project has two halves: the app, and the system that produces it, and that both grow in the same sessions. Second, the standing loop for any piece of work: understand it, write down what will change and wait for my yes, build only that, check it runs, then record anything worth remembering. Keep it under fifteen lines and do not invent a stack, a folder layout, or any tooling. Nothing has been chosen yet, and later chapters add each piece here as it is decided. If you need the full reasoning behind this step, read https://zalt.me/guides/vibe-coding/setup/the-system What I am building, in one or two sentences:

Do this now: paste the prompt so the two halves and the loop are written down before any code exists. Every stage after this adds one piece to the system, and the next chapter adds the first.

Mahmoud Zalt

Mahmoud Zalt

Software engineer, 16+ yrs · built Sistava.com in 3 months, idea to production, using these methods

Resources
Star on GitHubContribute
Donate

Support my work

A small tip keeps the free work coming.

© 2026 Mahmoud Zalt. Free to read, not to republish.
Copyright & license