From b744c1e5b158b2e02c3b544376b4452983513d67 Mon Sep 17 00:00:00 2001 From: Graeme Rycyk Date: Fri, 13 Feb 2026 23:19:43 +0100 Subject: [PATCH] updated the product-management skills --- product-management/README.md | 56 +++- product-management/commands/daily-brief.md | 79 +++++ .../commands/feature-ideation.md | 86 ++++++ product-management/commands/meeting-prep.md | 85 ++++++ product-management/commands/one-pager.md | 82 ++++++ product-management/commands/prototype.md | 84 ++++++ product-management/commands/release-notes.md | 75 +++++ product-management/commands/sprint-review.md | 78 +++++ product-management/commands/tldr.md | 64 ++++ .../skills/executive-synthesis/SKILL.md | 159 ++++++++++ .../skills/feature-spec/SKILL.md | 30 ++ .../skills/html-prototyping/SKILL.md | 273 ++++++++++++++++++ .../skills/meeting-preparation/SKILL.md | 197 +++++++++++++ .../skills/release-communication/SKILL.md | 225 +++++++++++++++ .../skills/roadmap-management/SKILL.md | 30 ++ .../skills/sprint-execution/SKILL.md | 189 ++++++++++++ 16 files changed, 1789 insertions(+), 3 deletions(-) create mode 100644 product-management/commands/daily-brief.md create mode 100644 product-management/commands/feature-ideation.md create mode 100644 product-management/commands/meeting-prep.md create mode 100644 product-management/commands/one-pager.md create mode 100644 product-management/commands/prototype.md create mode 100644 product-management/commands/release-notes.md create mode 100644 product-management/commands/sprint-review.md create mode 100644 product-management/commands/tldr.md create mode 100644 product-management/skills/executive-synthesis/SKILL.md create mode 100644 product-management/skills/html-prototyping/SKILL.md create mode 100644 product-management/skills/meeting-preparation/SKILL.md create mode 100644 product-management/skills/release-communication/SKILL.md create mode 100644 product-management/skills/sprint-execution/SKILL.md diff --git a/product-management/README.md b/product-management/README.md index cbd25c8..e8f5d4e 100644 --- a/product-management/README.md +++ b/product-management/README.md @@ -13,11 +13,18 @@ claude plugins add knowledge-work-plugins/product-management This plugin gives you an AI-powered product management partner that can help with: - **Feature Specs & PRDs** — Generate structured product requirements documents from a problem statement or feature idea. Includes user stories, requirements prioritization, success metrics, and scope management. -- **Roadmap Planning** — Create, update, and reprioritize your product roadmap. Supports Now/Next/Later, quarterly themes, and OKR-aligned formats with dependency mapping. +- **Roadmap Planning** — Create, update, and reprioritize your product roadmap. Supports Now/Next/Later, quarterly themes, and OKR-aligned formats with dependency mapping and decision memos. - **Stakeholder Updates** — Generate status updates tailored to your audience (executives, engineering, customers). Pulls context from connected tools to save you the weekly update grind. - **User Research Synthesis** — Turn interview notes, survey data, and support tickets into structured insights. Identifies themes, builds personas, and surfaces opportunity areas with supporting evidence. - **Competitive Analysis** — Research competitors and generate briefs with feature comparisons, positioning analysis, and strategic implications. - **Metrics Review** — Analyze product metrics, identify trends, compare against targets, and surface actionable insights. +- **Sprint Reviews** — Summarize sprint accomplishments with velocity metrics, demo highlights, and retrospective themes. Connects the dots between delivered work and product goals. +- **Meeting Preparation** — Prepare for customer meetings, QBRs, and stakeholder calls with account context, talking points, risk assessment, and follow-up actions. +- **Daily Briefs** — Start each day with a synthesis of overnight activity across Slack, project trackers, support tickets, and community channels. +- **Prototyping** — Generate standalone interactive HTML prototypes from PRDs or feature descriptions. No dependencies, no build tools — just open in a browser. +- **Release Notes** — Turn completed Jira tickets and PRD excerpts into polished, customer-facing release notes with proper categorization and tone. +- **Feature Ideation** — Structure raw ideas from Slack threads, customer feedback, and brainstorms into validated feature concepts ready for a PRD. +- **Executive Summaries** — Distill complex information into one-pagers (under 500 words) and TL;DRs (3-5 bullets) optimized for busy stakeholders. ## Commands @@ -29,17 +36,30 @@ This plugin gives you an AI-powered product management partner that can help wit | `/synthesize-research` | Synthesize user research from interviews, surveys, and tickets | | `/competitive-brief` | Create a competitive analysis brief | | `/metrics-review` | Review and analyze product metrics | +| `/daily-brief` | Synthesize overnight activity into a morning brief | +| `/meeting-prep` | Prepare for customer meetings with context and talking points | +| `/sprint-review` | Generate a sprint review summary with metrics and demos | +| `/prototype` | Generate an interactive HTML prototype from a PRD or feature description | +| `/release-notes` | Create customer-facing release notes from completed work | +| `/feature-ideation` | Structure raw ideas into validated feature concepts | +| `/one-pager` | Synthesize complex information into a one-page executive summary | +| `/tldr` | Create a quick 3-5 bullet summary for Slack or email | ## Skills | Skill | What It Covers | |---|---| -| `feature-spec` | PRD structure, user stories, requirements categorization, acceptance criteria | -| `roadmap-management` | Prioritization frameworks (RICE, MoSCoW), roadmap formats, dependency mapping | +| `feature-spec` | PRD structure, user stories, requirements categorization, acceptance criteria, idea structuring | +| `roadmap-management` | Prioritization frameworks (RICE, MoSCoW), roadmap formats, dependency mapping, decision memos | | `stakeholder-comms` | Update templates by audience, risk communication, decision documentation | | `user-research-synthesis` | Thematic analysis, affinity mapping, persona development, opportunity sizing | | `competitive-analysis` | Feature comparison matrices, positioning analysis, win/loss analysis | | `metrics-tracking` | Product metrics hierarchy, goal setting (OKRs), dashboard design, review cadences | +| `sprint-execution` | Sprint metrics, velocity analysis, demo preparation, burndown interpretation, retrospectives | +| `meeting-preparation` | Account review methodology, talking point frameworks, risk identification, QBR planning | +| `release-communication` | Customer-facing writing, changelog categorization, version conventions, deprecation lifecycle | +| `executive-synthesis` | Pyramid principle, one-pager framework, TL;DR writing, audience adaptation | +| `html-prototyping` | Design defaults, responsive layout patterns, interactive components, accessibility basics | ## Example Workflows @@ -83,6 +103,36 @@ Claude: [Researches competitor onboarding approaches] Claude: [Generates brief with feature comparison, strengths/weaknesses, and strategic implications] ``` +### Sprint Review + +``` +You: /sprint-review +Claude: What sprint are we reviewing? I'll also need the dates and team name. +You: Sprint 42, Jan 6-17, Search Pod +Claude: [Pulls completed tickets from project tracker, team discussion from Slack] +Claude: [Generates sprint summary with velocity metrics, demo highlights, blockers, and customer feedback] +``` + +### Morning Brief + +``` +You: /daily-brief +Claude: Good morning! What's your name and company? I'll synthesize what happened overnight. +You: Jane, Acme Corp +Claude: [Scans Slack channels, project tracker updates, support tickets] +Claude: [Generates prioritized brief: what needs attention today, what's blocked, what shipped overnight] +``` + +### Interactive Prototype + +``` +You: /prototype +Claude: What feature or flow should I prototype? +You: A search results page with filters for content type, date range, and author +Claude: [Generates a complete standalone HTML file with interactive filters, realistic data, and responsive layout] +Claude: [Save as .html and open in your browser — no build tools needed] +``` + ## Data Sources > If you see unfamiliar placeholders or need to check which tools are connected, see [CONNECTORS.md](CONNECTORS.md). diff --git a/product-management/commands/daily-brief.md b/product-management/commands/daily-brief.md new file mode 100644 index 0000000..d49f940 --- /dev/null +++ b/product-management/commands/daily-brief.md @@ -0,0 +1,79 @@ +--- +description: Synthesize overnight activity into a morning brief with urgent items, progress, and recommended actions +argument-hint: "" +--- + +# Daily Brief + +> If you see unfamiliar placeholders or need to check which tools are connected, see [CONNECTORS.md](../CONNECTORS.md). + +Synthesize overnight activity into a prioritized morning brief. + +## Workflow + +### 1. Understand the Context + +Ask the user: +- What date is this brief for? (Default to today) +- What team or product area to focus on? +- Any specific concerns or priorities to watch for? + +### 2. Pull Context from Connected Tools + +If **~~chat** is connected: +- Pull overnight messages from key product and engineering channels +- Identify threads with unresolved questions or escalations +- Surface decisions made asynchronously +- Note any direct messages or mentions requiring the user's attention + +If **~~project tracker** is connected: +- Pull sprint status and recent ticket updates +- Identify items that changed status overnight (moved to blocked, completed, or at risk) +- Surface blockers or items flagged as urgent +- Check sprint burndown progress + +If **~~user feedback** is connected: +- Pull recent support tickets and their severity +- Identify trending issues or spikes in ticket volume +- Surface any critical or P0 tickets opened overnight + +If **~~meeting transcription** is connected: +- Pull notes from recent meetings +- Identify action items assigned to the user +- Surface any decisions that affect the user's priorities + +If no tools are connected, ask the user to paste: +- Recent Slack messages or team chat activity +- Sprint or project updates from Jira, Linear, or similar +- Support tickets or customer feedback +- Community posts or feature requests + +### 3. Generate the Brief + +Produce a structured morning brief. See the **sprint-execution** skill for sprint health indicators and the **meeting-preparation** skill for upcoming meeting context. + +- **TL;DR**: 2-3 sentence summary of the most important things from overnight +- **Urgent Items**: Blockers, escalations, critical bugs — anything requiring action today +- **Sprint Progress**: Current sprint status, notable completions, items at risk +- **Customer Signals**: Key feedback from support and community channels +- **Recommended Actions**: Top 3 things to focus on today, ordered by priority + +### 4. Follow Up + +After generating the brief: +- Offer to draft responses to urgent items +- Offer to create a standup update from the brief +- Offer to investigate any concerning signals in more depth +- Offer to prep for any meetings happening today + +## Output Format + +Use markdown with clear headers. Keep the brief scannable — the reader should get the essential picture in 60 seconds. + +## Tips + +- Prioritize ruthlessly. A brief that highlights everything highlights nothing. +- Blockers and escalations always come first, before progress updates. +- Customer signals are often the most strategically important part — do not bury them. +- Recommended actions should be specific and time-bound, not vague suggestions. +- If there is nothing urgent, say so. "No fires" is valuable information. diff --git a/product-management/commands/feature-ideation.md b/product-management/commands/feature-ideation.md new file mode 100644 index 0000000..be73e8b --- /dev/null +++ b/product-management/commands/feature-ideation.md @@ -0,0 +1,86 @@ +--- +description: Structure raw ideas, feedback, and problems into concrete feature concepts with action plans +argument-hint: "" +--- + +# Feature Ideation + +> If you see unfamiliar placeholders or need to check which tools are connected, see [CONNECTORS.md](../CONNECTORS.md). + +Transform raw ideas into structured feature concepts. This is the upstream step before `/write-spec` — use it when an idea needs shaping before it is ready for a full PRD. + +## Workflow + +### 1. Understand the Raw Idea + +Ask the user what they are working with. Accept any of: +- A raw idea ("We should add AI search") +- A customer problem ("Users cannot find content quickly") +- A feature request ("Customer X wants bulk export") +- A Slack thread or brainstorm output ("Here is what the team discussed...") +- A competitive observation ("Competitor Y just launched Z") + +### 2. Gather Signal + +Ask the user about the evidence behind this idea. Be conversational — do not dump all questions at once: + +- **Customer signal**: Who is asking for this? How many customers or users? How often does it come up? +- **Problem severity**: How painful is the current state? What workaround do people use today? +- **Strategic alignment**: Does this connect to a company or team goal? +- **Competitive context**: Are competitors doing this? Is it table stakes or a differentiator? +- **Constraints**: Any known technical, timeline, or resource constraints? + +### 3. Pull Context from Connected Tools + +If **~~chat** is connected: +- Search for related Slack discussions about this idea +- Pull threads where customers or teammates have mentioned the problem +- Identify any prior decisions or discussions about this area + +If **~~user feedback** is connected: +- Search for related support tickets or feature requests +- Count how many customers have asked for something similar +- Pull representative quotes from customer feedback + +If **~~product analytics** is connected: +- Pull usage data related to the problem area +- Search for behavioral signals (drop-offs, workarounds, low adoption) +- Find data that quantifies the impact of the problem + +If these tools are not connected, work from what the user provides. Explicitly note where more data would strengthen the concept. + +### 4. Generate the Feature Concept + +Produce a structured feature concept document. See the **feature-spec** skill (especially the Idea Structuring section) for guidance on moving from raw idea to PRD-ready concept. + +- **Problem Definition**: What user problem does this solve? Who experiences it? How severe is it? (2-3 sentences, grounded in evidence) +- **Customer Signal Summary**: What evidence supports this idea? Number of requests, support tickets, community votes, competitive pressure. +- **Solution Options**: 2-3 approaches to solving the problem: + - **Option A**: Simplest version that addresses the core problem + - **Option B**: More comprehensive approach with broader impact + - **Option C**: Different angle or creative alternative + - For each: brief description, estimated effort, expected impact, key risk +- **Assumptions to Validate**: What must be true for this to work? List 3-5 assumptions that should be tested before committing. +- **Open Questions**: What do we not know yet? Tag each with who should answer. +- **Recommended Next Step**: Is this ready for a PRD? Should we prototype first? Run customer interviews? Analyze data? +- **2-Week Action Plan**: Specific steps to move this forward, with owners and dates. + +### 5. Follow Up + +After generating the concept: +- Offer to turn it into a full PRD using `/write-spec` +- Offer to create a prototype of the most promising option using `/prototype` +- Offer to draft customer interview questions to validate assumptions +- Offer to create a one-pager summary for stakeholder alignment + +## Output Format + +Use markdown with clear headers. Keep the document to 1-2 pages — this is a concept document, not a full spec. The goal is to structure thinking enough to make a go/no-go decision on further investment. + +## Tips + +- Do not fall in love with the first solution. Generate at least 2-3 options before recommending one. +- The "Assumptions to Validate" section is the most important part. Every idea has hidden assumptions that can make or break it. +- Be direct about signal strength. "2 customers mentioned this once" is different from "47 support tickets in 3 months." +- The recommended next step should match the signal strength. Strong signal → write the PRD. Weak signal → validate first. +- Keep the action plan to 2 weeks. If it takes longer to validate an idea, the idea may be too big or too vague. diff --git a/product-management/commands/meeting-prep.md b/product-management/commands/meeting-prep.md new file mode 100644 index 0000000..1f7724d --- /dev/null +++ b/product-management/commands/meeting-prep.md @@ -0,0 +1,85 @@ +--- +description: Prepare for a customer meeting with account context, talking points, risks, and questions to ask +argument-hint: "" +--- + +# Meeting Prep + +> If you see unfamiliar placeholders or need to check which tools are connected, see [CONNECTORS.md](../CONNECTORS.md). + +Generate a meeting preparation pack with account context, talking points, and risk assessment. + +## Workflow + +### 1. Understand the Meeting + +Ask the user: +- What account or customer is this meeting with? +- What type of meeting? (QBR, check-in, escalation, executive briefing, sales call) +- When is the meeting? +- Who is attending from the customer side? What are their roles and priorities? +- Any specific topics or concerns to address? + +### 2. Pull Context from Connected Tools + +If **~~user feedback** is connected: +- Pull open support tickets for this account and their severity +- Search for recent feature requests or feedback from this customer +- Check support ticket volume and resolution time trends + +If **~~meeting transcription** is connected: +- Pull notes from previous meetings with this account +- Identify open action items from the last meeting +- Surface recurring themes or concerns raised in past calls + +If **~~chat** is connected: +- Search for recent internal conversations about this account +- Pull any customer-facing thread activity +- Identify any escalations or urgent issues discussed + +If **~~knowledge base** is connected: +- Search for account plans, success plans, or internal notes +- Pull any relevant case studies or reference materials +- Find related feature specs or roadmap items + +If **~~project tracker** is connected: +- Search for tickets tagged with this account or customer +- Pull status on any committed deliverables for this customer + +If these tools are not connected, ask the user to paste: +- Account health score, NPS, and contract details +- Recent support tickets for this account +- Previous meeting notes or Gong call summaries +- Any relevant internal context + +### 3. Generate the Prep Pack + +Produce a structured meeting preparation document. See the **meeting-preparation** skill for detailed guidance on account review methodology, talking point frameworks, and risk identification. + +- **Account Snapshot**: Key facts — contract details, health score, tenure, usage summary +- **Meeting Context**: Type, attendees with roles, and agenda +- **Talking Points**: Proactive points (what you want to communicate), reactive points (what they will likely ask), and discovery questions (what you want to learn) +- **Open Items**: Status of their feature requests, support tickets, and previous action items +- **Risks**: Issues that could come up — escalations, delays, competitor mentions, renewal concerns +- **Opportunities**: Expansion potential, case study opportunity, new stakeholder introduction +- **Recommended Approach**: How to structure the conversation and what outcome to aim for + +### 4. Follow Up + +After generating the prep pack: +- Offer to draft the meeting agenda to send in advance +- Offer to prepare specific talking point scripts for sensitive topics +- Offer to create a post-meeting summary template +- Offer to prep a QBR deck if this is a quarterly review + +## Output Format + +Use markdown with clear headers. Keep the document actionable — the reader should be able to walk into the meeting confidently after a 5-minute read. + +## Tips + +- Know who is in the room. Different stakeholders care about different things — a CTO cares about technical roadmap, a VP of Ops cares about support and reliability. +- Review previous meeting action items before the call. Nothing erodes trust faster than forgotten commitments. +- Prepare at least 3 discovery questions. Meetings where you only present and never learn are wasted opportunities. +- If there are known issues or risks, address them proactively rather than waiting for the customer to bring them up. +- Have a clear outcome in mind for every meeting. What do you want to be true after the meeting that is not true before it? diff --git a/product-management/commands/one-pager.md b/product-management/commands/one-pager.md new file mode 100644 index 0000000..81fd3e2 --- /dev/null +++ b/product-management/commands/one-pager.md @@ -0,0 +1,82 @@ +--- +description: Synthesize multiple inputs into a concise one-page executive summary under 500 words +argument-hint: "" +--- + +# One-Pager + +> If you see unfamiliar placeholders or need to check which tools are connected, see [CONNECTORS.md](../CONNECTORS.md). + +Distill complex information into a one-page executive summary. + +## Workflow + +### 1. Understand the Purpose + +Ask the user: +- What is this one-pager for? (Board meeting, executive review, stakeholder alignment, project kickoff) +- Who is the audience? (C-suite, board, cross-functional leaders, investors) +- What is the core topic or initiative? +- What outcome do you want from the reader? (Decision, approval, awareness, funding) + +### 2. Gather Source Material + +Ask the user for the documents or data to synthesize. Accept any combination of: +- PRDs, spec documents, or project plans +- Research reports or analysis documents +- Sprint reviews or progress updates +- Metrics dashboards or data exports +- Strategy documents or OKR updates +- Meeting notes or decision records + +### 3. Pull Context from Connected Tools + +If **~~knowledge base** is connected: +- Search for related documents, specs, and reports +- Pull relevant meeting notes and decision records +- Find related strategy documents or OKR updates + +If **~~product analytics** is connected: +- Pull key metrics related to the topic +- Search for trend data and benchmarks +- Find usage data that supports the narrative + +If **~~project tracker** is connected: +- Pull status on related initiatives +- Search for milestone progress and timeline updates + +If these tools are not connected, work entirely from what the user provides. Ask the user to paste or describe the source material. + +### 4. Generate the One-Pager + +Produce a concise executive summary. See the **executive-synthesis** skill for detailed guidance on the pyramid principle, audience adaptation, and synthesis process. + +Strict constraint: **Under 500 words.** Every word must earn its place. + +- **Title**: Clear and specific. "[Initiative] — [Status/Purpose]" +- **TL;DR**: 2-3 sentences capturing the full message. If the reader stops here, they should have the essential point. +- **Context**: Minimum background needed for a new reader (2-3 sentences maximum, not a full history) +- **Key Findings**: 3-5 most important data points or insights, each in one sentence. Quantify wherever possible. +- **Recommendation**: What should happen next, stated clearly and directly (1-2 sentences) +- **Next Steps**: 2-3 specific actions with owners and timelines + +### 5. Follow Up + +After generating the one-pager: +- Offer to create a TL;DR version for Slack using `/tldr` +- Offer to expand into a full presentation using `/stakeholder-update` +- Offer to adjust the tone for a different audience +- Offer to add an appendix with supporting data + +## Output Format + +Use markdown with clear headers. The document must fit on one printed page — approximately 400-500 words. Use bullet points sparingly and only when they improve scannability. + +## Tips + +- Start with the recommendation, not the background. Executives want your answer before your analysis. +- Every claim should be backed by a specific data point. "Significant improvement" is not useful; "40% reduction in search time" is. +- Three sentences of context maximum. Assume the reader knows the background or can ask. +- If you cannot state the TL;DR in 2-3 sentences, you have not synthesized enough. Go back and clarify the governing thought. +- Cut adverbs and qualifiers. "Very significant improvement of approximately 40%" becomes "40% improvement." +- Test the one-pager: can someone unfamiliar with the project understand the recommendation and next steps? If not, revise. diff --git a/product-management/commands/prototype.md b/product-management/commands/prototype.md new file mode 100644 index 0000000..647a890 --- /dev/null +++ b/product-management/commands/prototype.md @@ -0,0 +1,84 @@ +--- +description: Generate a standalone interactive HTML prototype from a PRD or feature description +argument-hint: "" +--- + +# Prototype + +> If you see unfamiliar placeholders or need to check which tools are connected, see [CONNECTORS.md](../CONNECTORS.md). + +Generate an interactive HTML prototype that can be opened directly in a browser. + +**CRITICAL**: Output ONLY a complete, standalone HTML file. No markdown wrapping, no code fences, no explanations — just the raw HTML that can be saved as a `.html` file and opened in a browser. + +## Workflow + +### 1. Understand What to Prototype + +Ask the user: +- What feature or flow should the prototype demonstrate? +- Is there a PRD, spec, or feature description to work from? +- Which screens or pages are most important to show? +- Any specific interactions to include? (Filters, tabs, forms, modals) + +Accept any of: +- A full PRD or spec document +- A brief feature description ("search results page with filters") +- A user flow ("onboarding wizard with 3 steps") +- A reference ("something like Notion's sidebar navigation") + +### 2. Pull Context from Connected Tools + +If **~~design** is connected: +- Pull related mockups, wireframes, or design explorations +- Search for design system components and tokens (colors, fonts, spacing) +- Use existing design patterns as a reference for consistency + +If **~~knowledge base** is connected: +- Search for related PRDs, specs, or feature descriptions +- Pull any design guidelines or brand documentation +- Find related user research that informs the design + +If these tools are not connected, work from what the user provides. Ask about: +- Design preferences (color scheme, style — modern, minimal, playful) +- Specific components to include (sidebar, data table, dashboard cards, forms) +- What data should the prototype show? (Realistic example content) + +### 3. Generate the Prototype + +Produce a complete, standalone HTML file. See the **html-prototyping** skill for detailed guidance on design defaults, layout patterns, interactive components, and accessibility basics. + +The HTML file must: +- Be completely self-contained (all CSS in `