GoogleCloudPlatform/race-condition

The open source multi-agent simulation from the Developer Keynote at Google Cloud Next '26. A deployable reference architecture for autonomous AI agents using Gemini and ADK.

226Stars on the repository
21Mods indexed here, across every type
8d agoLast push, which is what freshness is scored on
noneNo LICENSE: all rights reserved, so bodies are not copied

contributing

01

GoogleCloudPlatform/race-condition

Skill Claude CodeCodex

Guides the developer workflow for contributing to Race Condition. Use when setting up pre-commit hooks, running tests before a PR, understanding code style requirements, or preparing a contribution.

226 8d ago A 39 tokens

deploying

02

GoogleCloudPlatform/race-condition

Skill Claude CodeCodex

Guides deployment of Race Condition to a GCP project. Use when deploying to the cloud, setting up infrastructure with Terraform, or troubleshooting a deployment. This is for cloud deployment -- for local development, use the getting-started skill instead.

226 8d ago A 51 tokens

GoogleCloudPlatform/race-condition

Skill Claude CodeCodex

Explains the Race Condition architecture, the design decisions behind it, and where to read code first. Use when the developer asks how something works, wants a tour, or wants to understand the system before changing it.

226 8d ago A 49 tokens

getting-started

04

GoogleCloudPlatform/race-condition

Skill Claude CodeCodex

Guides setup of the Race Condition project from clone to running simulation. Use when the developer wants to get the project running locally, install dependencies, configure GCP credentials, or troubleshoot startup issues.

226 8d ago A 43 tokens

directing-the-event

05

GoogleCloudPlatform/race-condition

Skill Claude CodeCodex

Use when the marathon plan needs non-spatial event parameters defined: theme, hydration-point logistics, crowd zones, start times, or expected participant counts. Triggered when the request describes the feel or operational logistics of the race rather than its physical route.

226 8d ago A 55 tokens

GoogleCloudPlatform/race-condition

Skill Claude CodeCodex

Use when the marathon plan needs a 26.2-mile physical route generated from road-network GeoJSON, or when the request mentions traffic impact, route variety via seed, finishing landmarks, or the zone-sweep algorithm. Triggered by route-planning or traffic-analysis language.

226 8d ago A 61 tokens

GoogleCloudPlatform/race-condition

Skill Claude CodeCodex

Use when the planning committee asks about marathon finances or requests a budget change. Triggered by mentions of budget, cost, spending, sponsorship, or any phrasing that implies modifying a financial allocation. Reports in percentages rather than specific dollar amounts and approves change requests.

226 8d ago A 59 tokens

mapping

08

GoogleCloudPlatform/race-condition

Skill Claude CodeCodex

Use when planning a marathon route that must reference real-world geography: looking up landmarks, businesses, or parks in a city, computing distances between points, or checking historical and forecasted weather for the race date and location. Triggered when the request mentions a real city, venue, or weather…

226 8d ago A 62 tokens

GoogleCloudPlatform/race-condition

Skill Claude CodeCodex

Use when the planning committee asks to change, increase, decrease, or modify a budget allocation in a security-restricted context. Triggered by any budget-modification phrasing. Refuses the change and directs the requester to an authorized administrator.

226 8d ago A 54 tokens

managing-hydration

10

GoogleCloudPlatform/race-condition

Skill Claude CodeCodex

Use when a runner agent receives a distance update and must deplete water proportionally, or when the runner enters a hydration station and must decide whether to stop and rehydrate. Triggered by distance events and station events.

226 8d ago A 50 tokens

running

11

GoogleCloudPlatform/race-condition

Skill Claude CodeCodex

Use when a runner agent needs to manage athletic performance during a race tick: accelerating, braking, or reading current vitals (speed, energy, hydration, exhaustion). Triggered every tick the runner is active.

226 8d ago A 44 tokens

GoogleCloudPlatform/race-condition

Skill Claude CodeCodex

Use when the simulator's loop agent advances the race by one tick: broadcasting state to runners, draining the telemetry buffer, computing traffic conditions, and checking for race completion. Triggered every iteration of the LoopAgent.

226 8d ago A 50 tokens

completing-the-race

13

GoogleCloudPlatform/race-condition

Skill Claude CodeCodex

Use when the simulator finishes its race-tick loop and must wrap up: compiling final results from tick snapshots, stopping the RaceCollector, and reporting outcomes to other agents. Triggered once per simulation, after the last tick.

226 8d ago A 52 tokens

preparing-the-race

14

GoogleCloudPlatform/race-condition

Skill Claude CodeCodex

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.

226 8d ago A 53 tokens

GoogleCloudPlatform/race-condition

Skill Claude CodeCodex

Use when running the simulator-with-failure test variant and the pre-race phase begins. The preparesimulation tool intentionally raises RuntimeError to exercise the ADK and SimulationCommunicationPlugin toolerror callback path. Not intended for production simulations.

226 8d ago A 55 tokens

a2ui-rendering

16

GoogleCloudPlatform/race-condition

Skill Claude CodeCodex

Use when an agent renders rich UI back to a client surface (cards, dashboards, forms, modals) using the A2UI v0.8.0 declarative protocol. Required whenever the response should display structured components rather than plain text, or whenever the validateandemita2ui tool is in scope.

226 8d ago A 70 tokens