weekly-update

Context

• Today's date: $TODAY
• Voice guide: VOICE-GUIDE.md (if present)
• Stakeholder preferences: knowledge/people/
• Goals: GOALS.md
• Past updates: knowledge/references/stakeholder-updates/ (if present)

---

Step 1: Identify Audience

If the user specified a recipient (e.g. "for CEO", "for board"), note it. Otherwise ask: "Who is this update for?" — one person or a group (e.g. leadership team, board, cross-functional leads).

Read knowledge/people/ for any matching stakeholder preference files. Note what each person cares about and what to avoid.

---

Step 2: Gather Progress Data

Always read from all available sources and merge:

From Linear (if MCP is connected):

• Pull project status — name, status (on track / at risk / behind), % complete, owner
• Pull initiative status — name, health, which projects roll up under it
• Note any projects that slipped, were completed, or changed status this week

From this repo (always):

• Read tasks/TASKS.md — completed (- [x]), in progress (- [ ]), and Waiting On items
• Read projects/ — scan active project briefs for context and current status
• Read GOALS.md — map all progress to quarterly goals
• Read meetings/ — scan recent notes for decisions or outcomes worth surfacing

Merge both sources — Linear gives project/initiative health, repo gives task-level detail and goal alignment. Note if Linear is unavailable.

---

Step 3: Assess Status

For each active project or initiative:

• On Track — progressing as expected
• At Risk — may slip without action
• Blocked — waiting on something external

Flag anything that needs stakeholder awareness or a specific ask.

---

Step 4: Draft the Update

Keep it under 500 words. Lead with what matters most to the audience.

Use this structure:

Subject: Product Update — Week of [Date]

**TL;DR**
- [Most important outcome or milestone this week]
- [Key blocker or risk, if any]
- [Top focus next week]

**Progress**
[Initiative or project]: [Status] — [1-line summary of movement]
[Initiative or project]: [Status] — [1-line summary of movement]

**Metrics** *(if available)*
[Metric]: [Current] ([change vs last week], target: [X])

**Blockers & Risks**
[Blocker] — [Proposed next step or ask]

**Next Week**
- [Priority 1, tied to goal]
- [Priority 2, tied to goal]
- [Priority 3]