---
name: preparing-the-race
description: >
  Use when the simulator receives a validated plan from the planner and
  must initialize the race: parsing the plan, spawning runner agents,
  starting the telemetry collector, and firing the start gun. Triggered
  once per simulation, before the first tick.
license: Apache-2.0
---

# Preparing the Race

This skill initializes the simulation after a validated plan arrives
from the planner.

## Workflow

Each numbered step is a **separate model response**. The skill toolset
guards against multi-step responses with an error.

```
Pre-Race Progress:
- [ ] Response 1: prepare_simulation (alone)
- [ ] Response 2: spawn_runners + start_race_collector (parallel)
- [ ] Response 3: fire_start_gun
```

**Why separate responses:** `prepare_simulation` sets state
(`simulation_ready`, `runner_count`, `simulation_id`) that the other
tools read. The skill guard rejects parallel calls that would race
with that state write.

### Response 1: Parse the plan

Call only `prepare_simulation` with the JSON plan from the planner.
The tool extracts the route, computes tick parameters, and stores
configuration in session state.

### Response 2: Spawn runners + start collector (parallel)

Call `spawn_runners` and `start_race_collector` together in the same
response. The two tools are independent: spawning runners and
subscribing to broadcasts have no data dependency, so they execute
simultaneously for faster startup.

### Response 3: Fire the start gun

Call `fire_start_gun` to broadcast the START_GUN event to all spawned
runner agents.

## Tools

- `prepare_simulation(plan_json, tool_context, duration_seconds=120, tick_interval_seconds=10, total_race_hours=6.0)`:
  Parse the plan JSON, compute max_ticks, and store simulation config
  in state.
- `spawn_runners(count, tool_context)`:
  HTTP POST to the gateway spawn API to create runner agent sessions.
- `start_race_collector(tool_context)`:
  Start a RaceCollector subscribed to gateway:broadcast for runner
  telemetry.
- `fire_start_gun(tool_context)`:
  Broadcast a START_GUN RunnerEvent to all spawned runner agents via
  Redis.
- `call_agent(agent_name, message, tool_context)`:
  Delegate inter-agent communication via the shared A2A utility.