Status Updates Playbook

Guidelines for writing team updates that are easy to scan, honest about challenges, and generous with recognition.

Philosophy

• Outcomes first - Lead with results and impact, not activity; tie to goals/OKRs

• Scannable - Emoji-anchored sections, bullet points, short paragraphs

• Quantify - Metrics, deltas, dates, owners—show progress with numbers

• Honest - Acknowledge challenges directly, then reframe with context

• Warm - Credit individuals by name, use inclusive language

• Evidence-backed - Link to production, docs, metrics to show not tell

• Close the loop - Note delta from last update and what's next

Quick Reference

Task Guide

Voice and tone patterns tone-profile.md

PR evidence gathering pr-evidence.md

When to Use

• Team or stakeholder progress updates

• Manager/exec communications

• Slack channel announcements

• Sprint summaries or retrospectives

• Launch communications

Intake Questions

Ask these before drafting to ensure the update hits the right notes:

Essential:

• Audience & channel (manager, exec, peers? email, Slack, doc?)

• Time window (which two weeks? tie to OKRs/roadmap item?)

• Desired outcome (inform, influence decision, unblock, build trust?)

Evidence gathering:

• GitHub username (to pull authored PRs from past 14 days)

• Impact evidence (metrics, user/business outcomes, shipped artifacts?)

Framing:

• Risks/blockers (what needs escalation, by when?)

• Length/tone preference (bullets vs paragraph, RAG color?)

Recognition:

• Glue work to highlight (reviews, incidents, mentoring, docs, coordination?)

• Who to thank or spotlight?

If details are missing, ask concise clarifying questions before drafting.

Core Patterns

Structure

• Friendly hook (optional): Seasonal reference or greeting

• Section headers: Emoji prefix + bold title

• Bullet points: Outcome-first, with inline evidence links

• Named recognition: Specific individuals at section end

• Forward momentum: End with what's next

Framing Challenges

Never bury bad news. Acknowledge it, then provide context:

"Great progress and some less-than-ideal timeline changes. We'll cover the good first, as it's very easy to lose sight of just how much work is being shipped every day"

Pattern: [Bad news] + [acknowledge feeling] + "There is [context] though:" + [reframing bullets]

Evidence and Links

Weave links naturally into claims:

"shipped to production, to the X page (our fastest growing page)"

Use footnotes for caveats that would clutter the main flow.

Do's and Don'ts

Do:

• Open with a hook before diving in

• Use emoji for visual hierarchy (one per section)

• Credit individuals by name

• Link to evidence

• Use backticks for technical terms

• End with momentum

Don't:

• Bury or avoid bad news

• Use emoji as decoration

• Give vague thanks ("thanks everyone")

• Write dense paragraphs

• Over-explain technical concepts

For detailed voice characteristics and replication techniques, see tone-profile.md.

Writing Guidance

Phrasing:

• Use verbs + outcomes: "Shipped X → improved Y by Z%" not "Worked on X"

• Keep bullets single-line; front-load result, back-load detail

• Include dates/owners for risks and asks

Progression:

• Note delta from last update ("Previously blocked, now shipped")

• Mention decisions made and decisions pending (with decision-maker)

Dependencies:

• Call out dependencies you're unblocking for others

• Call out dependencies you need unblocked