@diottodev/runic 1.0.0 → 1.1.0

package/product/product-manager-toolkit/SKILL.md

@@ -0,0 +1,352 @@
+---
+name: "product-manager-toolkit"
+description: Comprehensive toolkit for product managers including RICE prioritization, customer interview analysis, PRD templates, discovery frameworks, and go-to-market strategies. Use for feature prioritization, user research synthesis, requirement documentation, and product strategy development.
+---
+
+# Product Manager Toolkit
+
+Essential tools and frameworks for modern product management, from discovery to delivery.
+
+---
+
+## Table of Contents
+
+- [Quick Start](#quick-start)
+- [Core Workflows](#core-workflows)
+  - [Feature Prioritization](#feature-prioritization-process)
+  - [Customer Discovery](#customer-discovery-process)
+  - [PRD Development](#prd-development-process)
+- [Tools Reference](#tools-reference)
+  - [RICE Prioritizer](#rice-prioritizer)
+  - [Customer Interview Analyzer](#customer-interview-analyzer)
+- [Input/Output Examples](#inputoutput-examples)
+- [Integration Points](#integration-points)
+- [Common Pitfalls](#common-pitfalls-to-avoid)
+
+---
+
+## Quick Start
+
+### For Feature Prioritization
+```bash
+# Create sample data file
+python scripts/rice_prioritizer.py sample
+
+# Run prioritization with team capacity
+python scripts/rice_prioritizer.py sample_features.csv --capacity 15
+```
+
+### For Interview Analysis
+```bash
+python scripts/customer_interview_analyzer.py interview_transcript.txt
+```
+
+### For PRD Creation
+1. Choose template from `references/prd_templates.md`
+2. Fill sections based on discovery work
+3. Review with engineering for feasibility
+4. Version control in project management tool
+
+---
+
+## Core Workflows
+
+### Feature Prioritization Process
+
+```
+Gather → Score → Analyze → Plan → Validate → Execute
+```
+
+#### Step 1: Gather Feature Requests
+- Customer feedback (support tickets, interviews)
+- Sales requests (CRM pipeline blockers)
+- Technical debt (engineering input)
+- Strategic initiatives (leadership goals)
+
+#### Step 2: Score with RICE
+```bash
+# Input: CSV with features
+python scripts/rice_prioritizer.py features.csv --capacity 20
+```
+
+See `references/frameworks.md` for RICE formula and scoring guidelines.
+
+#### Step 3: Analyze Portfolio
+Review the tool output for:
+- Quick wins vs big bets distribution
+- Effort concentration (avoid all XL projects)
+- Strategic alignment gaps
+
+#### Step 4: Generate Roadmap
+- Quarterly capacity allocation
+- Dependency identification
+- Stakeholder communication plan
+
+#### Step 5: Validate Results
+**Before finalizing the roadmap:**
+- [ ] Compare top priorities against strategic goals
+- [ ] Run sensitivity analysis (what if estimates are wrong by 2x?)
+- [ ] Review with key stakeholders for blind spots
+- [ ] Check for missing dependencies between features
+- [ ] Validate effort estimates with engineering
+
+#### Step 6: Execute and Iterate
+- Share roadmap with team
+- Track actual vs estimated effort
+- Revisit priorities quarterly
+- Update RICE inputs based on learnings
+
+---
+
+### Customer Discovery Process
+
+```
+Plan → Recruit → Interview → Analyze → Synthesize → Validate
+```
+
+#### Step 1: Plan Research
+- Define research questions
+- Identify target segments
+- Create interview script (see `references/frameworks.md`)
+
+#### Step 2: Recruit Participants
+- 5-8 interviews per segment
+- Mix of power users and churned users
+- Incentivize appropriately
+
+#### Step 3: Conduct Interviews
+- Use semi-structured format
+- Focus on problems, not solutions
+- Record with permission
+- Take minimal notes during interview
+
+#### Step 4: Analyze Insights
+```bash
+python scripts/customer_interview_analyzer.py transcript.txt
+```
+
+Extracts:
+- Pain points with severity
+- Feature requests with priority
+- Jobs to be done patterns
+- Sentiment and key themes
+- Notable quotes
+
+#### Step 5: Synthesize Findings
+- Group similar pain points across interviews
+- Identify patterns (3+ mentions = pattern)
+- Map to opportunity areas using Opportunity Solution Tree
+- Prioritize opportunities by frequency and severity
+
+#### Step 6: Validate Solutions
+**Before building:**
+- [ ] Create solution hypotheses (see `references/frameworks.md`)
+- [ ] Test with low-fidelity prototypes
+- [ ] Measure actual behavior vs stated preference
+- [ ] Iterate based on feedback
+- [ ] Document learnings for future research
+
+---
+
+### PRD Development Process
+
+```
+Scope → Draft → Review → Refine → Approve → Track
+```
+
+#### Step 1: Choose Template
+Select from `references/prd_templates.md`:
+
+| Template | Use Case | Timeline |
+|----------|----------|----------|
+| Standard PRD | Complex features, cross-team | 6-8 weeks |
+| One-Page PRD | Simple features, single team | 2-4 weeks |
+| Feature Brief | Exploration phase | 1 week |
+| Agile Epic | Sprint-based delivery | Ongoing |
+
+#### Step 2: Draft Content
+- Lead with problem statement
+- Define success metrics upfront
+- Explicitly state out-of-scope items
+- Include wireframes or mockups
+
+#### Step 3: Review Cycle
+- Engineering: feasibility and effort
+- Design: user experience gaps
+- Sales: market validation
+- Support: operational impact
+
+#### Step 4: Refine Based on Feedback
+- Address technical constraints
+- Adjust scope to fit timeline
+- Document trade-off decisions
+
+#### Step 5: Approval and Kickoff
+- Stakeholder sign-off
+- Sprint planning integration
+- Communication to broader team
+
+#### Step 6: Track Execution
+**After launch:**
+- [ ] Compare actual metrics vs targets
+- [ ] Conduct user feedback sessions
+- [ ] Document what worked and what didn't
+- [ ] Update estimation accuracy data
+- [ ] Share learnings with team
+
+---
+
+## Tools Reference
+
+### RICE Prioritizer
+
+Advanced RICE framework implementation with portfolio analysis.
+
+**Features:**
+- RICE score calculation with configurable weights
+- Portfolio balance analysis (quick wins vs big bets)
+- Quarterly roadmap generation based on capacity
+- Multiple output formats (text, JSON, CSV)
+
+**CSV Input Format:**
+```csv
+name,reach,impact,confidence,effort,description
+User Dashboard Redesign,5000,high,high,l,Complete redesign
+Mobile Push Notifications,10000,massive,medium,m,Add push support
+Dark Mode,8000,medium,high,s,Dark theme option
+```
+
+**Commands:**
+```bash
+# Create sample data
+python scripts/rice_prioritizer.py sample
+
+# Run with default capacity (10 person-months)
+python scripts/rice_prioritizer.py features.csv
+
+# Custom capacity
+python scripts/rice_prioritizer.py features.csv --capacity 20
+
+# JSON output for integration
+python scripts/rice_prioritizer.py features.csv --output json
+
+# CSV output for spreadsheets
+python scripts/rice_prioritizer.py features.csv --output csv
+```
+
+---
+
+### Customer Interview Analyzer
+
+NLP-based interview analysis for extracting actionable insights.
+
+**Capabilities:**
+- Pain point extraction with severity assessment
+- Feature request identification and classification
+- Jobs-to-be-done pattern recognition
+- Sentiment analysis per section
+- Theme and quote extraction
+- Competitor mention detection
+
+**Commands:**
+```bash
+# Analyze interview transcript
+python scripts/customer_interview_analyzer.py interview.txt
+
+# JSON output for aggregation
+python scripts/customer_interview_analyzer.py interview.txt json
+```
+
+---
+
+## Input/Output Examples
+→ See references/input-output-examples.md for details
+
+## Integration Points
+
+Compatible tools and platforms:
+
+| Category | Platforms |
+|----------|-----------|
+| **Analytics** | Amplitude, Mixpanel, Google Analytics |
+| **Roadmapping** | ProductBoard, Aha!, Roadmunk, Productplan |
+| **Design** | Figma, Sketch, Miro |
+| **Development** | Jira, Linear, GitHub, Asana |
+| **Research** | Dovetail, UserVoice, Pendo, Maze |
+| **Communication** | Slack, Notion, Confluence |
+
+**JSON export enables integration with most tools:**
+```bash
+# Export for Jira import
+python scripts/rice_prioritizer.py features.csv --output json > priorities.json
+
+# Export for dashboard
+python scripts/customer_interview_analyzer.py interview.txt json > insights.json
+```
+
+---
+
+## Common Pitfalls to Avoid
+
+| Pitfall | Description | Prevention |
+|---------|-------------|------------|
+| **Solution-First** | Jumping to features before understanding problems | Start every PRD with problem statement |
+| **Analysis Paralysis** | Over-researching without shipping | Set time-boxes for research phases |
+| **Feature Factory** | Shipping features without measuring impact | Define success metrics before building |
+| **Ignoring Tech Debt** | Not allocating time for platform health | Reserve 20% capacity for maintenance |
+| **Stakeholder Surprise** | Not communicating early and often | Weekly async updates, monthly demos |
+| **Metric Theater** | Optimizing vanity metrics over real value | Tie metrics to user value delivered |
+
+---
+
+## Best Practices
+
+**Writing Great PRDs:**
+- Start with the problem, not the solution
+- Include clear success metrics upfront
+- Explicitly state what's out of scope
+- Use visuals (wireframes, flows, diagrams)
+- Keep technical details in appendix
+- Version control all changes
+
+**Effective Prioritization:**
+- Mix quick wins with strategic bets
+- Consider opportunity cost of delays
+- Account for dependencies between features
+- Buffer 20% for unexpected work
+- Revisit priorities quarterly
+- Communicate decisions with context
+
+**Customer Discovery:**
+- Ask "why" five times to find root cause
+- Focus on past behavior, not future intentions
+- Avoid leading questions ("Wouldn't you love...")
+- Interview in the user's natural environment
+- Watch for emotional reactions (pain = opportunity)
+- Validate qualitative with quantitative data
+
+---
+
+## Quick Reference
+
+```bash
+# Prioritization
+python scripts/rice_prioritizer.py features.csv --capacity 15
+
+# Interview Analysis
+python scripts/customer_interview_analyzer.py interview.txt
+
+# Generate sample data
+python scripts/rice_prioritizer.py sample
+
+# JSON outputs
+python scripts/rice_prioritizer.py features.csv --output json
+python scripts/customer_interview_analyzer.py interview.txt json
+```
+
+---
+
+## Reference Documents
+
+- `references/prd_templates.md` - PRD templates for different contexts
+- `references/frameworks.md` - Detailed framework documentation (RICE, MoSCoW, Kano, JTBD, etc.)

package/product/product-skills/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: "product-skills"
+description: "10 product agent skills and plugins for Claude Code, Codex, Gemini CLI, Cursor, OpenClaw. PM toolkit (RICE), agile PO, product strategist (OKR), UX researcher, UI design system, competitive teardown, landing page generator, SaaS scaffolder, research summarizer. Python tools (stdlib-only)."
+version: 2.9.0
+author: Alireza Rezvani
+license: MIT
+tags:
+  - product
+  - product-management
+  - ux
+  - ui
+  - saas
+  - agile
+agents:
+  - claude-code
+  - codex-cli
+  - openclaw
+---
+
+# Product Team Skills
+
+8 production-ready product skills covering product management, UX/UI design, and SaaS development.
+
+## Quick Start
+
+### Claude Code
+```
+/read product-team/product-manager-toolkit/SKILL.md
+```
+
+### Codex CLI
+```bash
+npx agent-skills-cli add alirezarezvani/claude-skills/product-team
+```
+
+## Skills Overview
+
+| Skill | Folder | Focus |
+|-------|--------|-------|
+| Product Manager Toolkit | `product-manager-toolkit/` | RICE prioritization, customer discovery, PRDs |
+| Agile Product Owner | `agile-product-owner/` | User stories, sprint planning, backlog |
+| Product Strategist | `product-strategist/` | OKR cascades, market analysis, vision |
+| UX Researcher Designer | `ux-researcher-designer/` | Personas, journey maps, usability testing |
+| UI Design System | `ui-design-system/` | Design tokens, component docs, responsive |
+| Competitive Teardown | `competitive-teardown/` | Systematic competitor analysis |
+| Landing Page Generator | `landing-page-generator/` | Conversion-optimized pages |
+| SaaS Scaffolder | `saas-scaffolder/` | Production SaaS boilerplate |
+
+## Python Tools
+
+9 scripts, all stdlib-only:
+
+```bash
+python3 product-manager-toolkit/scripts/rice_prioritizer.py --help
+python3 product-strategist/scripts/okr_cascade_generator.py --help
+```
+
+## Rules
+
+- Load only the specific skill SKILL.md you need
+- Use Python tools for scoring and analysis, not manual judgment

package/product/product-strategist/SKILL.md

@@ -0,0 +1,227 @@
+---
+name: "product-strategist"
+description: Strategic product leadership toolkit for Head of Product covering OKR cascade generation, quarterly planning, competitive landscape analysis, product vision documents, and team scaling proposals. Use when creating quarterly OKR documents, defining product goals or KPIs, building product roadmaps, running competitive analysis, drafting team structure or hiring plans, aligning product strategy across engineering and design, or generating cascaded goal hierarchies from company to team level.
+---
+
+# Product Strategist
+
+Strategic toolkit for Head of Product to drive vision, alignment, and organizational excellence.
+
+---
+
+## Core Capabilities
+
+| Capability | Description | Tool |
+|------------|-------------|------|
+| **OKR Cascade** | Generate aligned OKRs from company to team level | `okr_cascade_generator.py` |
+| **Alignment Scoring** | Measure vertical and horizontal alignment | Built into generator |
+| **Strategy Templates** | 5 pre-built strategy types | Growth, Retention, Revenue, Innovation, Operational |
+| **Team Configuration** | Customize for your org structure | `--teams` flag |
+
+---
+
+## Quick Start
+
+```bash
+# Growth strategy with default teams
+python scripts/okr_cascade_generator.py growth
+
+# Retention strategy with custom teams
+python scripts/okr_cascade_generator.py retention --teams "Engineering,Design,Data"
+
+# Revenue strategy with 40% product contribution
+python scripts/okr_cascade_generator.py revenue --contribution 0.4
+
+# Export as JSON for integration
+python scripts/okr_cascade_generator.py growth --json > okrs.json
+```
+
+---
+
+## Workflow: Quarterly Strategic Planning
+
+### Step 1: Define Strategic Focus
+
+| Strategy | When to Use |
+|----------|-------------|
+| **Growth** | Scaling user base, market expansion |
+| **Retention** | Reducing churn, improving LTV |
+| **Revenue** | Increasing ARPU, new monetization |
+| **Innovation** | Market differentiation, new capabilities |
+| **Operational** | Improving efficiency, scaling operations |
+
+See `references/strategy_types.md` for detailed guidance.
+
+### Step 2: Gather Input Metrics
+
+```json
+{
+  "current": 100000,      // Current MAU
+  "target": 150000,       // Target MAU
+  "current_nps": 40,      // Current NPS
+  "target_nps": 60        // Target NPS
+}
+```
+
+### Step 3: Configure Teams & Run Generator
+
+```bash
+# Default teams
+python scripts/okr_cascade_generator.py growth
+
+# Custom org structure with contribution percentage
+python scripts/okr_cascade_generator.py growth \
+  --teams "Core,Platform,Mobile,AI" \
+  --contribution 0.3
+```
+
+### Step 4: Review Alignment Scores
+
+| Score | Target | Action if Below |
+|-------|--------|-----------------|
+| Vertical Alignment | >90% | Ensure all objectives link to parent |
+| Horizontal Alignment | >75% | Check for team coordination gaps |
+| Coverage | >80% | Validate all company OKRs are addressed |
+| Balance | >80% | Redistribute if one team is overloaded |
+| **Overall** | **>80%** | <60% needs restructuring |
+
+### Step 5: Refine, Validate, and Export
+
+Before finalizing:
+
+- [ ] Review generated objectives with stakeholders
+- [ ] Adjust team assignments based on capacity
+- [ ] Validate contribution percentages are realistic
+- [ ] Ensure no conflicting objectives across teams
+- [ ] Set up tracking cadence (bi-weekly check-ins)
+
+```bash
+# Export JSON for tools like Lattice, Ally, Workboard
+python scripts/okr_cascade_generator.py growth --json > q1_okrs.json
+```
+
+---
+
+## OKR Cascade Generator
+
+### Usage
+
+```bash
+python scripts/okr_cascade_generator.py [strategy] [options]
+```
+
+**Strategies:** `growth` | `retention` | `revenue` | `innovation` | `operational`
+
+### Configuration Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--teams`, `-t` | Comma-separated team names | Growth,Platform,Mobile,Data |
+| `--contribution`, `-c` | Product contribution to company OKRs (0-1) | 0.3 (30%) |
+| `--json`, `-j` | Output as JSON instead of dashboard | False |
+| `--metrics`, `-m` | Metrics as JSON string | Sample metrics |
+
+### Output Examples
+
+#### Dashboard Output (`growth` strategy)
+
+```
+============================================================
+OKR CASCADE DASHBOARD
+Quarter: Q1 2025  |  Strategy: GROWTH
+Teams: Growth, Platform, Mobile, Data  |  Product Contribution: 30%
+============================================================
+
+🏢 COMPANY OKRS
+📌 CO-1: Accelerate user acquisition and market expansion
+   └─ CO-1-KR1: Increase MAU from 100,000 to 150,000
+   └─ CO-1-KR2: Achieve 50% MoM growth rate
+   └─ CO-1-KR3: Expand to 3 new markets
+
+📌 CO-2: Achieve product-market fit in new segments
+📌 CO-3: Build sustainable growth engine
+
+🚀 PRODUCT OKRS
+📌 PO-1: Build viral product features and market expansion
+   ↳ Supports: CO-1
+   └─ PO-1-KR1: Increase product MAU to 45,000
+   └─ PO-1-KR2: Achieve 45% feature adoption rate
+
+👥 TEAM OKRS
+Growth Team:
+  📌 GRO-1: Build viral product features through acquisition and activation
+     └─ GRO-1-KR1: Increase product MAU to 11,250
+     └─ GRO-1-KR2: Achieve 11.25% feature adoption rate
+
+🎯 ALIGNMENT SCORES
+✓ Vertical Alignment: 100.0%
+! Horizontal Alignment: 75.0%
+✓ Coverage: 100.0%  |  ✓ Balance: 97.5%  |  ✓ Overall: 94.0%
+✅ Overall alignment is GOOD (≥80%)
+```
+
+#### JSON Output (`retention --json`, truncated)
+
+```json
+{
+  "quarter": "Q1 2025",
+  "strategy": "retention",
+  "company": {
+    "objectives": [
+      {
+        "id": "CO-1",
+        "title": "Create lasting customer value and loyalty",
+        "key_results": [
+          { "id": "CO-1-KR1", "title": "Improve retention from 70% to 85%", "current": 70, "target": 85 }
+        ]
+      }
+    ]
+  },
+  "product": { "contribution": 0.3, "objectives": ["..."] },
+  "teams": ["..."],
+  "alignment_scores": {
+    "vertical_alignment": 100.0, "horizontal_alignment": 75.0,
+    "coverage": 100.0, "balance": 97.5, "overall": 94.0
+  }
+}
+```
+
+See `references/examples/sample_growth_okrs.json` for a complete example.
+
+---
+
+## Reference Documents
+
+| Document | Description |
+|----------|-------------|
+| `references/okr_framework.md` | OKR methodology, writing guidelines, alignment scoring |
+| `references/strategy_types.md` | Detailed breakdown of all 5 strategy types with examples |
+| `references/examples/sample_growth_okrs.json` | Complete sample output for growth strategy |
+
+---
+
+## Best Practices
+
+### OKR Cascade
+
+- Limit to 3-5 objectives per level, each with 3-5 key results
+- Key results must be measurable with current and target values
+- Validate parent-child relationships before finalizing
+
+### Alignment Scoring
+
+- Target >80% overall alignment; investigate any score below 60%
+- Balance scores ensure no team is overloaded
+- Horizontal alignment prevents conflicting goals across teams
+
+### Team Configuration
+
+- Configure teams to match your actual org structure
+- Adjust contribution percentages based on team size
+- Platform/Infrastructure teams often support all objectives
+- Specialized teams (ML, Data) may only support relevant objectives
+
+## Related Skills
+
+- **Senior PM** (`project-management/senior-pm/`) — Portfolio management and risk analysis inform strategic planning
+- **Competitive Teardown** (`product-team/competitive-teardown/`) — Competitive intelligence feeds product strategy