Vibe GuideBETA

Create the project folder

A folder stores project files; its path tells you where it is.

What will you have after this node?
The confirmed location can be carried into the next step and leads to the same project.
Why this milestone?

Keep project files together so you can find them next time.

Start here1 step · Follow in order

0101Create a folder for the projectTo checkOpen this stepClose this step
Documents
Your project folderNew folder
Illustration · not an app screenshot

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

What do you need before starting?

A name for your project.

What should you keep for the next step?

The confirmed location can be carried into the next step and leads to the same project.

02What will this step help you do?

Keep project files together so you can find them next time.

Understand it, then judge for yourself

What does this concept mean?

A folder stores project files; its path tells you where it is.

How would you decide in a different situation?

Where are the files actually stored?

See a reference answer

Identify the actual local path or web workspace and export options. Guide drafts are not the code directory.

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 file manager or web tool project list

  1. Open Documents in Finder or File Explorer. For a web workspace, create a project in its project list instead.OpenClose

    Afterwards, you should see: You have a dedicated place for this project.

  2. For a local folder, press Shift+Command+N on Mac or Ctrl+Shift+N on Windows, type your project name and press Enter. In a web tool, enter the name in its new-project form and confirm; do not use a local-folder shortcut.OpenClose

    Afterwards, you should see: The new folder or web workspace opens.

  3. Copy the location into the template in section 07 and confirm it. On Mac select the folder and press Option+Command+C; on Windows copy its address bar. For a web workspace, record its name and URL.OpenClose

    Afterwards, you should see: The confirmed location can be carried into the next step and leads to the same project.

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.

Create learning-journal in Documents. It is the practice project, not this guide repository.

What should you see after this step?
You know the full location and it does not contain another project.
What should you do first if you get stuck?
Inspect an existing folder; do not empty it. Use learning-journal-practice if necessary.

04Not sure how? Follow each action

OpenClose
  1. Open Documents in Finder or File Explorer. For a web workspace, create a project in its project list instead.

    What should you see after this action?
    You have a dedicated place for this project.
    What should you do if that result is missing?
    Do not reuse or empty an unrelated project folder.
  2. For a local folder, press Shift+Command+N on Mac or Ctrl+Shift+N on Windows, type your project name and press Enter. In a web tool, enter the name in its new-project form and confirm; do not use a local-folder shortcut.

    What should you see after this action?
    The new folder or web workspace opens.
    What should you do if that result is missing?
    Inspect an existing same-named folder before reusing it.
  3. Copy the location into the template in section 07 and confirm it. On Mac select the folder and press Option+Command+C; on Windows copy its address bar. For a web workspace, record its name and URL.

    What should you see after this action?
    The confirmed location can be carried into the next step and leads to the same project.
    What should you do if that result is missing?
    Use your own path; record its parent folder and name if needed.

05Words in this step

OpenClose

Root directory ↗

The top directory of a filesystem or project hierarchy.

Distinguish the building entrance from a department entrance.

Absolute / Relative path ↗

A location measured from a root or current directory.

A full street address versus directions from here.

06How should you handle a problem here?

OpenClose

Documents or the folder is missing

Where should you look to understand the problem?
Confirm you are in the computer’s file manager (Mac Finder / Windows File Explorer), not a browser file list.
Follow these steps to resolve the problem
Mac: Go → Documents. Windows: File Explorer → Documents. Find the existing folder rather than creating a duplicate.
Expected recovery
One definite project folder can be opened in the computer’s file manager.

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.

Worksheet for this 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.

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.

Enter your own computer path rather than an author’s username or path.

08Check this before continuing

The project folder/workspace opens and its real location is known.

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

OpenClose

Do not reuse or empty an unrelated project folder.

Compare with an example (illustration, not your result)
book-club/ ← select this folder
  idea.md ← created by the “Prepare Git and project rules” milestone
  docs/ ← later documents
Examples and reference

Documents / learning-journal /

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.

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.