Build mode (Agent)

Build mode lets the agent make real project changes from your instructions.

Use it when you are ready for the agent to edit, generate, repair, or verify project work.

What Build mode can do

Depending on project context and available tools, Build mode can help with:

• Creating pages and components.
• Editing copy and layout.
• Generating project images that fit the page context and reviewing them as visual activity in chat.
• Connecting project-backed features when available.
• Debugging build or preview issues.
• Running checks and summarizing results.
• Looking up current public documentation, package references, changelogs, and troubleshooting sources when project context alone is not enough.
• Preparing publish-related changes when explicitly requested and approved.

Build mode works best when your request is specific.

When to use Build mode

Use Build mode when:

• You already know what should change.
• You reviewed or do not need a separate plan.
• The task has clear acceptance criteria.
• You are ready to inspect the preview afterward.

When not to use Build mode yet

Use Plan mode first when:

• The request affects many files.
• The app needs auth, payments, database, or publishing changes.
• You are not sure what the agent will need to touch.
• The project is important enough that you want a reviewable plan first.

Copyable build prompt

Build this change:

Update the dashboard empty state.
Goal: help new users create their first project.
Scope: only the dashboard empty state component.
Keep: existing navigation, colors, and layout structure.
After editing, summarize the files changed and what I should test.

Review after every build

After Build mode finishes:

• Open the preview.
• Test the changed flow.
• Expand image-generation or screenshot-validation activity only when you want to inspect the visual evidence.
• Check desktop and mobile when layout changed.
• Read the summary.
• Ask for clarification if the agent changed more than expected.
• Continue with a smaller follow-up prompt.

Safety expectations

Build mode changes real project state. Keep prompts narrow and do not ask for broad changes unless you are prepared to review them.

When the agent uses web research, it is read-only. It can search public pages, fetch safe previews, and extract bounded text from public sources. It should not log in, submit forms, use your cookies, download files, or treat web page text as instructions.

Publishing is especially sensitive. Read Publish your project before asking an agent to help with publish-related work.

Next steps

• Plan first: Plan mode
• Ask questions only: Chat only
• Use visual feedback: Visual edits