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
parent 123aabe5e3
commit 036511ab3e
358 changed files with 60408 additions and 38 deletions
@@ -0,0 +1,132 @@
+---
+trigger: model_decision
+description: "Structure a PM's weekly review and planning session. Use when doing a weekly PM review, writing a weekly update, preparing for Monday planning, or reviewing sprint health. Produces a shareable weekly update covering metrics movement, shipping progress, blockers, insights, and next week's top 3 priorities."
+---
+
+# 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 — 1–2 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