@jairodri/huckleberry-cli 1.0.2 → 1.1.0

package/skills/startup-launcher/references/platforms/g2.md

@@ -0,0 +1,226 @@
+# G2 Platform Guide
+
+## Platform Overview
+
+**What it is:** G2 (formerly G2 Crowd) is the world's largest and most trusted software marketplace and peer review platform for B2B software. It enables users to discover, research, and evaluate business software through authentic peer reviews and comparative analysis.
+
+**Who runs it:** Founded in 2012 by Godard Abel and team (former BigMachines employees), headquartered in Chicago, Illinois.
+
+**URL:** https://www.g2.com/
+
+**Category:** Software review platform, B2B marketplace, and SaaS discovery engine.
+
+## Key Stats
+
+**Domain Rating:** High-authority domain (90+ DR estimated based on traffic patterns)
+
+**Monthly Traffic:** Millions of monthly visitors (exact figures proprietary, but consistently ranks as top software discovery platform)
+
+**Audience Size:** 
+- 5+ million software professionals using the platform
+- 1.5 million+ verified user reviews
+- 150,000+ software products listed
+- Used by 80%+ of Fortune 500 companies for software decisions
+
+**Pricing:**
+- **Free Plan:** Basic listing, limited features
+- **G2 Brand Starter:** ~$15,000/year (list price, often negotiated down to ~$9,000-10,000)
+- **G2 Brand Professional:** ~$25,000-40,000/year  
+- **G2 Brand Enterprise:** $50,000+/year
+- **Add-ons:** Buyer Intent data (~$36,000/year), Review Growth (~$36,000/year)
+
+## Who Should Use This
+
+**Ideal for:**
+- B2B SaaS companies (any size)
+- Enterprise software providers
+- Niche category leaders seeking visibility
+- Companies with satisfied customers willing to write reviews
+- Businesses targeting software buyers who research before purchasing
+
+**Best product types:**
+- Business software and SaaS tools
+- Enterprise applications
+- Productivity tools
+- Marketing technology
+- Development tools
+- HR and operations software
+
+**NOT ideal for:**
+- Consumer-focused products
+- Physical products
+- Services without software components
+- Companies unwilling to actively collect reviews
+
+## Submission Process
+
+### Step 1: Initial Setup
+1. Visit https://sell.g2.com/ or contact G2 directly
+2. Create vendor account with business email
+3. Provide company information and product details
+4. Verify business legitimacy (business email domain required)
+
+### Step 2: Product Profile Creation
+1. Complete product information form
+2. Upload company logo and product screenshots
+3. Write compelling product description
+4. Select appropriate software categories (G2 determines final categorization)
+5. Add integrations, supported platforms, and technical details
+
+### Step 3: Review and Launch
+1. G2 reviews submission for completeness and accuracy
+2. Profile goes live (typically 1-2 weeks)
+3. Begin review collection immediately upon launch
+
+## Requirements
+
+### Essential Assets:
+- **Company logo** (high-resolution, PNG/SVG preferred)
+- **Product screenshots** (4-6 high-quality images showing key features)
+- **Product description** (compelling, benefit-focused copy, 150-500 words)
+- **Company description** (brief company background and mission)
+- **Product demo/trial link**
+- **Pricing information** (can be "Contact for pricing")
+
+### Technical Requirements:
+- Valid business email domain
+- Company website with legitimate business presence
+- Working product (not just landing page)
+- Ability to provide customer references if requested
+
+### Optional but Recommended:
+- Product video demo
+- Case studies or customer success stories
+- Integration logos and technical specifications
+- Awards or certifications
+
+## Strategy & Tips
+
+### Pre-Launch Strategy:
+1. **Identify your category** - Research where competitors are listed
+2. **Audit competitor profiles** - Note what works well in your category
+3. **Prepare review collection plan** - Line up 5-10 happy customers ready to review
+4. **Optimize for keywords** - Use terms your buyers search for
+
+### Launch Strategy:
+1. **Get first 5 reviews quickly** - Essential for credibility
+2. **Focus on quality over quantity** - Detailed, authentic reviews perform better
+3. **Respond to reviews** (paid plans only) - Shows engagement and care
+4. **Monitor competitor activity** - Stay informed about category changes
+
+### Long-term Strategy:
+1. **Maintain steady review flow** - 2-3 new reviews per month ideal
+2. **Target G2 seasonal campaigns** - Awards, reports, badges
+3. **Leverage buyer intent data** (paid feature) - Identify prospects researching your category
+4. **Cross-promote reviews** - Use G2 reviews in other marketing materials
+
+## Tips & Tricks from the Community
+
+### From Reddit Founders:
+
+**Review Collection Best Practices:**
+- "Set up G2 and Capterra profiles early - this is crucial. Ask happy customers for reviews as soon as possible" (r/SaaS founder)
+- "30-40 reviews is the sweet spot. Having 2-3 recent reviews at any time is more important than total volume"
+- "G2 reps will let you import Google reviews to get started, but you have to ask"
+
+**Timing Insights:**
+- "Get reviews during customer success moments - right after positive support interactions or successful implementations"
+- "Follow up 30-60 days after onboarding when customers see real value"
+
+**Budget Reality:**
+- "G2 is 100% free for basic listing. We have hundreds of reviews and never paid them a penny" 
+- "Primary motivation for paid plans is preventing competitor ads on your profile"
+- "Paid plans don't improve rankings - those are based on review scores and engagement"
+
+**Category Strategy:**
+- "Products are categorized based on features - vendors can't pick categories"
+- "If your category doesn't exist, you can request G2 create a new one"
+
+## Common Mistakes / Gotchas
+
+### Profile Setup Mistakes:
+- **Incomplete product information** - Leads to lower search visibility
+- **Poor quality screenshots** - Significantly impacts conversion rates
+- **Generic product descriptions** - Fails to differentiate from competitors
+- **Wrong category selection** - Reduces discoverability by target audience
+
+### Review Collection Pitfalls:
+- **Waiting too long to collect reviews** - Harder to get reviews from older customers
+- **Not following up** - Single ask rarely generates reviews
+- **Incentivizing reviews inappropriately** - G2 prohibits paid reviews
+- **Focusing only on quantity** - Quality and recency matter more
+
+### Platform Changes:
+- **Free plan limitations increasing** - Many features now require paid plans
+- **Review moderation tightening** - Legitimate reviews sometimes rejected
+- **Competitor ads on profiles** - Free plans now show competitor alternatives prominently
+- **Badge restrictions** - Many badge types now require paid plans
+
+### SEO and Visibility:
+- **Ignoring G2's Google ranking power** - G2 pages often rank highly in Google
+- **Not optimizing for buyer search terms** - Missing key discovery opportunities
+- **Neglecting profile maintenance** - Outdated information hurts credibility
+
+## Pre-Launch Checklist
+
+### Business Readiness:
+- [ ] Company has legitimate business operations
+- [ ] Product is live and functional (not just beta)
+- [ ] Website contains comprehensive product information
+- [ ] Business email domain established
+- [ ] Customer list of satisfied users identified
+
+### Content Preparation:
+- [ ] High-resolution company logo prepared
+- [ ] 4-6 product screenshots captured and optimized
+- [ ] Compelling product description written (150-500 words)
+- [ ] Company description drafted
+- [ ] Pricing information determined
+- [ ] Demo/trial links confirmed working
+
+### Review Strategy:
+- [ ] 5-10 satisfied customers identified for initial reviews
+- [ ] Review request templates prepared
+- [ ] Follow-up sequence planned
+- [ ] Customer success team trained on review collection
+
+### Competitive Research:
+- [ ] Competitor profiles analyzed
+- [ ] Category landscape understood
+- [ ] Keyword research completed
+- [ ] Differentiation strategy defined
+
+## Post-Launch Checklist
+
+### First 30 Days:
+- [ ] Initial reviews collected (target: 5-10)
+- [ ] Profile optimized based on early performance
+- [ ] Review response strategy implemented (if paid plan)
+- [ ] Analytics and tracking set up
+- [ ] Team trained on ongoing management
+
+### Ongoing Maintenance (Monthly):
+- [ ] 2-3 new reviews collected
+- [ ] Profile information updated as needed
+- [ ] Competitor activity monitored
+- [ ] Performance metrics reviewed
+- [ ] Customer feedback incorporated into profile improvements
+
+### Quarterly Reviews:
+- [ ] Category positioning assessed
+- [ ] Paid plan ROI evaluated (if applicable)
+- [ ] Review collection process optimized
+- [ ] Integration opportunities explored
+- [ ] Awards and recognition programs participated in
+
+### Growth Opportunities:
+- [ ] G2 seasonal campaigns leveraged
+- [ ] Buyer intent data utilized (paid feature)
+- [ ] Cross-platform review strategy implemented
+- [ ] Customer success case studies developed
+- [ ] Speaking opportunities at G2 events explored
+
+---
+
+*Last updated: March 2026*
+*Sources: G2 documentation, vendor community insights, Reddit founder experiences*

package/skills/startup-launcher/references/platforms/hackernews.md

@@ -0,0 +1,99 @@
+# Hacker News (Show HN)
+
+## Quick Facts
+| Metric | Value |
+|--------|-------|
+| URL | news.ycombinator.com |
+| Monthly visits | ~15-20M |
+| Backlink | High authority (DR 90+) |
+| Cost | Free |
+| Cadence | Anytime |
+| Best timing | Sunday 12:00 UTC (best breakout rate: 11.75%) |
+| Front page traffic | 10,000-30,000 visitors in 24 hours |
+
+## Submission Requirements
+- Title starting with "Show HN:" (factual, no marketing language, no caps/exclamation)
+- Link to live, try-able product (not a signup page or landing page)
+- First comment posted immediately after submission (your actual pitch)
+- You must be the creator and present to discuss
+
+## How to Submit
+1. Have an active HN account with genuine comment history
+2. Go to news.ycombinator.com/submit
+3. Title: `Show HN: [Product Name] - [what it does in plain English]`
+4. Link to live demo (no signup required to try)
+5. Immediately post your first comment (technical details, backstory, limitations)
+
+## Ranking Algorithm
+```
+Score = (P-1)^0.8 / ((T+2)^1.8) * penalty_factor
+```
+- Time decays faster than votes accumulate
+- Show HN posts carry built-in 0.4 penalty (need ~2x upvotes vs regular posts)
+- **Controversy penalty at 40+ comments:** If comments > upvotes, penalty = (votes/comments)^2 or ^3. Can drop #1 to invisible in minutes.
+- Domain penalties on popular sites (medium.com, github.com, youtube.com)
+
+## Title Formulas That Work
+- `Show HN: [Name] - [plain description]` (most reliable)
+- `Show HN: I built [product] to [solve problem]` (personal, higher engagement)
+- No uppercase emphasis, no exclamation points, no superlatives (fastest, best, revolutionary)
+
+## First Comment Template
+```
+Hi HN! [Name] here, been working on [Product] for [timeframe].
+
+[One clear sentence: what it does.]
+
+[The problem and why it's harder than it looks. Be specific.]
+
+[How you built it. Stack, architecture, non-obvious decisions. 2-3 sentences minimum.]
+
+[What's different. Technical specifics, not marketing comparisons.]
+
+[Current status: beta/production, what's missing, what's next. Honesty builds trust.]
+
+Happy to answer questions about how it works or what we got wrong.
+```
+
+## What the Audience Expects
+- **Deeply technical.** They spot outdated libraries, reinvented wheels, fake benchmarks.
+- **Cynical but fair.** "Why didn't you just use rsync?" is a compliment disguised as a challenge.
+- **Transparency over polish.** Honest limitations > marketing claims.
+- **Try-able demos.** No signup gate. No email wall. Let them use it immediately.
+- **Transparent pricing.** "Contact for pricing" triggers negative comments.
+
+## Hard Rules / Gotchas
+- **Voting ring detection catches 5-6 coordinated votes.** Even linking to HN from a private Facebook group gets detected via referral patterns.
+- Never ask anyone to upvote. Period.
+- Don't coordinate friends to post supportive comments (community smells astroturfing).
+- Account that only posts own content gets flagged as promotional.
+- Reposting: OK if first post got little attention and it's been a year+. NOT OK if it had significant attention.
+
+## The Second-Chance Pool
+If your post doesn't gain traction but is genuinely good:
+- Email hn@ycombinator.com requesting consideration
+- Moderator may add to second-chance pool (quality posts get resurfaced)
+- Documented success: KTool got 30 upvotes first try, emailed, reposted to 13 hours on front page, 11K visitors, 300+ signups
+
+## Post-Launch
+- Secondary sources add 30-100% more traffic over 3-7 days (Hacker Newsletter, RSS, Reddit cross-posts)
+- Front page generates 150+ new backlinks
+- 58-68% of HN users block analytics (actual traffic is 1.5-2x what GA reports)
+
+## Infrastructure Checklist
+- [ ] Caching configured on all major routes
+- [ ] CDN enabled for static assets
+- [ ] Homepage handles 300+ concurrent users
+- [ ] Server response time < 200ms under load
+- [ ] Images optimized (next-gen formats)
+- [ ] Monitoring and error tracking active
+- [ ] Know your hosting bandwidth limits
+
+## Launch Checklist
+- [ ] Title is factual, no marketing, starts with "Show HN:"
+- [ ] First comment written and ready to paste immediately
+- [ ] Live demo works without signup
+- [ ] Pricing page is transparent
+- [ ] 4+ hours blocked for comment engagement
+- [ ] Checked /newest before posting (less competition = more discovery time)
+- [ ] Targeting Sunday ~12:00 UTC or weekday 11:00-14:00 UTC