Vibe GuideBETA

Record the idea

Write users, problem and a practical success check.

What will you have after this node?
The draft retains your users, problem and test.
Why this milestone?

Name one problem so AI knows what to help you build.

Start here1 step · Follow in order

0101Write down the ideaTo checkOpen this stepClose this step
Who will use this project?
What problem will it solve for them?
How will you check that the project works as intended?
Illustration · not an app screenshot

01What do you need, and what should you keep?

What do you need before starting?

One problem you want to solve.

What should you keep for the next step?

The draft retains your users, problem and test.

02What will this step help you do?

Name one problem so AI knows what to help you build.

Understand it, then judge for yourself

What does this concept mean?

Write users, problem and a practical success check.

How would you decide in a different situation?

Whose problem does this solve?

See a reference answer

Name real users, their difficulty and the changed outcome; a platform alone is not a goal.

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

In the draft on this page

  1. Find “07 Material for this step” and the “Make this template personal” text box below. Keep all four questions and replace only the bracketed guidance with your answers. Start with “Who will use this project”, such as yourself.OpenClose

    Afterwards, you should see: The first question contains your user and the other questions remain.

  2. In the same box, find the question about the problem the project should solve. Describe the current difficulty and what you want to do with the finished project.OpenClose

    Afterwards, you should see: A concrete flow, such as enter notes, save them and find them later.

  3. Describe how you will test success, then click Confirm and generate my idea. Put “none” for later features if unnecessary.OpenClose

    Afterwards, you should see: The draft retains your users, problem and test.

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.

Write your own goal: record what you learned and find it after closing the page and restarting. This practice is for personal local use.

What should you see after this step?
You can describe writing, saving and finding a record.
What should you do first if you get stuck?
Use one thing learned today as test content, not as fabricated acceptance evidence.

04Not sure how? Follow each action

OpenClose
  1. Find “07 Material for this step” and the “Make this template personal” text box below. Keep all four questions and replace only the bracketed guidance with your answers. Start with “Who will use this project”, such as yourself.

    What should you see after this action?
    The first question contains your user and the other questions remain.
    What should you do if that result is missing?
    Start with a recent problem you personally faced.
  2. In the same box, find the question about the problem the project should solve. Describe the current difficulty and what you want to do with the finished project.

    What should you see after this action?
    A concrete flow, such as enter notes, save them and find them later.
    What should you do if that result is missing?
    Replace “a useful website” with what someone will actually do.
  3. Describe how you will test success, then click Confirm and generate my idea. Put “none” for later features if unnecessary.

    What should you see after this action?
    The draft retains your users, problem and test.
    What should you do if that result is missing?
    Fill missing fields and confirm again; mark unknowns undecided.

05Words in this step

OpenClose

Project brief ↗

A description of goals, users, problems, and success conditions.

Describe occupants, rooms, and budget before renovating.

Acceptance criteria ↗

Observable conditions used to accept completed work.

Instead of “fast service,” require a collection number after payment.

06How should you handle a problem here?

OpenClose

I only know I want a website

Where should you look to understand the problem?
Think of one repetitive task from today.
Follow these steps to resolve the problem
Write just one real difficulty and mark the rest undecided.
Expected recovery
The draft identifies a user and an observable result. Other fields may remain undecided.

Not listed? Ask AI to investigate

Edit the template with actual material, confirm, then copy into the current project conversation. Mark unknowns as undecided and replace examples as needed.

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.

Replace the bracketed fields, or write undecided, then confirm.

Add details (optional for now)
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.

Project: personal learning journal. User: myself. Version one: enter title and body, save in a backend database and read history. No login, sharing, editing or deletion yet.

08Check this before continuing

The draft says who will use the project, what problem it solves for them, and how to check that it works as intended. Plans for a second phase may be none or undecided. Once confirmed, the draft stays in this browser and can be copied.

09What should you do if the expected result is missing?

OpenClose

Start with a recent problem you personally faced.

Compare with an example (illustration, not your result)
Who will use this project: club members. Problem: chat signups get lost. Pass: submit and see a reservation; repeating it does not reserve twice.

Words in this milestoneIn order of appearance; open for the full explanation

More troubleshooting references

Stuck? Start with what actually happens

2 situations

These paths synthesize official docs and public reports, not frequency data. Check the symptom and verify the result.

Complete personal notes first; save the prompt for the next discussion.

The idea is only a slogan

Observed symptom: “Build a management system” does not explain a real use.

  1. What should you check first?

    Identify the person, current workaround, and one frustrating episode.

  2. Then resolve

    Personally write the person, situation, task, difficulty, and visible outcome. Defer technology; use the prompt in the next discussion step.

  3. Verify the result

    Three sentences describe one person completing one task.

Complete the worksheet first; use this in the next step

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.

ReferencesMDN · Plan a first website ↗

Existing material is scattered

Observed symptom: Images, spreadsheets, and notes are scattered; AI must guess the business.

  1. What should you check first?

    Separate real material, personal assumptions, and illustrative examples.

  2. Then resolve

    Create idea.md with a material list and purpose; redact sensitive data. Label examples “For example” and preserve unknowns.

  3. Verify the result

    Each material has a purpose, and unknowns remain explicit.

Complete the worksheet first; use this in the next step

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.

ReferencesMDN · Plan a first website ↗

References for this milestone

Open these when the question arises; they are not extra required actions.

Look up this milestone’s terms →
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.

Find the starting point

Module shortcuts

What people build · AI revenue research · 50 ideas · GitHubComplete roadmap · idea to releaseWrite down the ideaI only know I want a websitePrepare a project briefUnsure how to describe the first flowOpen an AI tool that can edit filesInstallation, sign-in, or the screen differsCreate a folder for the projectDocuments or the folder is missingOpen that folder in the AI toolAI names a different projectCreate Git history and project instructionsCommit fails or asks for identityInspect a file AI actually createdPrevious files are missingAnswer one question at a timeAI asks about unfamiliar technical termsChoose only this version’s essentialsReducing scope left only a pictureKeep the agreement in plain languageThe document is too long to reviewDescribe how people will use itAI lists features without a user flowReview a key screen before buildingThe prototype may use simulated behaviorLet AI choose from actual conditionsI do not know local versus shared storageAsk AI for the next small taskThe first task just says “build frontend”Check the runtime and start the projectInstallation or startup failsOpen the first page of the projectThe preview will not openAdjust this page onlyA visual edit changed other behaviorMake Save retain real contentCannot save, or records vanish on refreshFinish the whole flow onceThe button responds but nothing happensTry blank input and repeated clicksBlank or duplicate records appearReopen it after stoppingThe address fails the next dayCheck it against the original ideaAI says done, but I cannot use itRecord the trial feedbackThe issue happens intermittentlyPlan the fix and its passing checksAI starts fixing without a planFix according to plan and hand back for retestingThe same action still fails after a claimed fixChoose: personal use or sharingThe shared local link does not openAssess readiness for deliveryReadiness is claimed without evidencePrepare and try the deliverableInstaller or deployed application failsApprove delivery and verify the real entryIt opens locally but not for othersOptional: publish a simple page on GitHub PagesThe public URL returns 404Continue next time without starting overAI wants to start over in a new chatChoose a tool · Codex Claude Cursor Qoder TRAE Kimi pricingHomeProject typesTalking to agents · prompts and troubleshootingChoosing a stackFrontend & UI · component dictionaryGlossary · AI and development · examples and diagramsOpen the tool and verify project accessPrepare the project, version history, and AI rulesDescribe the intended interface styleHelp AI change exactly one targetBackend: storage and accessTesting: check that it worksDeployment: deliver a real entry pointMaintenance: keep the product usableWebsites & web apps · The idea, one link away.Mini programs · Build where the users already are.Mobile apps · Turn a good idea into an everyday app.Desktop apps · Make a tool for repetitive tasks.

A practical guide for beginners

This bilingual practical guide has 6 stages, 18 milestones and 31 actions. App illustrations are examples; users verify their own project results.