Skip to main content
Vibe Code Forum

Article: Write a one-page plan before you prompt

The biggest difference between projects that ship and projects that spiral is ten minutes of planning. AI tools build exactly what you describe. If you haven't decided what you want, they decide for you, differently each time.

The one-page plan

Copy this into a file called PLAN.md in your project (or the first message to an app builder) and fill it in:

# What it is
One sentence: [App name] helps [who] to [do what] so that [why it matters].

# Who uses it
- Main user: ...
- Other users (admins, guests): ...

# Must do (version 1)
1. ...
2. ...
3. ...

# Not now (later, maybe)
- ...

# Screens
- Home: ...
- [Screen]: ...

# Data it keeps
- [Thing]: fields ...

# Rules
- Who can see / change what: ...

# Done means
- A new user can ... without help.
- It works on a phone.

Tips

  • Three to five "must do" items. If you have twelve, version 1 is too big. Move the rest to "Not now".
  • Write "Not now" on purpose. It stops the AI (and you) adding features nobody asked for yet.
  • Describe screens in words, or sketch them on paper and upload a photo. Tools understand images.
  • Name the data. "A booking has a date, a time, a customer name and a status" prevents a lot of rework later.
  • Write the rules down, even obvious ones: "customers only see their own bookings". These become your security checks. See Sign-in and accounts.

Members can copy a one-page version with a worked example: the app spec template.

Let the AI improve it

Before building, ask: "Read PLAN.md. What's unclear or missing? What would you simplify for a first version? Suggest a simple stack and explain why." Answer its questions, update the plan, then start building feature 1 only.

Keep it alive

Update the plan as you go: tick off what's done, note decisions ("we're using Supabase for sign-in"). In editors and agents, tell the AI to read it at the start of each session. It is the cheapest way to beat the AI's memory limits. See Tokens, context windows and why the AI forgets.

More in Build guides