Workflow Export Formats
Workflow Export Formats
Operator is a kanban-shaped orchestrator: each ticket carries the work, and its issue type carries an Operator workflow — an ordered graph of steps (tasks, classifiers, delegators, fan-outs, pipelines, human review gates). That JSON-defined workflow is the native format, and it is what collections share.
A workflow export renders a ticket + issue type pair into a concrete
orchestration format some other tool or model can execute. Exports are
derived from the native workflow — never the other way round.
This is export-only and lossy-by-design: Operator emits the format; it does not parse one back. Shapes a target can’t represent natively (human review gates, fan-out, RAG/MCP) are flattened deterministically and annotated, so the same input always produces the same output.
Formats
| Format | Artifact | Status | Docs |
|---|---|---|---|
| Claude Workflow | .js (Claude Code dynamic workflow) |
GA | Claude Workflow |
| AGNT Workflow | .json (AGNT.gg graph) |
Alpha | AGNT Workflow |
The authoritative, machine-readable list is the
GET /api/v1/workflow-formats
endpoint, derived from the same source of truth that backs this page.
How to export
CLI:
operator workflow export FEAT-1234 # default: claude (.js)
operator workflow export FEAT-1234 --format agnt
REST (the web UI and VS Code use the same shared code path):
# Concrete ticket -> workflow
curl -X POST "http://localhost:7008/api/v1/tickets/FEAT-1234/workflow-export?format=claude"
# Issue type alone -> preview (placeholder values, no ticket required)
curl "http://localhost:7008/api/v1/issuetypes/FEAT/workflow-preview?format=agnt"
# Discover the available formats
curl "http://localhost:7008/api/v1/workflow-formats"
In the TUI, web UI, and VS Code, the Workflows section lists the formats and links to preview/export.