Files
mohitagw15856 036511ab3e Windsurf + Aider targets, MCP server, and demo placement (#33)
Broadens both reach (more tools) and content types (an MCP server), continuing
the multi-platform story.

Windsurf + Aider:
- build-exports.mjs gains two platforms: exports/windsurf/*.md (workspace rules,
  trigger: model_decision) and exports/aider/*.md (conventions for `aider --read`).
  Now 5 platforms (ChatGPT, Gemini, Cursor, Windsurf, Aider).
- install.sh + bin/cli.mjs install both (windsurf -> .windsurf/rules, aider ->
  .aider/skills with a --read hint); generated README index is excluded from copies.
- One-line windsurf-install.sh / aider-install.sh wrappers for parity.

MCP server (new content type):
- mcp/server.mjs — zero-dependency stdio MCP server exposing list_skills,
  search_skills, get_skill. Published as a second bin (pm-claude-skills-mcp).
  Logs to stderr; reads bundled skills/ at startup. mcp/README.md documents
  client config.

Also: README hero "See it in action" demo placement (ready to swap in a GIF;
recording guide in web/docs-assets/README.md), Works-With table + exports +
install docs updated, CHANGELOG Unreleased. package.json files/bin updated.


Claude-Session: https://claude.ai/code/session_016JWn5jRD5tcEFKrubjQ6Px

Co-authored-by: Claude <noreply@anthropic.com>
2026-06-17 23:15:38 +01:00

4.2 KiB
Raw Permalink Blame History

PM Weekly Review Skill

Turn the chaotic end-of-week brain dump into a structured 20-minute ritual that keeps you, your team, and your stakeholders aligned — without a meeting.

The Weekly Review Structure (20 minutes)

5 min — Metrics check: What moved? What didn't? What's surprising? 5 min — Ship progress: What shipped? What slipped? What's blocked? 5 min — Insights: Any customer feedback, support tickets, or research findings? 5 min — Next week priorities: What are the 3 things that matter most?


Output Format

PM Weekly Review — Week of [Date]

Product Area: [What you own] Written by: [PM Name] Time to read: ~3 minutes


📊 Metrics This Week

Metric This Week Last Week Target Trend
[Primary metric] [Value] [Value] [Target] ↑ / ↓ / →
[Secondary metric] [Value] [Value] [Target] ↑ / ↓ / →
[Health metric] [Value] [Value] [Target] ↑ / ↓ / →

Notable movement:

  • [What changed and why — 1 sentence each]

Concern to watch:

  • [Anything trending in the wrong direction]

🚢 This Week's Progress

Shipped:

  • [What went live] — [1-line impact or observation]

In Progress:

  • 🔄 [Feature/initiative] — [% complete or current status]

Slipped / Blocked:

  • ⚠️ [What didn't happen] — Reason: [brief] — Action: [who's unblocking it]

Carry-forward to next week:

  • [Item + why it's carrying over]

💡 Insights & Signals

Customer feedback:

  • "[Quote or paraphrase]" — Source: [user/channel] — Theme: [tag]

Support signals:

  • [Top ticket category this week + volume]
  • [Anything that signals a product gap]

Research / data:

  • [Any discovery from user interviews, analytics, or experiments]

🎯 Next Week — Top 3 Priorities

# Priority Why This Week Owner Done =
1 [Most important thing] [Reason it can't wait] [Name] [Clear definition of done]
2 [Second priority] [Why] [Name] [Done criteria]
3 [Third priority] [Why] [Name] [Done criteria]

Decisions needed:

  • [Any decision that's blocking progress — who needs to make it]

Asks / dependencies:

  • [What you need from engineering / design / data / leadership]

🧠 Reflection (Optional but powerful)

What's one thing from this week I'd do differently? [Your honest answer — 12 sentences]

What's the biggest unknown I'm carrying into next week? [Name the uncertainty explicitly]


Required Inputs

Ask the user for these if not provided:

  • Product area or team you own
  • Key metrics this week (with values and prior week comparison)
  • What shipped, slipped, or is blocked
  • Top 3 priorities for next week
  • Any customer insights or signals (optional)

Quality Checks

  • Metrics include period-over-period comparison (not just raw numbers)
  • Every blocked item has an owner and a specific unblocking action
  • Next week's priorities have a "why this week" rationale
  • Total length is under 400 words (skimmable in 3 minutes)
  • Reflection section is honest, not aspirational

Anti-Patterns

  • Do not report metrics without comparing to target or the prior week — absolute numbers without context are not useful
  • Do not list blockers without a named owner and proposed resolution — unowned blockers stay blocked
  • Do not write a weekly review that is longer than one page — it must be scannable in under 2 minutes
  • Do not include more than 3 priorities for next week — a list of 8 "top priorities" means nothing is prioritised
  • Do not skip the insights section — observations that inform future decisions are a PM's key value add

Guidelines

  • Keep the whole document under 400 words — if stakeholders won't read it, it doesn't exist
  • The reflection section is for you, not your stakeholders — keep it honest
  • Always name a clear owner for every blocked item — "the team will figure it out" is a blocker in disguise
  • Recommend sending this by end of Friday — Monday morning is too late to course-correct
  • If three weeks of weekly reviews show the same blocked item, escalate immediately