workflows

# BB workflows Use a workflow when the user explicitly asks for multi-agent orchestration. Ordinary tasks do not authorize a workflow run. A workflow puts deterministic control flow around normal BB worker threads. The script can fan out work, pipeline stages, verify results, and return structured data. Worker threads retain normal workspace tools and permissions. ## Start safely 1. Inspect the task and repository before you choose the work list. 2. Confirm the provider, model, and reasoning tuple from the live catalog. 3. Write the smallest workflow that gives the requested coverage. 4. Validate the exact source before execution. 5. Start the background run. 6. Emit the returned workflow preview directive exactly once. 7. Use compact status for progress and paged history for details. Check an explicit model selection with: ```sh bb provider list --environment "$BB_ENVIRONMENT_ID" --json bb provider models <provider-id> --environment "$BB_ENVIRONMENT_ID" --json ``` Do not guess model identifiers or partial selection tuples. ## Read only the required detail - Read references/authoring.md when you write or change workflow source, schemas, agent options, or nested workflows. - Read references/orchestration.md when you design pipelines, barriers, verification, panels, loops, or other quality controls. - Read references/runs.md when you validate, start, inspect, stop, or resume a workflow. ## Minimal source Every script starts with a literal meta object: ```js ex...