mohitagw15856
036511ab3e
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>
2.8 KiB
2.8 KiB
Roadmap Narrative Skill
Convert a ranked list of product initiatives into a clear, strategic narrative that connects individual items to company goals and communicates a coherent product direction.
Required Inputs
Ask the user for these if not provided:
- Prioritised initiative list (with rough timelines or quarters)
- Company OKRs or strategic priorities (to connect roadmap to company goals)
- Audience (all-hands, board, investors, sales team — changes tone and depth)
- Items explicitly NOT on the roadmap (optional but strengthens credibility)
Process
- Review the prioritised initiative list and company OKRs provided
- Identify 2-3 strategic themes that group the initiatives naturally
- For each theme, articulate: the problem it addresses, the customer it serves, the metric it moves
- Write a quarter-level narrative that shows progression — how does H1 set up H2?
- Draft an executive summary (3-4 sentences max) that non-technical stakeholders can repeat
- Validate — Confirm every initiative maps to a theme. If an initiative is orphaned, either create a theme or flag it as a narrative gap to address
Output Structure
Product Roadmap: [Quarter/Half/Year]
Strategic Context: [1 paragraph: market moment, key challenge, our response]
Theme 1: [Theme Name]
- Strategic rationale
- Initiatives included
- Primary metric impacted
- Dependencies
[Repeat for each theme]
What's Not on the Roadmap (and Why): [2-3 items with rationale — shows strategic discipline, not just prioritisation]
Executive Summary (shareable): [3-4 sentences that could be shared in an all-hands or board update]
Tone Guidelines
- Write for a CFO, not an engineer
- Lead with customer outcomes, not features
- Be honest about what's NOT on the roadmap and why
Quality Checks
- Every initiative in the input maps to a strategic theme
- The executive summary can stand alone and be repeated correctly after one reading
- Progression narrative shows causal links between quarters (not just chronological listing)
- "What's not on the roadmap" section includes at least 2 items with clear rationale
- Language throughout is free of engineering jargon — tested by asking: "could a CFO repeat this?"
Anti-Patterns
- Do not produce a list of features with dates and call it a narrative — every initiative must connect to a strategic theme
- Do not omit the "what's not on the roadmap" section — without it, the narrative lacks strategic discipline
- Do not write progression as a chronological list — show causal links between quarters (Q1 enables Q2 because…)
- Do not write the executive summary last and treat it as a summary — write it as the version stakeholders will repeat
- Do not let orphaned initiatives appear without a theme — either create a theme or flag the gap explicitly