| name | run-scenario |
| description | Execute a ScenarioConfiguration and stream ScenarioRun status with per-action breakdown until terminal state. |
RunScenario — Scenario Execution & Status Streaming
⛔ ABSOLUTE RULE: Do NOT improvise, skip, or substitute any step. On ANY error, STOP and wait for the user.
When to use this skill (vs. the MCP server)
This skill is the human-interactive path: it reads run context from startchaos-state.json, renders status cards, and persists the run result. Use it when there is a user in the loop.
If you are an autonomous agent with no user to prompt, use chaos_execute_scenario + chaos_get_scenario_run (MCP) for a non-interactive run-and-poll flow. Cancellation: chaos_cancel_scenario_run. See mcp/README.md.
Both surfaces target Microsoft.Chaos 2026-05-01-preview and use the local az login session for auth.
How It Works
All execution and status-streaming logic lives in scripts/Invoke-RunScenario.ps1. The script handles confirmation gating, starting the run via az chaos scenario run start --skip-validation --no-wait, ScenarioRun ID resolution (start result + run list fallback), per-poll status rendering via az chaos scenario run show, terminal-state detection, and the final summary.
The AI orchestrator's only job is:
- Set
$env:STARTCHAOS_STATE_PATH to ${SESSION_DIR}/startchaos-state.json.
- Run the script.
- Handle exit codes (see below).
The script takes no parameters: configuration name, scenario, and workspace are all read from state.