Builder Agent

The Builder Agent edits your project directly through conversation. Tell it what to change — text, layers, animations, interactions, scenes, variants, game mechanics, settings, and more — and it will execute the changes for you inside the PLAY editor.

Unlike the other specialties, the Builder Agent takes action. It doesn't just advise — it modifies your project in real time based on your instructions.

Note: This specialty is only available when you have a PLAY project open in the editor. It requires access to your project data to work.

---

How It Works

Describe what you want to change in plain language. The Builder Agent reads your current project, figures out which elements need to be modified, and applies the changes. It will explain what it did after each action so you can verify the result.

You can give commands at different levels of specificity:

Specific commands tell the agent exactly what to do. These are fast and precise.

"Resize the headline to 48px."

Compound commands combine multiple changes in a single message. The agent handles them in sequence.

"Center the image, increase the headline size, and set the pin to center-left."

Goal-based commands describe what you want the result to feel like, and the agent decides how to get there.

"Make this layout feel more sleak."

The agent works best with specific and compound commands. Goal-based commands may prompt the agent to ask clarifying questions before making changes.

---

What It Can Do

The Builder Agent covers nearly every editable aspect of a PLAY project. Below is a breakdown of its capabilities by category.

Text and Copy

Update text content, CTA copy, text color, alignment, and font. Change text across multiple layers or scenes at once. Fix text overflow issues.

"Update the headline to say 'Play Now' and change the font to bold."

Variants and Versioning

Create, rename, and delete variants. Sync changes across variants or apply changes to a specific variant only. Set up variants with different CTA colors, background images, themes, or URLs.

"Create two variants with different CTA button colors."

"Update the CTA 'Launch URL' across 3 variants with different URLs."

Note: The Builder Agent cannot create or edit variants for now. This feature will be coming soon!

Dynamic Content

Apply dynamic content conditions based on language, location, time, weather, or device. Remove dynamic content from layers, or organize dynamic layers into groups.

"Make my project dynamic for English and Spanish."

"Apply location-based dynamic content to the headline."

Transform and Layout

Move, resize, rotate, flip, and reposition layers. Align layers to an axis, create evenly spaced grids, lock aspect ratios, and adjust scaling and pinning. Fix misaligned elements or resize a layer to fill the artboard.

"Align the logo and CTA to the bottom center."

"Make the background image fill the artboard without stretching."

Responsivity

Adjust the responsivity properties of layers so your project looks correct across different screen sizes and orientations. The agent updates pinning, scaling, and layout behavior per layer — not the artboard size.

"Make my project responsive across screen sizes."

Timeline

Adjust when layers appear and disappear. Align or stagger the start and end times of multiple layers.

"Stagger the entrance of all layers in the first scene by 0.2 seconds."

Animations

Add enter, idle, and exit animations. Update animation duration, easing, type, and transitions. Configure dual animations or apply animations to multiple layers at once. You can also describe an animation in plain language and the agent will interpret it.

"Add a fade-in entrance animation to the logo."

"Apply intro animations to layers in the first scene."

Interactions and Behaviors

Add, remove, and update interactions on layers. Configure press effects, create hotspots with overlays, hide layers on button press, or assign multiple actions to a single gesture.

"Add a tap interaction to the CTA that launches the store URL."

"Create a fullscreen hotspot that overlays the end card."

Scenes

Add, configure, and manage scenes. Update autoplay and duration settings, add scene events with time-based triggers, and mark scenes as end scenes.

"Add a new starting scene that auto-transitions after 3 seconds."

Asset and Layer Management

Add image, video, sequence, hotspot, and text layers. Replace assets in a scene, group and rename layers, convert layers to global layers, and reorder the layer stack. The agent can also update video and sequence settings after adding them.

"Replace the background image in the end card scene."

"Rename all layers for clarity."

Global Layers

Add, replace, rename, unlink, and delete global layers. Add a global layer to all scenes at once.

"Convert the CTA button to a global layer and add it to all scenes."

Game Mechanics and Components

Add game mechanic layers (Memory, Drag & Drop, Slide Puzzle, Item Catcher, Endless Runner, Slide to Reveal, Hidden Object, Item Slicer, Swap Match 3, Wipe Away, Platformer) and component layers (Progress Text, Timer, Progress Bar, Countdown, Scrollable, Carousel, iFrame). Update properties and configure finish conditions for games.

"Add a Memory game mechanic to this scene."

"Add a countdown that tracks scene duration."

Settings Panel

Change artboard orientation and aspect ratio. Add and configure background music, global timers, global progression, and propagate URLs.

"Change the artboard to landscape orientation."

Asset Editing

Edit image and video size, crop to remove empty space or to a preset, optimize assets, trim video, and save edited assets with new file names.

"Crop the hero image to remove empty space and optimize it."

Project Scoring

When your project has score violations, the agent can identify and fix them.

"Fix the project score issues."

---

How to Use It

Open CRAFTSMAN INTELLIGENCE and describe the change you want to make. You can be as specific or as broad as you like.

Template Prompts

Click the Builder Agent card in the chat panel to see template prompts you can send with a single click:

• Add a CTA button to all scenes.

• Make my project responsive across screen sizes.

• Apply intro animations to layers in the first scene.

• Make my project dynamic for English and Spanish.

• Add a countdown that tracks scene duration.

Multi-Step Tasks

The Builder Agent handles complex, multi-step tasks. You can combine several changes into a single request and the agent will work through them in order.

"Create a new variant, change the background image, and update the CTA URL."

"Add a headline, animate its entrance, and position it above the CTA."

Ambiguous Requests

If your request is vague or could be interpreted multiple ways, the agent may ask a clarifying question before acting. This is by design — it's safer to confirm intent than to guess.

"Make this more interactive" → The agent may ask what kind of interactivity you're looking for.

---

Tips

• Start specific, then go broad. The agent performs best with clear, targeted instructions. Once you're comfortable, try larger compound commands.

• Review changes as you go. The agent explains what it changed after each action. Take a moment to verify before moving on.

• Name your layers clearly. The agent references layers by name. Clear, descriptive layer names (e.g., "Hero Image - Scene 1" instead of "Layer 4") make commands more accurate and help with analytics tracking later.

• Combine with Design Recommendations. Get feedback from Design Recommendations first, then tell the Builder Agent to implement the suggested changes.

• Use undo if needed. If the agent makes a change you don't want, you can undo it — just like any manual edit in the editor.