Syntax Reference
Complete reference for the taskflow DSL.
This chapter is the detailed field-and-behavior reference for the taskflow DSL. Where Concepts gives you the mental model in prose, this chapter tells you exactly which fields exist, what type each one is, what its default is, and what /tf verify will reject. Reach for it when you are writing a real flow and need a precise answer.
Every page is exhaustive: a friendly walkthrough up top, then a field-reference table and a validation table at the bottom. You can read them straight through, or jump straight to the table when you know what you are looking for.
Suggested reading order
The pages layer on top of each other. Read them in this order the first time:
Flow Definition — the top-level container: name, args, concurrency, budget, agentScope, incremental, and the phases array.
Phase Types — every field on every one of the ten phase types, plus the per-type requirement matrix.
Control Flow — when guards, join, retry, timeout, and self-healing gates.
Caching — within-run resume and cross-run memoization, fingerprints, and TTLs.
Budget — run-wide cost and token caps, and what happens when a ceiling is hit.
Writing your first flow? Skim Flow Definition and Phase Types, then keep this chapter open in a tab. Run /tf verify after every change — it catches every hard error on these pages at zero token cost.
The pages
Flow Definition
Top-level fields and structure.
Phase Types
Every field for every phase type.
Control Flow
when, join, routing, retries.
Caching
Within-run and cross-run memoization.
Budget
Cost and token caps.
Last updated on
Was this helpful?
Help us improve the docs or ask a question in the community.