git.stella-ops.org/docs/workflow/tutorials/01-hello-world

Tutorial 1: Hello World

The simplest possible workflow: initialize state from a start request, activate a single human task, and complete the workflow when the task is done.

Concepts Introduced

• IDeclarativeWorkflow<T> — the contract every workflow implements
• WorkflowSpec.For<T>() — the builder entry point
• .InitializeState() — transforms the start request into workflow state
• .StartWith(task) — sets the first task to activate
• WorkflowHumanTask.For<T>() — defines a human task
• .OnComplete(flow => flow.Complete()) — terminal step

What Happens at Runtime

1. Client calls StartWorkflowAsync with WorkflowName = "Greeting" and payload { "customerName": "John" }
2. State initializes to { "customerName": "John" }
3. Task "Greet Customer" is created with status "Pending"
4. A user assigns the task to themselves, then completes it
5. OnComplete executes .Complete() — the workflow finishes

Variants

• C# Fluent DSL
• Canonical JSON

Next

Tutorial 2: Service Tasks — call external services before or after human tasks.