feature

Definition builder

The Definition Builder is where you author and test a Definition — chat with AI, preview on a chart, edit code, and fix errors before you collect events.

The product may label this screen Flow Builder in a few places. In help and everyday use, call it Definition Builder.

Open the builder

  • Research → Definitions → New definition — then AI or DIY

  • Or open an existing definition → Edit / Open builder

Layout

Panel

Job

Chat

Describe changes; AI edits the script

Chart

Preview emits on real bars

Code

Full script editor

Lints / Errors

Fix issues before collect

Switch tabs as needed. Chat and code stay in sync.

Author loop

  1. Pick an instrument and timeframe for preview

  2. Describe or code the setup logic

  3. Watch the chart for event markers

  4. Fix lints and runtime errors

  5. Save a version snapshot when preview looks right

Snapshot before collect

Chartnaut needs a saved version snapshot before a serious Collect run. The snapshot freezes the script so the dataset matches the code you tested.

Agents in the builder

Conductor may open the Definition Builder on your behalf during a delegation. You can take over anytime — same editor, same Definition.

What good looks like

Preview shows events only where you expect them — not on every bar. Lints are clean. You snapshot, then collect.

Important distinctions

Definition Builder = write setup logic.

Study builder = write questions over events — see Create a study.

Terminal = trade and chart live — not where Definitions are authored.

Next

  1. Versions and snapshots — freeze code

  2. Collect a dataset — run on history

  3. Indicator dependencies — import chart math