Skip to content

Cheat sheet ​

Every shape, arrow and setting on one page.

Shapes ​

ShapeWrite itSits in
Flowflow id["Title"] … endtop level of the workflow, or inside a flow
Taskid["Label"]inside a flow
Decisionid{"Question?"} or id["Question?"]@{ shape: decision }inside a flow
Inputid[/"Label"/] or id["Label"]@{ shape: input }top level of the workflow
Connectorconnector id["Label"]top level of the workflow

Arrows ​

ArrowWrite itConnects
Arrowa --> b, a --> b --> c, a --> b & cflows, tasks and decisions to each other; an input to a flow
Branchd -- yes --> b or d -->|yes| ban arrow leaving a decision is a branch, so it needs a label
Dotted linktask -.- connectora task and a connector, in either order

Settings ​

Settings go in @{ … } after the node, or on their own line as id@{ … }.

ShapeSettingRequiredValue
flowmodelnotext
flowinstructionnotext
taskinstructionyestext
decisioninstructionnotext
branchinstructionnotext, set through an arrow id: d e1@-- yes --> b then e1@{ … }
inputtriggeryes"schedule"
inputcrona schedule needs cron or at, not bothtext in crontab format, such as "0 9 * * 1-5"
inputata schedule needs cron or at, not botha date and 24-hour time, such as "2026-12-24T09:00"
inputtimezonenoa time zone name, such as "UTC"
connectorprotocolyes"mcp"
connectorurlyesa full address, such as "https://example.com/mcp"

An instruction can't hold an unfilled placeholder such as <REPO>. The schedule trigger and the cron format are in Triggers.

A complete workflow ​

Code:
mermaid
agentflow TB
  weekday[/"Weekdays at 09:00"/]@{ trigger: "schedule", cron: "0 9 * * 1-5" }
  connector github["GitHub"]@{ protocol: "mcp", url: "https://api.githubcopilot.com/mcp/" }

  flow triage["Issue triage"]@{ model: "claude-sonnet-4-5" }
    read["Read issues"]@{ instruction: "List the issues opened since yesterday." }
    kind{"Any bugs?"}
    label["Label bugs"]@{ instruction: "Add a priority label to each bug." }
    report["Report"]@{ instruction: "Post a one-line summary: no new bugs today." }
    read --> kind
    kind -- yes --> label
    kind -- no --> report
    read -.- github
    label -.- github
  end

  weekday --> triage
Ctrl + Enter|
Opens in mermaid.ai