Runs a coordinated review across all slides, checking that terminology stays consistent, the narrative arc holds, and the voice doesn't shift between sections.
Best for: Catching "we said it differently on slide 8" before the deck ships.
Creator's repository · vercel-labs/workflow-workshop
---
name: narrative-council
description: Convene the seven act-steward agents (act-1-setup through act-7-close) into a read-only team and run a coordinated narrative, language, and consistency review across the Workflow SDK GA deck. Use when the user asks for a "narrative review", "council", "consistency pass", "deck review", or questions that span multiple acts (e.g., "does retry vocabulary carry from Act II to Act V?"). Skip for single-slide edits — read the relevant slide directly.
---
## When to invoke
Use this skill when the user asks for:
- a cross-deck narrative review
- a language/vocabulary consistency pass
- a "council" or "team" review
- a question that spans ≥2 acts and benefits from independent per-act perspectives
Do **not** invoke for single-slide edits or questions answerable by reading one file.
## How it works
1. **Create a team** named `narrative-council-<date>` via `TeamCreate`. The team is transient — deleted after the review.
2. **Seed the task list.** For each review topic the user named (or, if unspecified, for the default checklist in the next section), create one task per act that needs to weigh in. Use `TaskCreate` with `owner` set to the act agent's name (e.g., `act-2-verbs`).
3. **Spawn the seven act agents as teammates** via `Agent` with:
- `subagent_type` matching the act agent name (`act-1-setup`, `act-2-verbs`, `act-3-pivot`, `act-4-first-agent`, `act-5-observer`, `act-6-analyst`, `act-7-close`)
- `team_name` set to the council team
- `name` matching the agent (so they're addressable in TaskUpdate and SendMessage)
- A prompt that includes (a) the user's question, (b) their assigned task ID, (c) the instruction to produce their Review Output (per their agent brief) and mark the task complete
- Launch all seven in **parallel** (single message, multiple `Agent` tool calls) unless the review only touches a subset of acts
4. **Consolidate.** Once all teammates have reported, synthesize their findings into a single report for the user:
- **Cross-act conflicts** (where agents disagree or one flags another's slide)
- **Consistent findings** (terminology drift, color mismatches, voice inconsistencies)
- **Recommended edit list** ordered by act, marked with severity
5. **Shut down.** Send each teammate a `shutdown_request`. Once all have shut down, call `TeamDelete`.
## Default checklist (when the user asks for a general review)
If the user just says "run the council" without a specific question, have each agent check their act against this list:
1. **Vocabulary drift** — do the three verbs (retry, suspend, rollback) appear in the canonical order with canonical spelling?
2. **Headline rhythm** — workflow demos use "What happens when…?" in full; agent demos elide to "…an Agent X?"
3. **Color-verb mapping** — sky/amber/fuchsia match the semantic meanings from `.impeccable.md`
4. **Voice** — casual / stage-comic, contractions, short sentences, first person
5. **No developer consoles** — no scrolling logs, no dense config chips on-stage
6. **CLS stability** — `.impeccable.md` principle #7 rules honored
7. **Cross-act promises** — does each act actually deliver on what the prior act set up?
## Important constraints
- **Read-only.** Every act agent is configured with `Read`/`Grep`/`Glob` only — they cannot edit slides. The user reviews the consolidated report and approves edits.
- **Parallel spawn.** Launching all seven in one message is critical for latency. Don't serialize.
- **Don't quote teammate messages back to the user** — they're already in the transcript. Synthesize.
- **Teardown always.** If the review errors mid-flight, still issue `shutdown_request` to live teammates and call `TeamDelete`.
- **One council at a time.** If a `narrative-council-*` team already exists, reuse it or delete it before creating a new one.
## Prompt template for each spawned agent
```
You are reviewing the Workflow SDK GA deck for this question:
> {{user question}}
Your assigned task ID: {{task_id}}
Read your act's slides and related source (per your agent brief), then report back using the Review Output Format defined in your brief. Mark your task complete via TaskUpdate when done, then go idle.
Be concise. Flag cross-act implications but don't touch other acts' slides.
```
## Expected output to the user
A single consolidated report, not seven separate reports. Structure:
```
# Narrative council review — {{topic}}
## Consensus findings
- ...
## Disagreements / conflicts
- ...
## Recommended edits (by act)
### Act I
- ...
### Act II
- ...
...
## Questions back to you
- ...
```