pmstudio-comms git:20260802.1479e32A

Immutable. This exact content is served forever at /api/v1/blob/3d523bcb3af40599.

---
name: pmstudio-comms
description: Generate templated stakeholder communications from project context. Use when someone asks to "write a go-live email", "create a status update", "onboard someone", "write an announcement", "steerco update", "incident summary", "change notification", or any stakeholder communication task. Reads project memory, stakeholder directory, PRD, and meeting notes to pre-fill real names, dates, and context. Produces ready-to-send Markdown.
domain: pm
---

# Stakeholder Comms — Templated Communications Generator

## Purpose

Generates stakeholder communications pre-filled with project context. Not generic templates — these pull real stakeholder names, real dates, real scope from project artifacts.

## Process

### Step 1: Identify Template

From user request or by asking:

| Command | Template | When to Use |
|---------|----------|-------------|
| `/stakeholder-comms go-live` | Go-Live Announcement | Product/feature launching |
| `/stakeholder-comms status` | Status Update | Periodic reporting (weekly/biweekly) |
| `/stakeholder-comms onboard {name}` | Onboarding Brief | New team member joining |
| `/stakeholder-comms change` | Change Notification | Planned change to live product |
| `/stakeholder-comms incident` | Incident Summary | Post-incident communication |
| `/stakeholder-comms steerco` | SteerCo Update | Leadership/governance meeting prep |

If no subcommand, ask: "What type of communication do you need?"

### Step 2: Read Context

**All templates read:**
- `CLAUDE.local.md` — project overview, key decisions, stakeholders, recent changes
- `.sync-watch.json` — project name

**Template-specific reads:**

| Template | Additional Sources |
|----------|-------------------|
| Go-Live | PRD (scope, success metrics), Meeting-Notes (launch decisions) |
| Status | PRD (milestones, timeline), Meeting-Notes (recent), Change-Log (recent entries) |
| Onboard | Stakeholder Directory, PRD (overview), Presentations (links to share) |
| Change | PRD (affected components), DR-Plan (rollback procedures if exists) |
| Incident | IRP (severity definitions if exists), Meeting-Notes (incident details) |
| SteerCo | PRD (timeline, risks), Change-Log (period changes), all recent Meeting-Notes |

### Step 3: Ask Clarifying Questions

Only ask what can't be inferred from context:

- **Audience:** Who receives this? (all stakeholders / specific group / leadership)
- **Tone:** Formal (board) / professional (cross-team) / casual (own team)
- **Period:** For status updates — what date range?
- **Specific content:** For incident — what happened? For change — what's changing?

### Step 4: Generate Communication

**Output location:** `Comms/{Type}-{Date}-{Audience}.md`

If `Comms/` directory doesn't exist, create it.

### Templates

See `references/templates.md` for the full template content for each type. Summary:

#### Go-Live Announcement
- Subject line, TL;DR (2 sentences), What's Live (scope), Who It Affects, What To Do (action items per audience group), Known Limitations, Support Contacts, Timeline (what's next)

#### Status Update
- Period, RAG Status (Red/Amber/Green with explanation), Key Accomplishments (bulleted), Decisions Made, Risks & Blockers (with owners), Upcoming Milestones (next 2 weeks), Action Items (table: item/owner/due), Help Needed

#### Onboarding Brief
- Welcome, Product Overview (2-paragraph summary), Your Role, Key Contacts (table: name/role/email/when-to-contact), Access Setup Checklist, Key Documents (links), First-Week Actions, Glossary (10 most-used terms)

#### Change Notification
- What's Changing, When, Why, Who's Affected, What You Need To Do, Rollback Plan, Support Contacts

#### Incident Summary
- Severity, Timeline (bullet list: detected/responded/resolved), Impact, Root Cause, Resolution, Prevention (what we're doing so this doesn't happen again), Action Items

#### SteerCo Update
- Executive Summary (3 bullets max), RAG Status with trend arrow, Decisions Needed (numbered, with context and recommendation), Budget & Timeline (table), Key Risks (top 3 with mitigation status), Accomplishments Since Last SteerCo, Next Period Focus

### Step 5: Present and Refine

Show the generated communication. Ask:
- "Ready to save, or would you like to adjust anything?"
- For emails: "Want me to include a subject line suggestion?"

## Critical Rules

1. **Use real data.** Pull actual names, dates, and scope from project files. Never use placeholders like "[Name]" if the information exists in context.
2. **Appropriate detail level.** SteerCo updates are concise (1 page). Onboarding briefs are comprehensive. Match the template.
3. **Action-oriented.** Every communication should make clear what the reader should DO. No information-only dumps.
4. **Tone matching.** Leadership comms use formal language. Team comms can be direct. Incident comms are factual and calm.
5. **Don't fabricate.** If you don't have incident details, ask. Don't guess root causes or timelines.