# `motoko.yaml`

`motoko.yaml` is the workflow input file. It declares the task-manager
directories and the Python function that will orchestrate them.

## Minimal configuration

```yaml
task_managers:
  task1:
  task2:

orchestrator: orchestrator.main
```

## Detailed configuration

```yaml
task_managers:
  prepare:
  solve:
    host: zeo://cluster_name:8010
  analyze:

aliases:
  post: analyze

orchestrator: orchestrator.main

generator: slurmCoat
slurm_options:
  - nodes=1
```

## Fields

- `task_managers`: Required mapping. Each key is both the task-manager name and
  the relative directory name containing that task's BlackDynamite study. Empty
  values are allowed. A task manager may define `host` to override the default
  local ZEO host.
- `orchestrator`: Required string in `module.function` form. Motoko loads
  `module.py` from the workflow directory and calls
  `function(workflow, **params)`.
- `aliases`: Optional mapping from alternative workflow attribute names to
  task-manager names. For example, `post: analyze` allows `workflow.post` to
  access the `analyze` task manager.
- `generator`: Optional BlackDynamite launcher generator, such as bash, Slurm,
  or PBS.
- `*_options`: Optional launcher-specific option lists. Motoko derives the key
  from the generator name with `generator.replace("Coat", "_options")` and
  appends the listed values to the launcher command.