Vibe GuideBETA

Plan maintenance and the next change

A backup keeps another copy; restoration proves that copy can be opened and used.

What will you have after this node?
The next session can find the project and next task.
Why this milestone?

Record startup, backups and the next task so you can resume later.

Start here1 step · Follow in order

0101Continue next time without starting overTo checkOpen this stepClose this step
Open the project folder you used last time
Read the saved progress and startup instructions
Continue the next unfinished task in the plan
Illustration · not an app screenshot

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

What do you need before starting?

Your working project, data location and unfinished tasks.

What should you keep for the next step?

The next session can find the project and next task.

Which files should AI read and save in this step?

In your tool’s project chat, ask it to open the files below. If a file is missing, follow the link back to the step that creates it.

Ask AI to read these materials first: docs/release.md

Ask AI to save the result to: docs/handoff.md

Missing these materials? Return to the step that creates them →

02What will this step help you do?

Record startup, backups and the next task so you can resume later.

Understand it, then judge for yourself

What does this concept mean?

A backup keeps another copy; restoration proves that copy can be opened and used.

How would you decide in a different situation?

Can code alone restore data entered later?

See a reference answer

Usually not. User data may live in a database, service or browser; back up and test restoration separately.

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 original project and task notes

Send one action at a time: select and copy its prompt (⌘C on Mac, Ctrl+C on Windows), switch to your tool’s project chat, paste it, replace bracketed fields and send. Wait for the reply and check the stated result before continuing.

  1. Distinguish code, application data and learning drafts. Follow the database backup and restoration actions only when your project uses a database. Otherwise back up its actual files, then continue to the final handoff action.OpenClose

    Suggested prompt:

    List code and actual data locations and how/where each is backed up. A commit does not replace a database backup.

    Afterwards, you should see: Each backup source and destination is clear.

  2. Create a new dated backup without overwriting older files.OpenClose

    Suggested prompt:

    Use the database’s supported consistent-backup method. Report source, destination and current record count, then output size. Preserve original data.

    Afterwards, you should see: A nonempty backup exists at the reported location.

  3. Restore into a separate test location and actually read the records.OpenClose

    Suggested prompt:

    Restore to a separate test destination. Show source and target paths first. Start only a test service connected to the copy and give its URL. Never overwrite the source.

    Afterwards, you should see: The restored copy opens with records from the backup.

  4. Open the restored copy’s URL and save “restore test 001”. Give its ID to the tool and check that it is absent from the original database. If saving fails, report the error instead of claiming success.OpenClose

    Suggested prompt:

    I added “restore test 001” only to the restored copy, with ID [fill in]. Check the copy’s old and new records, and read-only verify that the original does not contain this addition. Record backup location, restoration method and actual results in docs/handoff.md, then stop the test service. Do not modify the original database.

    Afterwards, you should see: The copy saves new records, the original is unchanged, and restoration instructions are saved.

  5. Record where to resume next time.OpenClose

    Suggested prompt:

    Update docs/handoff.md with location, revision, startup, open issues and next task. A new chat should read it rather than recreate the project.

    Afterwards, you should see: The next session can find the project and next task.

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.

Back up the database as documented, restore to an isolated directory, verify the record and read the handoff next time.

What should you see after this step?
The backup restores successfully without overwriting the original.
What should you do first if you get stuck?
Copying an actively written database may be incomplete; use SQLite backup or a verified stopped-service copy.

04Not sure how? Follow each action

OpenClose
  1. Distinguish code, application data and learning drafts. Follow the database backup and restoration actions only when your project uses a database. Otherwise back up its actual files, then continue to the final handoff action.

    What should you see after this action?
    Each backup source and destination is clear.
    What should you do if that result is missing?
    Ask for data storage if only a repository is listed.
  2. Create a new dated backup without overwriting older files.

    What should you see after this action?
    A nonempty backup exists at the reported location.
    What should you do if that result is missing?
    Check space, path and permissions on failure.
  3. Restore into a separate test location and actually read the records.

    What should you see after this action?
    The restored copy opens with records from the backup.
    What should you do if that result is missing?
    Stop if the paths match or are uncertain.
  4. Open the restored copy’s URL and save “restore test 001”. Give its ID to the tool and check that it is absent from the original database. If saving fails, report the error instead of claiming success.

    What should you see after this action?
    The copy saves new records, the original is unchanged, and restoration instructions are saved.
    What should you do if that result is missing?
    Preserve mismatches and inspect backup time/paths.
  5. Record where to resume next time.

    What should you see after this action?
    The next session can find the project and next task.
    What should you do if that result is missing?
    Describe new scope and update requirements/plans first.

05Words in this step

OpenClose

Backup ↗

A data copy retained for recovery.

Keep a spare ledger and check it can be read.

Monitoring ↗

Ongoing observation of system behavior.

Watch operating gauges over time.

Database migration ↗

A tracked change to database structure or data.

Add a ledger column while handling existing records.

06How should you handle a problem here?

OpenClose

AI wants to start over in a new chat

Where should you look to understand the problem?
Check that the new conversation belongs to the original folder.
Follow these steps to resolve the problem
Ask it to read idea.md, requirements, README, and tasks, then restate the state. Continue only the next unfinished item after a correct restatement.
Expected recovery
Original work is preserved and the next task is identifiable.

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

If you completed the individual prompts above, do not resend this full template. Use it to organize this step’s material when needed; replace bracketed fields, confirm and copy into the project chat.

Prompt template for this step

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

Journal practice: fill or supplement this step

For this full-stack practice only: use this combined prompt, fill its fields and send it once instead of also sending the generic template. It does not authorize later steps.

Full-stack practice: this step

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

08Check this before continuing

Know the file and task to resume, and how records are backed up.

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

OpenClose

Ask for data storage if only a repository is listed.

Compare with an example (illustration, not your result)
Backup example: weekly, owner, service backup entry, restore in test and compare records; preserve the source on failure. Adjust frequency to acceptable loss.

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.

Costs rise after release

Observed symptom: An overage bill arrives without an obvious cause.

  1. What should you check first?

    Inspect per-service usage, time range, recent changes, and subscription versus metered charges.

  2. Then resolve

    Configure alerts or supported hard limits per platform. Investigate logs for loops or abuse before changing behavior.

  3. Verify the result

    Major costs are explained; alerts are checked and service-pausing limits are identified.

Send this to AI for help

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

ReferencesVercel · Spend Management ↗

Git cannot restore deleted user data

Observed symptom: Restoring code does not restore database records.

  1. What should you check first?

    Inspect code history, database backups, file-storage backups, and recovery points separately.

  2. Then resolve

    Restore a backup in an isolated test environment and verify records. Do not practice on production. Database backups may exclude uploaded files.

  3. Verify the result

    A tested restoration procedure identifies recovery time and file coverage.

Send this to AI for help

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

ReferencesSupabase · Database backups ↗

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.