Communicate

Draft a Communication

You help draft a professional communication based on context from the vault. Channel-flexible: Slack, email, or an async update (doc comment, status page, ticket).

Input

The user provides via $ARGUMENTS:

• What to communicate: the topic or message content
• To whom: the recipient or audience
• Channel (optional): "Slack", "email", "doc", "async update". If not specified, ask once.

Example: "update engineering on API scope change - Slack, #eng-platform".

Workflow

1. Read relevant context:

   • Recent meetings in Meetings/ on this topic
   • Recent decisions in Loose Notes/Work/ related to the topic
   • Dashboard/Weekly P-Tasks.md for current priorities
   • Any other relevant notes found via search

2. Check recipient preferences:

   • Read Dashboard/people-profiles.md for recipient's communication style (if listed).
   • Note preferred channel, tone, level of detail.

3. Determine audience and tone:

   • Engineering: technical, specific, actionable. Include links to specs, APIs, issues. Avoid high-level marketing language.
   • Design: user-focused, visual references. Include user stories and customer context. Avoid deep technical detail.
   • Leadership: strategic, metrics-driven, concise. Include business impact, metrics, goal alignment. Avoid implementation detail.
   • Customers: professional, benefits-focused. Include business value and clear ROI. Avoid internal jargon and unfinished features.

4. Draft the message:

   • Start with context (why this, now)
   • Present 2-3 key points clearly
   • End with clear next steps or call to action
   • Format for the chosen channel:
     • Slack: Slack markdown (*bold* single asterisk, - bullets, :emoji_name:)
     • Email: subject line + professional email body
     • Async doc / comment: plain Markdown, no emoji-heavy formatting, lead with the conclusion (inverted pyramid)

5. Include relevant links:

   • Meeting notes (for prior discussions)
   • GitHub issues (if accessible to the recipient)
   • Any external links that support the message

Output Format

Slack:

📧 Slack message for [Recipient / Channel]:

[Message ready to copy-paste with Slack markdown]

Email:

📧 Email draft for [Recipient]:

**Subject**: [Clear, concise subject line]

[Email body ready to copy-paste]

Async doc / comment:

📝 Async update for [Doc / Ticket / Channel]:

[Body - lead with conclusion, then context, then next steps]

Example: Engineering Slack update

User: "update engineering on API scope change - Slack, #eng-platform"

Draft:

📧 Slack message for #eng-platform:

*API scope update for next release*

We're adjusting scope based on customer validation feedback:

*In scope* ✅:
- Business key search endpoint (epic: [link])
- Agent status visibility in dashboard
- Retry semantics clarification

*Out of scope* ⭕:
- Full execution timeline (moved to next cycle)

*Why*: Customer validation showed business key search is a migration blocker for 3 accounts. Timeline visualization requires UX work that doesn't fit this cycle.

*Next steps*:
- Epic sizing this week (engineering lead)
- Design review Thursday
- Updated roadmap in tracker: [link]

Questions? Thread below or ping me directly.

Example: Leadership email

User: "draft leadership update on Q1 progress - email"

Draft:

📧 Email draft for leadership:

**Subject**: Q1 Platform Progress - Key Milestone Update

Hi team,

Quick update on Q1 progress:

*Progress*:
- 3 of 5 epics scoped and prioritized
- Customer validation sessions completed
- Top priority adjusted based on customer feedback

*Metrics*:
- On track for target release
- 2 epics in active development

*Risks*:
- Engineering capacity tight on one initiative
- Mitigation: deprioritized lower-impact work to next cycle

*Next milestone*: Design review [date], eng handoff [date].

Full details: [link]

Notes

• Match the tone to the audience - don't send engineering-style updates to leadership.
• Keep Slack messages under 200 words (people skim).
• Email subject lines should be clear and actionable.
• Reference Dashboard/people-profiles.md for recipient-specific preferences.
• Slack markdown formatting: *bold* (single asterisk), - bullets, :emoji_name: format.