mirrord-prev-env

1# Mirrord Preview Environment Skill
2 
3## Purpose
4 
5Help users create and manage **mirrord preview environments**. A preview environment runs only the *modified* service(s) as isolated pods in a shared cluster, while their dependencies reach the rest of the main cluster through mirrord. Traffic is scoped by an **environment key** and a filter, so a change can be collaborated on, validated, and reviewed against **real traffic without affecting live services**.
6 
7This skill covers two modes:
8 
91. **Ad-hoc (developer) mode** — a developer runs the `mirrord preview` CLI (`start` / `status` / `stop`) directly.
102. **CI mode** — the `metalbear-co/mirrord-preview` GitHub Action wires previews into a PR lifecycle (start on open/push, stop on close).
11 
12## When to Use This Skill
13 
14Trigger on questions like:
15- "How do I run a mirrord preview environment?"
16- "Set up per-PR preview environments with mirrord"
17- "How do I use the mirrord-preview GitHub Action?"
18- "`mirrord preview start` — what config and flags do I need?"
19- "How do I route only my traffic to the preview pod?"
20- "How do I check / stop a preview session?"
21 
22## Security (must follow)
23 
24Preview environments **deploy an image into a shared cluster and route live traffic to it**, so the security bar is higher than for config generation. Always:
25…