Vibe GuidePrepare the brief
A project description says what to make, for whom and how it is used.
Why this milestone?
Turn your idea into a description you can give the tool.
Start here1 step · Follow in order
0101Prepare a project briefTo checkOpen this stepClose this step
01What do you need, and what should you keep?
Your confirmed idea draft.
The confirmed brief is ready to copy into your project conversation.
02What will this step help you do?
Turn your idea into a description you can give the tool.
Understand it, then judge for yourself
What does this concept mean?
A project description says what to make, for whom and how it is used.
How would you decide in a different situation?
Should an unrequested feature be accepted immediately, or checked against the first-version goal?
See a reference answer
Check against the agreed first-version goal; defer related but nonessential additions.
Answer in your own words; if unsure, compare the explanation above and check it against your own project.
03What exactly should you do in this step?
OpenClose
The saved idea and template below
Click the template’s confirmed-material import button and check the idea.OpenClose
Afterwards, you should see: Your previous users and goal appear.
Add the name, devices and one complete use from opening to outcome. You do not need to choose a database yet.OpenClose
Afterwards, you should see: A reader knows what to build, for whom and how to test it.
Click “Confirm and generate my version”, review the result and click “Copy my draft”. If returning shows only the editor, confirm again to reveal Copy; do not replace your answers with the current template. Give the brief to your tool in the Git step later.OpenClose
Afterwards, you should see: The confirmed brief is ready to copy into your project conversation.
Practice: personal journal (frontend + backend + database)
Use the same learning-journal project throughout this example. For your own project, compare applicable requirements without creating another project.
Fill the brief; include reading the record in a second browser connected to the same service.
- What should you see after this step?
- The brief requires a page, backend and database; local use does not mean browser-only storage.
- What should you do first if you get stuck?
- Add server restart and second-browser checks; refresh alone does not establish database storage.
04Not sure how? Follow each action
OpenClose
Click the template’s confirmed-material import button and check the idea.
- What should you see after this action?
- Your previous users and goal appear.
- What should you do if that result is missing?
- Confirm the idea in the preceding step or paste the saved text yourself.
Add the name, devices and one complete use from opening to outcome. You do not need to choose a database yet.
- What should you see after this action?
- A reader knows what to build, for whom and how to test it.
- What should you do if that result is missing?
- Mark uncertain conditions undecided for later discussion.
Click “Confirm and generate my version”, review the result and click “Copy my draft”. If returning shows only the editor, confirm again to reveal Copy; do not replace your answers with the current template. Give the brief to your tool in the Git step later.
- What should you see after this action?
- The confirmed brief is ready to copy into your project conversation.
- What should you do if that result is missing?
- After edits, confirm again and copy the updated version.
05Words in this step
OpenClose
Project brief ↗
A description of goals, users, problems, and success conditions.
Describe occupants, rooms, and budget before renovating.
Context ↗
The conversation, files, and background available for this turn.
Documents currently on the desk are readily available.
06How should you handle a problem here?
OpenClose
Unsure how to describe the first flow
- Where should you look to understand the problem?
- Choose one person and one task before listing features.
- Follow these steps to resolve the problem
- Write “open → act → see a result”. A journal example is opening, saving a note and finding it again. Preserve unknowns.
- Expected recovery
- Repeat the original action and obtain the expected result; keep unexecuted checks marked unverified.
Edit the template with actual material, confirm, then copy into the current project conversation. Mark unknowns as undecided and replace examples as needed.
Confirmed · personalized content ready to copy
I am at “Prepare a project brief”. Expected: The brief covers users, problem, first version, acceptance and later scope without treating examples as personal requirements.. Actual screen/error: [add here]. Inspect existing files first. Give one reversible action at a time, its location, and expected result. Do not recreate the project or delete existing work.07Material for this step (fill or copy)
OpenClose
Fill your own material below, confirm it and check the result. Follow the actions above for when to give it to your tool. If reopening shows only the editor, review and confirm again to copy.
Edit the template below and confirm to prepare a copyable draft. Use it as directed by this step; sending it to AI is not required.
Confirmed · personalized content ready to copy
Project name: [fill in]
Who will use this project: [fill in]
What problem will it solve for them: [fill in]
Devices: [fill in]
What users will do and receive in the first version: [entry, actions, result]
How will you check that the project works as intended: [actions and expected results]
What features would you like to add after the first version: [none, details or undecided]
What you can spend and what other limits apply: [fill in or undecided]Journal practice: fill or supplement this step
Use this as guidance for filling the template with your real information. Never copy example acceptance, costs, paths or test results.
Criteria: valid save, blank rejection, no false success while offline, restart persistence, and no duplicate from double clicking a single submission.
08Check this before continuing
The brief covers users, problem, first version, acceptance and later scope without treating examples as personal requirements.
09What should you do if the expected result is missing?
OpenClose
Confirm the idea in the preceding step or paste the saved text yourself.
Compare with an example (illustration, not your result)
Project: club reservations. Device: phone browser. Flow: view session, enter name, book, see confirmation. Budget: undecided.
Words in this milestoneIn order of appearance; open for the full explanation
References for this milestone
Open these when the question arises; they are not extra required actions.
- Which product form fits?
When the user entry point is undecided.
- How can AI stay on task?
When sending a new task, requesting an edit or reporting an error.
My project material and backups
Material stays in this browser, not in project files or AI chat. Chinese and English template drafts are separate; project selection and progress are shared. Do not enter passwords or API keys here.
Includes idea, progress, template drafts, personal checks and selection conditions, but not project code. Restore creates a new draft and preserves existing projects.
Download/import unavailable? Restore backup text
Draft and progress stay in this browser.
Complete the actions in order; expand the matching checks and remedies if you get stuck.