# runbook-writing-wasp-drone

The runbook-writing-wasp-drone subagent writes and audits operational runbooks with exact commands, decision branches, rollback steps, escalation paths, and test status.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 96 repo stars
- Author: Legion Code Inc.
- License: AGPL-3.0-or-later · policy=link-only · description only; the file stays with the author
- Source: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/platform-and-release-tools/agents/runbook-writing-wasp-drone.md
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/runbook-writing-wasp-drone

## What it does

runbook-writing-wasp-drone handles the authoring and upkeep of operational runbooks used when alerts fire. It first sorts a request into break-fix, scheduled operation, or diagnostic work, then builds a linear procedure with explicit IF/THEN branches. Commands, URLs, variables, and decision points are checked for hidden assumptions.

The subagent requires copy-ready commands with exact flags, namespaces, and service names. Each state-changing action gets an undo step or an explicit irreversible-action note, while every runbook includes a named escalation contact and response expectation. It records the latest exercise environment and outcome, links related postmortems, and applies a completion checklist. Untested documents receive a prominent TEST STATUS: UNTESTED marker.

Its scope is the document’s structure, content, testability, and freshness. It does not configure PagerDuty or OpsGenie and does not own infrastructure decisions. Codex uses `.codex/agents/runbook-writing-wasp-drone.toml`, so its setup differs from Claude Code.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add legioncodeinc/vibe-coding-tools
```
In the agent chat (not a shell):
```text
/plugin install platform-and-release-tools@wasp-nest
```

2. **Manually: put the files in place**
- File: `.claude/agents/runbook-writing-wasp-drone.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/runbook-writing-wasp-drone.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/runbook-writing-wasp-drone.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/platform-and-release-tools/agents/runbook-writing-wasp-drone.md

## When to use it
- write a runbook for an alert
- audit commands and decision branches
- document rollback for state-changing actions
- define an escalation contact and route
- turn a postmortem into a tested procedure

## Example prompts
- Write a runbook for this alert with exact commands, IF/THEN branches, and rollback steps.
- Audit this runbook for hidden context and add a concrete escalation path.
- Turn this postmortem into a runbook and define a game day test.

## Similar
- [incident-runbook-templates](https://affpapa.org/en/nevibecode/skills/incident-runbook-templates.md) — skill · 10900 installs
- [runbook](https://affpapa.org/en/nevibecode/skills/runbook.md) — skill · 3300 installs
- [runbook-generator](https://affpapa.org/en/nevibecode/skills/runbook-generator.md) — skill · 600 installs
- [writing-runbooks](https://affpapa.org/en/nevibecode/skills/writing-runbooks.md) — skill · 26700 installs
- [incident-management](https://affpapa.org/en/nevibecode/skills/incident-management.md) — skill · 375 installs
- [runbook-creation](https://affpapa.org/en/nevibecode/skills/runbook-creation.md) — skill · 388 installs

From the same set: [legioncodeinc/vibe-coding-tools](https://affpapa.org/en/nevibecode/by/legioncodeinc/vibe-coding-tools.md) — 172 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
