---
name: ironbee-search-scenario
description: >
  Find reusable IronBee verification scenarios by name, description, or metadata by delegating to
  the ironbee-scenario custom agent. Use when the user types `$ironbee-search-scenario`. The
  sub-agent searches every enabled platform's store and returns the matches.
---

# IronBee — Search scenarios

> **Delegate** — spawn the **`ironbee-scenario` custom agent** via `spawn_agent` with
> `agent_type="ironbee-scenario"` **and `fork_turns="none"`**. The sub-agent owns the scenario tools.

Find saved verification **scenarios**. Read-only.

## Steps
1. **Spawn** `spawn_agent` with `agent_type="ironbee-scenario"` and `fork_turns="none"`, passing in
   `message`:
   > Operation: search
   > Query: \<the user's description — a name/topic for fuzzy search, or a path/tag for metadata match>
   The sub-agent picks the right surface (fuzzy name+description vs precise `metadataMatch`), searches
   **every enabled platform's store**, and unions the results. **Wait for the sub-agent in the same turn.**
2. **Relay** the matches — name, description, platform, and (for fuzzy search) relevance score.
