Skip to main content

AI-Assisted Editing

You can use AI to modify your Blueprints by describing what you want in natural language. Press Ctrl+I (or Cmd+I on Mac) to open the AI prompt bar, type your instruction, and let AI make the changes for you. AI editing works at different levels — from changing a single element to restructuring an entire Blueprint. The scope adapts to your selection. For a different way to use AI — reconciling your written descriptions with your logic so they stay aligned — see Sync & Suggestions.

Opening the AI prompt

There are two ways to start an AI edit:
  • Press Ctrl+I (or Cmd+I on Mac)
  • Click the sparkles icon in the right-edge toolbar of a maximized Blueprint
Before triggering, select your target — click an element, a section header, or nothing (for the whole Blueprint). The AI prompt bar appears near your selection. The AI prompt bar — a floating input labeled "What would you like to change?" appears next to the selected node The prompt bar shows what you’re editing:
  • “Editing Assignment · Free delivery benefit” — scoped to a single element
  • “Editing Section · Free Delivery Threshold” — scoped to a section
  • “Editing Blueprint · Delivery Fee Calculation” — scoped to the entire Blueprint
When no element or section is selected, the prompt bar appears without a scope indicator — it targets the entire Blueprint.

Context-sensitive scope

The AI adapts its scope based on your selection:
What you selectAI scopeExample prompt
An element (assignment, decision, etc.)Changes only that element”Change the fee to 5 EUR instead of 0”
A section headerChanges elements within that section”Add an additional condition for express delivery”
Nothing (click empty canvas, then Ctrl+I)Changes the entire Blueprint”Add a new section that applies a bulk discount for orders over 200 EUR”
This scoping means you can make precise, targeted changes without affecting the rest of your logic — or make sweeping structural changes when needed.

Reviewing AI changes

After you submit a prompt, AI proposes changes and enters Review mode. You don’t have to accept changes blindly — you get to review them first. In Review mode:
  • Added elements are highlighted in green
  • Removed elements are highlighted in red
  • Modified elements show the changes visually
  • A summary bar shows the total changes: for example, “3 changes: 1 added, 2 modified”
You have two options:
  • Apply All — accepts all proposed changes
  • Reject All — discards all changes and returns to the previous state
While AI is proposing changes, the editor switches to read-only mode to prevent conflicting edits.

What AI editing can do

Small changes

Adjust a single expression, rename an element, or update a condition:
  • “Change the free delivery threshold from 50 to 75 EUR”
  • “Rename this section to Cart Value Check”
  • “Update the error message to include the minimum cart value”

Structural changes

Add new sections, reorganize logic, or introduce new decision branches:
  • “Add a section that calculates a bulk discount for orders with more than 10 items”
  • “Split this section into two: one for validating the cart value and one for checking the delivery distance”
  • “Add a new condition that waives the delivery fee for orders over 100 EUR”
When you make structural changes, AI updates everything — the elements on the canvas, the section hierarchy, titles, descriptions, and expressions. Both the Specification view document and the Diagram view reflect the updates as soon as you apply them.

Tips

  • Be specific — “Change deliveryFee to 5” works better than “make it cheaper”
  • Start small — try element-level edits before restructuring entire sections
  • Use Review mode — always check what AI changed before applying
  • Combine with inline editing — use AI for structural changes, then fine-tune expressions and descriptions manually with inline editing

What to do next