Human-readable reference for the Workflow Definition Format (.workflow.yaml). The Pydantic source of truth lives in shared-models/src/workflow_models/wdf/; YAML load/dump is in the CLI (cli.wdf_yaml).
| # | Document | Purpose |
|---|---|---|
| 1 | WDF syntax reference | Top-level YAML shape, slugs, edges, execution modes, validation overview |
| 2 | Node types reference | All 12 schema types (11 CLI-supported) with config fields |
| 3 | Variable references | {{slug.output.field}} paths per node type |
| 4 | Example workflows | Annotated patterns and sample graphs |
| 5 | Best practices | Generation rules for agents authoring YAML |
| 6 | Deployment & CLI | validate, push, run, credentials |
| 7 | Domain → WDF mapping | Translate business requirements into node choices |
- CLI command details:
../docs/validate-command.md,../docs/push-command.md - Example YAML files:
../shared-models/examples/ - Frontend
design:block (Designer layout):../../frontend/docs/workflow/designer/wdf-design-extension.md
- 12 node types in the WDF schema; 11 supported by
workflow validate/push/run - CLI unsupported:
document_extraction(schema-valid, fails validate check 10) - 13 validation checks (checks 11–13 need registry data; use
--offlineto skip them)