Skip to main content

Chat agents

This page explains the three agents of the AI chat and when to use each one.

These are the agents of the chat in the editor. An AI client such as Claude Code or Cursor works on your site through the MCP Bridge instead.

Pick an agent with the selector at the top of the chat: Builder, Designer or Writer. Each one can change a different part of your page.

The agent selector at the top of the chat, with Builder, Designer and Writer, Builder selected

Builder​

The Builder is the general-purpose agent. It handles page structure, layout, HTML, CSS, dynamic data and JavaScript.

When to use it:

  • Building a new section from scratch
  • Adding or removing blocks
  • Restructuring a layout
  • Showing dynamic content, such as the post title or a list of posts

Example prompts:

  • "Add a gallery section: the six rooms, each with its number, name, a short description and a photo, alternating sides"
  • "Add a blog post grid with 3 columns"
  • "Make this section display the post title and excerpt"

The Builder agent adding a gallery section: its heading, then each room with its number, name, description and photo

Recommended workflow

Start with the Builder to create the structure. Switch to the Designer for styling. Then use the Writer to polish the copy. Most pages come together in that order.

Designer​

The Designer handles visual styling: colors, typography, spacing, layout and animations. It writes CSS and changes the classes and attributes of your blocks.

It can't add, remove or move blocks. It only changes how things look. Ask it for a new block and it tells you to switch to the Builder.

When to use it:

  • Adjusting colors or color schemes
  • Changing fonts and typography
  • Fixing spacing and alignment
  • Making layouts responsive
  • Adding hover effects or transitions

Example prompts:

  • "Make the heading larger with more spacing below"
  • "Make the gallery darker: a deep olive background, cream text, and the room numbers in terracotta"
  • "Add a subtle hover effect on the cards"

The Designer agent turning the same gallery deep olive, with cream text and terracotta room numbers

Writer​

The Writer writes and edits text. It adjusts tone, improves copy and helps with messaging.

It can't change the page structure or the styling. Only text.

When to use it:

  • Writing headlines and subheadings
  • Improving existing copy
  • Adjusting the tone of voice
  • Working the text for SEO

Example prompts:

  • "Rewrite the gallery heading and the room descriptions: shorter, warmer, one concrete detail each"
  • "Make the body text more concise"
  • "Write a compelling CTA for a SaaS landing page"

The Writer agent rewriting the same gallery's heading and room descriptions, the Designer's colors kept

Switching between agents​

The agent you pick stays selected for every message until you change it.

Switching agents starts a new conversation: the previous messages and their Undo and Restore buttons go away. Your page stays as it is, and the new agent reads it before it answers.

Common mistake

The new agent doesn't see the messages you sent the previous one. Say what you want again in your first message: "Make the gallery we just built darker, with cream text" works, "Now style it" doesn't.

Next steps​