playbooks
Playbooks define trigger-action automation rules that enable assistants to automatically respond to incoming messages matching specified patterns. Use playbooks to establish consistent handling workflows across channels, configure when the assistant should act autonomously versus draft responses for review, and organize message-handling logic by category and priority for complex routing scenarios.
git clone --depth 1 https://github.com/vellum-ai/vellum-assistant /tmp/playbooks && cp -r /tmp/playbooks/assistant/src/config/bundled-skills/playbooks ~/.claude/skills/playbooksSKILL.md
Playbooks are trigger-action automation rules that tell the assistant how to handle incoming messages matching a pattern.
## Structure
Each playbook has:
- **Trigger**: Pattern or description that activates the rule (e.g. "meeting request", "from:ceo@*")
- **Action**: What to do when triggered (natural language description)
- **Channel**: Which channel the rule applies to ("*" = all channels, or specific like "email", "slack")
- **Category**: Free-form grouping label (e.g. "scheduling", "triage")
- **Autonomy level**: How much autonomy the assistant has
- `auto` -- execute immediately without asking
- `draft` -- prepare a response for user review (default)
- `notify` -- alert the user only
- **Priority**: Numeric priority for overlapping rules (higher = takes precedence)
## Lifecycle
1. Create a playbook with `playbook_create` specifying trigger and action.
2. List existing playbooks with `playbook_list`, optionally filtering by channel or category.
3. Update rules with `playbook_update` or remove them with `playbook_delete`.
## Storage
Playbooks are stored as memory items with semantic retrieval, enabling fuzzy matching of incoming messages against trigger patterns.>
>
>
>
Check Vellum Assistant architecture and package boundaries. Use when editing imports, moving code, adding endpoints, touching assistant/gateway/client/skill boundaries, or reviewing architecture-sensitive changes.
Review Vellum Assistant code changes for correctness, repo-specific quality rules, security risks, and missing validation. Use when reviewing diffs, preparing a PR, finishing implementation work, or when the user asks for a code review, quality pass, or pre-merge check in this repository.
Guide Vellum Assistant feature flag changes and rollout hygiene. Use when adding, editing, reviewing, or documenting assistant feature flags, rollout-gated behavior, or platform flag follow-up work.
Validate Vellum Assistant database and workspace migrations. Use when adding, editing, reviewing, or testing migrations, release-note migrations, persisted schemas, workspace file formats, or data backfills.