Written Communication
Scope
Covers
- Turning messy notes into a clear email, memo, doc, or async update
- Making the “how” explicit (what happens next, by whom, by when)
- Editing for clarity at scale (scanability, definitions, single source of truth)
- Creating/maintaining a canonical doc for an ongoing project
When to use
- “Draft an email to stakeholders explaining a change and what I need from them.”
- “Turn these bullets into a 1-page memo with a recommendation and next steps.”
- “Rewrite this doc to be clearer, shorter, and more actionable.”
- “Create a canonical doc as the source of truth for this project.”
When NOT to use
- You need marketing/brand copy (landing pages, ads) more than internal/executive clarity.
- You need a full product spec/PRD from scratch (use
writing-prds or writing-specs-designs).
- You’re writing legal/HR/regulated communications without expert review.
- The real issue is alignment via facilitation (you may need a meeting/offsite plan, not a rewrite).
Inputs
Minimum required
- Artifact type + channel (email / memo / doc / status update; where it will live)
- Audience (roles/seniority) + what they care about
- Goal + ask (inform/align/decide; what you want the reader to do, by when)
- Key context (facts, constraints, timeline, links) + what must be avoided (sensitivities)
- Source material (notes, existing draft, Slack threads, etc.)
Missing-info strategy
- Ask up to 5 questions from references/INTAKE.md (3–5 at a time), then proceed.
- If critical info remains missing, make explicit assumptions and offer 2–3 options (structure/tone/ask).
Outputs (deliverables)
Produce a Written Communication Pack in Markdown (in-chat; or as files if requested):
- Message brief (audience, goal, ask, constraints)
- Outline (TL;DR + key points + “how/next steps”)
- Draft artifact (email/memo/doc/status update) in final-ready format
- Canonical doc skeleton (optional; when the project needs a single source of truth)
- Risks / Open questions / Next steps (always)
Templates: references/TEMPLATES.md
Expanded guidance: references/WORKFLOW.md
Workflow (8 steps)
1) Intake + choose the lightest artifact
- Inputs: user request + references/INTAKE.md.
- Actions: Clarify the channel and pick the smallest artifact that works (email vs memo vs doc vs status update vs canonical doc).
- Outputs: Message brief (draft) + artifact selection.
- Checks: You can answer: “Who is this for, and what should they do after reading?”
2) Lock the reader outcome + ask (one sentence)
- Inputs: brief.
- Actions: Write one sentence: “After reading, the audience will ____.” Make the ask explicit (decision/options, approval, feedback, or FYI) and include a deadline if relevant.
- Outputs: Outcome/ask line + decision/feedback request.
- Checks: The ask is unambiguous and doesn’t require a meeting to interpret.
3) Convert “what/why” into “how” (actionable next steps)
- Inputs: source material + outcome/ask.
- Actions: Identify the 3–7 concrete steps, responsibilities, and dependencies. If proposing a change, include what changes, what stays the same, and what happens next.
- Outputs: “How / Next steps” bullets (owner + date where possible).
- Checks: A reader could execute without asking “so what do you want me to do?”
4) Structure for skim (clarity at scale)
- Inputs: brief + next steps.
- Actions: Create a TL;DR, then headings in the order readers scan: Ask → Context → Details → Next steps. Use bullets, short paragraphs, and explicit labels.
- Outputs: Outline with headings.
- Checks: A skim-reader can capture the point in < 60 seconds.
5) Draft the artifact (write to be forwarded)
- Inputs: outline + templates.
- Actions: Draft in plain language; avoid jargon; put key numbers and decisions in writing. If this is ongoing work, link to (or create) the canonical doc.
- Outputs: Draft email/memo/doc/status update.
- Checks: The draft is safe to forward; it stands alone without verbal context.
6) “Letter to yourself” clarity pass (then rewrite for the audience)
- Inputs: draft.
- Actions: If the content is fuzzy, write a quick internal version (“what am I actually saying?”), then rewrite in the audience’s language and incentives.
- Outputs: Clarified rewrite with cleaner logic.
- Checks: The message has a single through-line; no contradictions or buried ledes.
7) Canonical doc check (single source of truth)
- Inputs: draft + project context.
- Actions: If readers will keep asking “where is the latest?”, create/update a canonical doc (links, owners, last updated, decisions, next update cadence).
- Outputs: Canonical doc skeleton or link section.
- Checks: There is one obvious place to find the current state and decisions.
8) Quality gate + finalize
- Inputs: full pack.
- Actions: Run references/CHECKLISTS.md and score with references/RUBRIC.md. Add Risks/Open questions/Next steps.
- Outputs: Final Written Communication Pack.
- Checks: Clarity, actionability, and ownership meet the bar (≥ 3 on each rubric dimension).
Quality gate (required)
- Use references/CHECKLISTS.md and references/RUBRIC.md.
- Always include: Risks, Open questions, Next steps.
Examples
Example 1 (stakeholder email): “Draft an email to exec stakeholders: the launch is slipping 2 weeks; we need approval to cut scope and a decision by Friday.”
Expected: TL;DR + explicit ask/options + what changes + next steps with owners.
Example 2 (project memo + canonical doc): “Turn these notes into a 1-page memo that aligns the team on the new onboarding approach, and create a canonical doc outline for ongoing updates.”
Expected: memo with recommendation + tradeoffs + next steps, plus a source-of-truth doc skeleton.
Boundary example: “Write a legal/HR disciplinary notice.”
Response: decline to fabricate legal/HR guidance; request expert review; offer to help with neutral structure, tone, and clarity if the user provides approved language.
1---2name: written-communication3description: Draft and edit high-signal written artifacts and produce a Written Communication Pack (brief, outline, draft email/memo/doc, canonical doc option, quality gate). Use for writing, written communication, memo, email, doc, async update, rewrite for clarity. Category: Communication.4---5
6# Written Communication
7
8## Scope
9
10**Covers**
11- Turning messy notes into a clear **email, memo, doc, or async update**
12- Making the **“how”** explicit (what happens next, by whom, by when)
13- Editing for **clarity at scale** (scanability, definitions, single source of truth)
14- Creating/maintaining a **canonical doc** for an ongoing project
15
16**When to use**
17- “Draft an email to stakeholders explaining a change and what I need from them.”
18- “Turn these bullets into a 1-page memo with a recommendation and next steps.”
19- “Rewrite this doc to be clearer, shorter, and more actionable.”
20- “Create a canonical doc as the source of truth for this project.”
21
22**When NOT to use**
23- You need **marketing/brand copy** (landing pages, ads) more than internal/executive clarity.
24- You need a full product spec/PRD from scratch (use `writing-prds` or `writing-specs-designs`).
25- You’re writing **legal/HR/regulated** communications without expert review.
26- The real issue is alignment via facilitation (you may need a meeting/offsite plan, not a rewrite).
27
28## Inputs
29
30**Minimum required**
31- Artifact type + channel (email / memo / doc / status update; where it will live)
32- Audience (roles/seniority) + what they care about
33- Goal + ask (inform/align/decide; what you want the reader to do, by when)
34- Key context (facts, constraints, timeline, links) + what must be avoided (sensitivities)
35- Source material (notes, existing draft, Slack threads, etc.)
36
37**Missing-info strategy**
38- Ask up to 5 questions from [references/INTAKE.md](references/INTAKE.md) (3–5 at a time), then proceed.
39- If critical info remains missing, make explicit assumptions and offer 2–3 options (structure/tone/ask).
40
41## Outputs (deliverables)
42
43Produce a **Written Communication Pack** in Markdown (in-chat; or as files if requested):
44
451) **Message brief** (audience, goal, ask, constraints)
462) **Outline** (TL;DR + key points + “how/next steps”)
473) **Draft artifact** (email/memo/doc/status update) in final-ready format
484) **Canonical doc skeleton** (optional; when the project needs a single source of truth)
495) **Risks / Open questions / Next steps** (always)
50
51Templates: [references/TEMPLATES.md](references/TEMPLATES.md)
52Expanded guidance: [references/WORKFLOW.md](references/WORKFLOW.md)
53
54## Workflow (8 steps)
55
56### 1) Intake + choose the lightest artifact
57- **Inputs:** user request + [references/INTAKE.md](references/INTAKE.md).
58- **Actions:** Clarify the channel and pick the smallest artifact that works (email vs memo vs doc vs status update vs canonical doc).
59- **Outputs:** Message brief (draft) + artifact selection.
60- **Checks:** You can answer: “Who is this for, and what should they do after reading?”
61
62### 2) Lock the reader outcome + ask (one sentence)
63- **Inputs:** brief.
64- **Actions:** Write one sentence: “After reading, the audience will ____.” Make the ask explicit (decision/options, approval, feedback, or FYI) and include a deadline if relevant.
65- **Outputs:** Outcome/ask line + decision/feedback request.
66- **Checks:** The ask is unambiguous and doesn’t require a meeting to interpret.
67
68### 3) Convert “what/why” into “how” (actionable next steps)
69- **Inputs:** source material + outcome/ask.
70- **Actions:** Identify the 3–7 concrete steps, responsibilities, and dependencies. If proposing a change, include what changes, what stays the same, and what happens next.
71- **Outputs:** “How / Next steps” bullets (owner + date where possible).
72- **Checks:** A reader could execute without asking “so what do you want me to do?”
73
74### 4) Structure for skim (clarity at scale)
75- **Inputs:** brief + next steps.
76- **Actions:** Create a TL;DR, then headings in the order readers scan: Ask → Context → Details → Next steps. Use bullets, short paragraphs, and explicit labels.
77- **Outputs:** Outline with headings.
78- **Checks:** A skim-reader can capture the point in < 60 seconds.
79
80### 5) Draft the artifact (write to be forwarded)
81- **Inputs:** outline + templates.
82- **Actions:** Draft in plain language; avoid jargon; put key numbers and decisions in writing. If this is ongoing work, link to (or create) the canonical doc.
83- **Outputs:** Draft email/memo/doc/status update.
84- **Checks:** The draft is safe to forward; it stands alone without verbal context.
85
86### 6) “Letter to yourself” clarity pass (then rewrite for the audience)
87- **Inputs:** draft.
88- **Actions:** If the content is fuzzy, write a quick internal version (“what am I actually saying?”), then rewrite in the audience’s language and incentives.
89- **Outputs:** Clarified rewrite with cleaner logic.
90- **Checks:** The message has a single through-line; no contradictions or buried ledes.
91
92### 7) Canonical doc check (single source of truth)
93- **Inputs:** draft + project context.
94- **Actions:** If readers will keep asking “where is the latest?”, create/update a canonical doc (links, owners, last updated, decisions, next update cadence).
95- **Outputs:** Canonical doc skeleton or link section.
96- **Checks:** There is one obvious place to find the current state and decisions.
97
98### 8) Quality gate + finalize
99- **Inputs:** full pack.
100- **Actions:** Run [references/CHECKLISTS.md](references/CHECKLISTS.md) and score with [references/RUBRIC.md](references/RUBRIC.md). Add Risks/Open questions/Next steps.
101- **Outputs:** Final Written Communication Pack.
102- **Checks:** Clarity, actionability, and ownership meet the bar (≥ 3 on each rubric dimension).
103
104## Quality gate (required)
105- Use [references/CHECKLISTS.md](references/CHECKLISTS.md) and [references/RUBRIC.md](references/RUBRIC.md).
106- Always include: **Risks**, **Open questions**, **Next steps**.
107
108## Examples
109
110**Example 1 (stakeholder email):** “Draft an email to exec stakeholders: the launch is slipping 2 weeks; we need approval to cut scope and a decision by Friday.”
111Expected: TL;DR + explicit ask/options + what changes + next steps with owners.
112
113**Example 2 (project memo + canonical doc):** “Turn these notes into a 1-page memo that aligns the team on the new onboarding approach, and create a canonical doc outline for ongoing updates.”
114Expected: memo with recommendation + tradeoffs + next steps, plus a source-of-truth doc skeleton.
115
116**Boundary example:** “Write a legal/HR disciplinary notice.”
117Response: decline to fabricate legal/HR guidance; request expert review; offer to help with neutral structure, tone, and clarity if the user provides approved language.