Initial commit

This commit is contained in:
Zhongwei Li
2025-11-29 18:49:48 +08:00
commit 119567fa3e
11 changed files with 3629 additions and 0 deletions

View File

@@ -0,0 +1,12 @@
{
"name": "technical-launch-planner",
"description": "Plan and execute technical product launches for developer tools, APIs, and technical products. Use this skill when technical PMMs need to 'plan a launch', 'create a launch strategy', 'coordinate a product release', or 'prepare for GA/beta launch'.",
"version": "0.0.0-2025.11.28",
"author": {
"name": "James Rochabrun",
"email": "jamesrochabrun@gmail.com"
},
"skills": [
"./skills/technical-launch-planner"
]
}

3
README.md Normal file
View File

@@ -0,0 +1,3 @@
# technical-launch-planner
Plan and execute technical product launches for developer tools, APIs, and technical products. Use this skill when technical PMMs need to 'plan a launch', 'create a launch strategy', 'coordinate a product release', or 'prepare for GA/beta launch'.

72
plugin.lock.json Normal file
View File

@@ -0,0 +1,72 @@
{
"$schema": "internal://schemas/plugin.lock.v1.json",
"pluginId": "gh:jamesrochabrun/skills:technical-launch-planner",
"normalized": {
"repo": null,
"ref": "refs/tags/v20251128.0",
"commit": "feba23713af42c06a278a2b0c05d773a8728bbaa",
"treeHash": "062c22c1709877350133902c04543bd316e2d409bea9f193d82e781fa4bd4b40",
"generatedAt": "2025-11-28T10:17:55.932175Z",
"toolVersion": "publish_plugins.py@0.2.0"
},
"origin": {
"remote": "git@github.com:zhongweili/42plugin-data.git",
"branch": "master",
"commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390",
"repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data"
},
"manifest": {
"name": "technical-launch-planner",
"description": "Plan and execute technical product launches for developer tools, APIs, and technical products. Use this skill when technical PMMs need to 'plan a launch', 'create a launch strategy', 'coordinate a product release', or 'prepare for GA/beta launch'."
},
"content": {
"files": [
{
"path": "README.md",
"sha256": "c038341f31fcdbeefafb3ac5794347fc67ed1357b013357c0de3ab159b45e572"
},
{
"path": ".claude-plugin/plugin.json",
"sha256": "9299ed13cec89053fbf5cdf944b506294c19332ef815007594a7e9fd1cfe55e4"
},
{
"path": "skills/technical-launch-planner/SKILL.md",
"sha256": "a5fdea0fa0a9a1dd3a0905c1fd9461979d018f8b96be7dced3a3cf3080e5675a"
},
{
"path": "skills/technical-launch-planner/references/launch_tiers.md",
"sha256": "2b0fc71a8bc3b906e30b2039137e2540eaaef3b70480ebce2f4554e35163eb5a"
},
{
"path": "skills/technical-launch-planner/references/metrics_frameworks.md",
"sha256": "ac585ad2a7215c7cf39a1f520b5471fa1b04f45ce5c3acf4bd7c58c992820f59"
},
{
"path": "skills/technical-launch-planner/references/developer_enablement.md",
"sha256": "32cc9df87b5135e7ef6aa603e761a41adbdcaaf62acdbd09141c336a05d449fe"
},
{
"path": "skills/technical-launch-planner/references/launch_messaging.md",
"sha256": "230641f3a916bddf67238648385979495a538f2e15f132b85140a551ac526ef7"
},
{
"path": "skills/technical-launch-planner/scripts/generate_launch_plan.sh",
"sha256": "bc0f35bd5b89c0ea80abb47a4bd00dbcdadf5a8da2c353c2533913b8e953dd02"
},
{
"path": "skills/technical-launch-planner/scripts/validate_readiness.sh",
"sha256": "fa08672990591b10b304afac5ab4c446f22a67df4abc4b6b60c432da406f316d"
},
{
"path": "skills/technical-launch-planner/scripts/assess_launch_tier.sh",
"sha256": "01603b08d0908e3b7847c126fe5ba05211b78a144c64b2ed1b7451eb8697d9cd"
}
],
"dirSha256": "062c22c1709877350133902c04543bd316e2d409bea9f193d82e781fa4bd4b40"
},
"security": {
"scannedAt": null,
"scannerVersion": null,
"flags": []
}
}

View File

@@ -0,0 +1,798 @@
---
name: technical-launch-planner
description: Plan and execute technical product launches for developer tools, APIs, and technical products. Use this skill when technical PMMs need to "plan a launch", "create a launch strategy", "coordinate a product release", or "prepare for GA/beta launch".
---
# Technical Launch Planner
## Overview
Plan and execute successful launches for technical products, developer tools, APIs, SDKs, and platforms. This skill provides frameworks, checklists, and templates specifically designed for technical audiences and developer-focused products.
**Built for:**
- Developer tools and platforms
- APIs and SDKs
- Technical infrastructure products
- B2D (Business-to-Developer) products
- SaaS with technical buyers
---
## Quick Start
### 1. Assess Your Launch Tier
Run the interactive assessment:
```bash
scripts/assess_launch_tier.sh
```
This determines if your launch is:
- **Tier 1** (Major/GA) - New product, major version, significant expansion
- **Tier 2** (Standard) - New features, integrations, regional expansion
- **Tier 3** (Minor) - Updates, improvements, small features
### 2. Generate Launch Plan
Create your comprehensive launch plan:
```bash
scripts/generate_launch_plan.sh
```
Provides structured plan with:
- Timeline and milestones
- Stakeholder responsibilities
- Developer enablement checklist
- Go-to-market activities
- Launch day playbook
### 3. Validate Readiness
Before launch, check readiness:
```bash
scripts/validate_readiness.sh
```
Validates:
- Documentation completeness
- Technical assets ready
- Stakeholder alignment
- Messaging finalized
- Metrics instrumentation
---
## Core Launch Framework
### Launch Tiers
Different launches require different levels of investment:
| Tier | Type | Examples | Investment |
|------|------|----------|------------|
| **Tier 1** | Major | GA launch, new product, major version | Full GTM, events, PR |
| **Tier 2** | Standard | New features, integrations, SDKs | Selective GTM, blog, docs |
| **Tier 3** | Minor | Updates, improvements, patches | Changelog, in-app |
See `references/launch_tiers.md` for complete framework.
---
## Developer-Focused Launch Components
### 1. Developer Enablement
**Critical for technical launches:**
**Documentation:**
- Getting started guide
- API reference
- Code samples
- Integration guides
- Migration guides (if applicable)
**Code Assets:**
- SDKs/client libraries
- Sample applications
- Starter templates
- Code snippets
**Developer Experience:**
- Sandbox/playground environment
- Interactive tutorials
- API explorer
- Debugging tools
See `references/developer_enablement.md` for complete checklist.
---
### 2. Technical Messaging
**Speak developer language:**
**Avoid:**
- Marketing jargon
- Vague benefits
- Non-technical superlatives
**Include:**
- Concrete technical details
- Performance metrics
- Code examples
- Architecture diagrams
- Integration patterns
See `references/launch_messaging.md` for templates.
---
### 3. Launch Channels for Developers
**Where developers discover new tools:**
**Primary:**
- Developer documentation
- GitHub/GitLab
- Developer blog
- API changelog
- Release notes
**Secondary:**
- Dev.to, Hacker News, Reddit
- Technical Twitter/X
- Discord/Slack communities
- YouTube (tutorials)
- Developer newsletters
**Tertiary:**
- Webinars/workshops
- Conferences
- Podcasts
- Case studies
---
## Launch Planning Workflow
### Phase 1: Planning (T-12 to T-8 weeks)
**Objectives:**
- Define launch tier
- Set success criteria
- Align stakeholders
- Create timeline
**Activities:**
1. **Launch Tier Assessment**
```bash
scripts/assess_launch_tier.sh
```
2. **Stakeholder Kickoff**
- Product/Engineering
- Developer Relations
- Sales Engineering
- Marketing/Comms
- Partners (if applicable)
3. **Define Success Metrics**
- Developer adoption metrics
- API usage/calls
- SDK downloads
- Documentation traffic
- Community engagement
4. **Create Launch Timeline**
```bash
scripts/generate_launch_plan.sh
```
---
### Phase 2: Build (T-8 to T-4 weeks)
**Objectives:**
- Create all launch assets
- Prepare documentation
- Build demos and samples
**Activities:**
**Documentation:**
- [ ] Getting started guide written
- [ ] API reference complete
- [ ] Integration guides ready
- [ ] Migration guide (if needed)
- [ ] Troubleshooting FAQ
**Code Assets:**
- [ ] SDKs built and tested
- [ ] Sample apps created
- [ ] Code snippets prepared
- [ ] Sandbox environment ready
**Marketing Assets:**
- [ ] Technical blog post written
- [ ] Demo video recorded
- [ ] Announcement email drafted
- [ ] Social media plan
- [ ] Press release (Tier 1)
**Sales Enablement:**
- [ ] Technical battlecard
- [ ] Demo script
- [ ] FAQ/objection handling
- [ ] Pricing materials
- [ ] Competitive positioning
---
### Phase 3: Prepare (T-4 to T-1 weeks)
**Objectives:**
- Review and refine all assets
- Train teams
- Pre-launch validation
**Activities:**
**Internal Enablement:**
- [ ] Sales team training
- [ ] Support team training
- [ ] Partner briefings
- [ ] Internal demo day
**External Prep:**
- [ ] Beta customers briefed
- [ ] Partners coordinated
- [ ] Developer advocates prepared
- [ ] Community moderators ready
**Technical Validation:**
```bash
scripts/validate_readiness.sh
```
**Pre-Launch Checklist:**
- [ ] All docs published to staging
- [ ] SDKs tagged and ready
- [ ] Demo environment tested
- [ ] Monitoring/analytics configured
- [ ] Support escalation path defined
---
### Phase 4: Launch (Launch Day)
**Launch Day Playbook:**
**Morning (9 AM):**
- [ ] Publish documentation
- [ ] Release SDKs/packages
- [ ] Deploy blog post
- [ ] Send announcement email
- [ ] Post to social media
- [ ] Update website/product pages
**Midday (12 PM):**
- [ ] Monitor metrics dashboard
- [ ] Respond to community questions
- [ ] Share to external communities
- [ ] Engage with social mentions
**Afternoon (3 PM):**
- [ ] Post to Hacker News/Reddit (if Tier 1)
- [ ] Developer advocate content
- [ ] Partner announcements
**End of Day:**
- [ ] Day 1 metrics report
- [ ] Team debrief
- [ ] Issue triage
---
### Phase 5: Post-Launch (T+1 week to T+4 weeks)
**Objectives:**
- Monitor adoption
- Gather feedback
- Iterate on messaging
- Report results
**Activities:**
**Week 1:**
- [ ] Daily metrics monitoring
- [ ] Community Q&A
- [ ] Bug fixes prioritized
- [ ] Feedback synthesis
**Week 2:**
- [ ] First adoption metrics
- [ ] Customer feedback interviews
- [ ] Documentation updates
- [ ] Follow-up content
**Week 4:**
- [ ] Launch retrospective
- [ ] Success metrics report
- [ ] Lessons learned doc
- [ ] Update launch playbook
---
## Launch Tier Details
### Tier 1: Major Launch
**When:**
- New product GA
- Major version release (v2.0, v3.0)
- Significant platform expansion
- Game-changing feature
**Timeline:** 12-16 weeks
**Investment:**
- Full cross-functional GTM
- PR/media outreach
- Developer events
- Partner coordination
- Paid promotion
**Deliverables:**
- Complete documentation
- Multiple SDKs
- Sample applications
- Video tutorials
- Interactive demos
- Press release
- Analyst briefings
- Launch event/webinar
- Partner co-marketing
---
### Tier 2: Standard Launch
**When:**
- New features
- New integrations
- Additional SDKs
- Regional expansion
**Timeline:** 6-8 weeks
**Investment:**
- Selective GTM activities
- Blog and social
- Email to developer list
- Documentation updates
**Deliverables:**
- Feature documentation
- Code samples
- Blog post
- Demo video
- Email announcement
- Social media
- Changelog entry
---
### Tier 3: Minor Launch
**When:**
- Incremental improvements
- Bug fixes
- Performance enhancements
- Small feature additions
**Timeline:** 2-4 weeks
**Investment:**
- Minimal marketing
- Documentation only
- Changelog
**Deliverables:**
- Release notes
- Updated docs
- Changelog entry
- In-app notification (if applicable)
---
## Developer Launch Best Practices
### 1. Documentation First
**Launch is NOT ready without:**
- ✅ Getting started guide
- ✅ API reference
- ✅ At least 3 code samples
- ✅ Integration guide
**Developer rule:** "If it's not documented, it doesn't exist"
---
### 2. Show, Don't Tell
**Developers want to see code:**
**Good:**
```python
# Initialize the SDK
import acme_sdk
client = acme_sdk.Client(api_key="your_key")
result = client.widgets.create(name="My Widget")
print(result.id)
```
**Bad:**
"Our SDK makes it easy to create widgets with just a few lines of code"
---
### 3. Interactive > Passive
**Engagement hierarchy:**
1. 🥇 Interactive tutorial/playground
2. 🥈 Live demo
3. 🥉 Demo video
4. ❌ Static screenshots
---
### 4. Honest Technical Communication
**Developers appreciate:**
- Limitations clearly stated
- Performance characteristics
- Pricing transparency
- Migration complexity
- Breaking changes
**Developers hate:**
- Overpromising
- Hidden limitations
- Surprise breaking changes
- Vendor lock-in
---
### 5. Community-First Approach
**Engage where developers are:**
- Answer questions on Stack Overflow
- Be active in GitHub discussions
- Respond on Hacker News
- Join relevant Discord/Slack
- Participate in Reddit AMAs
**Don't:**
- Spam communities
- Ignore negative feedback
- Delete critical comments
- Only show up for launches
---
## Technical Metrics
### Developer Adoption Metrics
**Activation:**
- Sandbox/trial sign-ups
- First API call within 24 hours
- SDK downloads
- "Hello World" completions
**Engagement:**
- Daily/Weekly Active Developers
- API calls per developer
- Features adopted
- Integration depth
**Retention:**
- Day 7, 30, 90 developer retention
- Churn rate
- NPS (Developer)
See `references/metrics_frameworks.md` for complete guide.
---
## Launch Templates
### Technical Blog Post Template
```markdown
# Introducing [Feature/Product]
## The Problem
[Describe the developer pain point in technical detail]
## The Solution
[High-level technical overview]
## How It Works
[Technical architecture, with diagram]
## Getting Started
[Code sample showing basic usage]
## What's Next
[Roadmap tease]
[Link to full documentation]
```
---
### Launch Email Template
**Subject:** [Feature] is now available
**Body:**
```
Hi [Developer Name],
We're excited to announce [Feature] is now generally available.
What it does:
[One sentence technical description]
Why it matters:
[Developer benefit]
Get started in 5 minutes:
[Code snippet or quick start link]
Key resources:
- Documentation: [link]
- Sample code: [link]
- API reference: [link]
Questions? Reply to this email or join us in [Discord/Slack].
Happy building!
[Your Name]
```
---
### Changelog Entry Template
```markdown
## [Version] - YYYY-MM-DD
### Added
- [New feature]: [Technical description]
- Example: `client.newMethod(params)`
- [Link to docs]
### Changed
- [Breaking change]: [What changed and why]
- Migration guide: [link]
### Fixed
- [Bug fix]: [What was fixed]
### Deprecated
- [Feature]: [Timeline for removal]
```
---
## Partner/Integration Launches
### When You Have Partners
**Coordination needed:**
- Joint messaging
- Co-marketing plan
- Technical validation
- Mutual customer references
**Partner Enablement:**
- [ ] Technical integration tested
- [ ] Partner documentation
- [ ] Joint case study
- [ ] Co-branded assets
- [ ] Sales team training
**Launch Activities:**
- Co-authored blog posts
- Joint webinar
- Cross-promotion on social
- Email to both lists
- Mutual press release (Tier 1)
---
## Launch Retrospective
### Post-Launch Review (Within 30 days)
**Metrics Review:**
- Did we hit adoption targets?
- What was Day 1, Week 1, Month 1 usage?
- Developer sentiment (NPS, social, support)?
- Press/analyst coverage (if applicable)?
**What Worked:**
- Which channels drove most adoption?
- What content resonated?
- Which enablement assets were most used?
**What Didn't:**
- Where did developers get stuck?
- What documentation was missing?
- Which assumptions were wrong?
**Action Items:**
- Documentation improvements
- Messaging refinements
- Process improvements for next launch
**Template:** [Document in Notion/Confluence]
---
## Common Pitfalls
### Pitfall 1: Launching Without Complete Docs
**Problem:** "Docs will be ready soon" = Dead launch
**Solution:** Docs are non-negotiable. Delay launch if needed.
---
### Pitfall 2: Marketing-Speak for Developers
**Problem:** "Revolutionary", "Seamless", "Game-changing"
**Solution:** Use concrete technical language, metrics, code.
---
### Pitfall 3: Ignoring Migration Complexity
**Problem:** Breaking changes with no migration guide
**Solution:** Clear migration guide, migration tools, version support plan.
---
### Pitfall 4: Over-Indexing on Launch Day
**Problem:** All effort on Day 1, nothing for ongoing adoption
**Solution:** Plan 4-week post-launch content calendar.
---
### Pitfall 5: No Developer Feedback Loop
**Problem:** Launch and disappear
**Solution:** Active community engagement, regular office hours.
---
## Resources
### Scripts
- **assess_launch_tier.sh** - Determine appropriate launch tier
- **generate_launch_plan.sh** - Create comprehensive launch plan
- **validate_readiness.sh** - Pre-launch readiness check
### References
- **launch_tiers.md** - Complete launch tier framework
- **developer_enablement.md** - Developer enablement checklist
- **launch_messaging.md** - Technical messaging templates
- **metrics_frameworks.md** - Developer product metrics guide
---
## Real-World Examples
### Example 1: API GA Launch (Tier 1)
**Product:** New REST API for developer platform
**Timeline:** 12 weeks
**Key Activities:**
- Complete API documentation
- 5 SDKs (Python, Node, Ruby, Go, Java)
- Interactive API explorer
- 10+ sample applications
- Video tutorial series
- Developer webinar
- Blog post + case studies
- HN/Reddit launch
- Email to 50K developers
**Results:**
- 10K API keys issued Week 1
- 60% activation rate (first API call)
- 40% Day 7 retention
- #1 on Hacker News
---
### Example 2: New Integration (Tier 2)
**Product:** Integration with popular DevOps tool
**Timeline:** 6 weeks
**Key Activities:**
- Integration guide
- Sample workflow
- Blog post
- Partner co-marketing
- Demo video
- Email announcement
**Results:**
- 2K integration activations Month 1
- 25% of existing users tried it
- High engagement metric
---
### Example 3: SDK Update (Tier 3)
**Product:** New SDK version with performance improvements
**Timeline:** 2 weeks
**Key Activities:**
- Release notes
- Migration guide
- Changelog
- Tweet/X post
**Results:**
- 30% upgrade rate Week 1
- Minimal support burden
- Positive community feedback
---
## Summary
Technical launches require:
1. **Complete Documentation** - Non-negotiable
2. **Code Samples** - Show, don't tell
3. **Developer Enablement** - Make it easy to try
4. **Technical Credibility** - Speak the language
5. **Community Engagement** - Be where developers are
6. **Clear Metrics** - Measure what matters
7. **Post-Launch Commitment** - Launch is day 1, not the finish line
Use the scripts to streamline planning, follow the frameworks for consistency, and always put developers first.
**Get started:**
```bash
scripts/assess_launch_tier.sh
```

View File

@@ -0,0 +1,246 @@
# Developer Enablement Checklist
Comprehensive checklist for enabling developers to adopt your technical product.
---
## Critical: Documentation
### Getting Started Guide
- [ ] **Installation instructions** (< 5 minutes)
- [ ] **Quick start tutorial** (Hello World in < 10 minutes)
- [ ] **Basic concepts** explained
- [ ] **First successful API call** walkthrough
- [ ] **Authentication** setup guide
- [ ] **Common gotchas** documented
### API Reference
- [ ] **All endpoints** documented
- [ ] **Request/response examples** for each endpoint
- [ ] **Error codes** and meanings
- [ ] **Rate limits** clearly stated
- [ ] **Authentication** methods
- [ ] **Versioning** strategy explained
- [ ] **Changelog** maintained
### Integration Guides
- [ ] **Step-by-step** integration tutorials
- [ ] **Common use cases** covered
- [ ] **Best practices** documented
- [ ] **Performance tips**
- [ ] **Security considerations**
###Migration Guide (if applicable)
- [ ] **Breaking changes** highlighted
- [ ] **Migration steps** clear
- [ ] **Before/after code** examples
- [ ] **Timeline** for deprecations
- [ ] **Support** for old version
---
## Critical: Code Assets
### SDKs/Client Libraries
- [ ] **Python** SDK
- [ ] **JavaScript/Node** SDK
- [ ] **Additional languages** as needed
- [ ] **Well-documented** public APIs
- [ ] **Type definitions** (TypeScript, etc.)
- [ ] **Published** to package managers
- [ ] **Examples** in README
### Sample Applications
- [ ] **Simple** "Hello World" app
- [ ] **Realistic** integration example
- [ ] **Production-ready** template
- [ ] **README** with setup instructions
- [ ] **Runnable** locally
### Code Snippets
- [ ] **Common operations** (CRUD)
- [ ] **Authentication** examples
- [ ] **Error handling** patterns
- [ ] **Copy-paste** ready
- [ ] **Multiple languages**
---
## Important: Developer Experience
### Interactive Tools
- [ ] **API explorer** / playground
- [ ] **Interactive tutorials**
- [ ] **Sandbox environment** (no credit card)
- [ ] **Test mode** / mock data
- [ ] **Debugging tools**
### Developer Portal
- [ ] **Dashboard** for API keys
- [ ] **Usage analytics**
- [ ] **Billing/quota** visibility
- [ ] **Team management**
- [ ] **Support access**
### Testing & Debugging
- [ ] **Test credentials** available
- [ ] **Webhook testing** tools
- [ ] **Request logs** accessible
- [ ] **Error debugging** guides
- [ ] **Postman collection** (if REST API)
---
## Important: Learning Resources
### Video Content
- [ ] **Demo video** (3-5 minutes)
- [ ] **Tutorial series** for key features
- [ ] **Architecture overview** video
- [ ] **Best practices** video
### Written Tutorials
- [ ] **Blog posts** for common use cases
- [ ] **Integration tutorials**
- [ ] **Performance optimization** guides
- [ ] **Security best practices**
### Community Resources
- [ ] **FAQ** section
- [ ] **Troubleshooting** guide
- [ ] **Community forum** / Discord / Slack
- [ ] **Stack Overflow** tag
- [ ] **GitHub Discussions** enabled
---
## Important: Technical Specifications
### Architecture Documentation
- [ ] **System architecture** diagram
- [ ] **Data flow** diagrams
- [ ] **Sequence diagrams** for complex flows
- [ ] **Infrastructure** overview
- [ ] **Scaling** characteristics
### Performance & Limits
- [ ] **Rate limits** documented
- [ ] **Latency expectations** (p50, p95, p99)
- [ ] **Throughput** capabilities
- [ ] **Quotas** and limits
- [ ] **SLA** commitments
### Security Documentation
- [ ] **Authentication** methods
- [ ] **Authorization** model
- [ ] **Data encryption** (at rest, in transit)
- [ ] **Compliance** certifications
- [ ] **Security best practices**
- [ ] **Vulnerability** reporting process
---
## Nice to Have: Advanced Resources
### Reference Architectures
- [ ] **Common patterns** documented
- [ ] **Production deployment** examples
- [ ] **Multi-region** setups
- [ ] **High availability** configurations
### Integrations
- [ ] **Third-party** tool integrations
- [ ] **Framework** specific guides (React, Vue, etc.)
- [ ] **CI/CD** integration examples
- [ ] **Monitoring** integration guides
### Developer Tools
- [ ] **CLI** tool
- [ ] **Browser extensions**
- [ ] **IDE plugins** (VS Code, etc.)
- [ ] **Linters** / code validators
---
## Launch Day Specific
### Pre-Launch
- [ ] **Beta testers** given early access
- [ ] **Documentation** live on staging
- [ ] **SDKs** tagged and ready
- [ ] **Samples** tested end-to-end
### Launch Day
- [ ] **Docs** published to production
- [ ] **SDKs** released to package managers
- [ ] **Samples** available on GitHub
- [ ] **Playground** accessible
- [ ] **Support** channels staffed
### Post-Launch
- [ ] **Monitor** documentation traffic
- [ ] **Respond** to questions quickly
- [ ] **Update** docs based on feedback
- [ ] **Create** additional resources as needed
---
## Quality Checks
### Documentation Quality
- [ ] **Tested** by someone unfamiliar with product
- [ ] **Code samples** all execute successfully
- [ ] **Links** all work
- [ ] **Screenshots** up-to-date
- [ ] **Grammar/spelling** checked
- [ ] **Search** functionality works
- [ ] **Mobile** responsive
### Code Quality
- [ ] **SDKs** have tests
- [ ] **Sample apps** run without errors
- [ ] **Dependencies** up-to-date
- [ ] **Security** vulnerabilities checked
- [ ] **Licenses** clearly stated
---
## By Audience
### Beginner Developers
- Clear getting started
- Simple examples
- Video tutorials
- Interactive playground
- Active community support
### Experienced Developers
- Comprehensive API reference
- Advanced use cases
- Performance documentation
- Architecture details
- Migration guides
### Enterprise/Teams
- Security documentation
- Compliance information
- Team management docs
- SSO integration
- SLA details
---
## Measurement
Track these metrics post-launch:
- **Documentation traffic**
- **Time to first API call**
- **Sandbox activation rate**
- **SDK download count**
- **Sample app clones**
- **Support ticket volume**
- **Community questions**
- **Tutorial completion rate**
Use data to improve enablement continuously.

View File

@@ -0,0 +1,436 @@
# Technical Launch Messaging
Messaging frameworks and templates for developer-focused product launches.
---
## Messaging Principles for Developers
### DO:
-**Be specific** - Use concrete technical details
-**Show code** - Developers want to see, not read
-**State limitations** - Honest about what it can't do
-**Provide metrics** - Performance numbers, benchmarks
-**Explain why** - Technical reasoning matters
-**Link to docs** - Make it easy to try
### DON'T:
-**Use marketing jargon** - "Revolutionary", "game-changing"
-**Oversimplify** - Developers can handle complexity
-**Hide limitations** - They'll find them anyway
-**Make unsubstantiated claims** - Back it up with data
-**Skip code examples** - Abstract descriptions fail
---
## Messaging Framework
### Problem Statement
**Format:** [Current pain point] → [Why existing solutions fail] → [Impact on developers]
**Example:**
"Debugging distributed systems is painful. Traditional logging tools weren't built for microservices, forcing developers to manually correlate logs across dozens of services. This turns a 5-minute bug into a 5-hour investigation."
---
### Solution Overview
**Format:** [What it is] → [How it works (technical)] → [Key benefit]
**Example:**
"Distributed Tracer automatically instruments your services to create a unified view of requests across your entire stack. Using OpenTelemetry standards, it correlates logs, metrics, and traces in real-time, reducing MTTR by 80%."
---
### Key Differentiators
**Format:** [Feature] → [Technical implementation] → [Why it matters]
**Example:**
"Zero-config auto-instrumentation. Our SDK uses bytecode injection to automatically trace all HTTP calls, database queries, and external APIs without code changes. Deploy in under 5 minutes instead of days."
---
## Launch Announcement Template
### Blog Post Structure
```markdown
# Introducing [Product]: [One-line value prop]
## TL;DR
- [Key point 1 with metric]
- [Key point 2 with metric]
- [Get started link]
## The Problem
[Describe the developer pain in detail. Be specific.]
**Example:**
Every API call in a distributed system touches 5-10 services. When something breaks, you're left grep'ing through gigabytes of logs, trying to piece together what happened. We've all been there.
## The Solution
[High-level overview]
**How it works:**
\`\`\`python
# Show concrete code example
import tracer
tracer.init(api_key="your_key")
# That's it. All requests automatically traced.
\`\`\`
## Key Features
### 1. [Feature Name]
**What it does:** [Technical description]
**Why it matters:** [Developer benefit]
**Example:**
\`\`\`[language]
[Code showing the feature]
\`\`\`
[Repeat for top 3-5 features]
## Performance
[Include benchmarks, metrics]
- Latency: < 1ms overhead (p99)
- Throughput: 100K traces/second per instance
- Storage: 90-day retention included
## Get Started in 5 Minutes
\`\`\`bash
# Installation
npm install @company/sdk
# Basic setup
[Minimal code to get value]
\`\`\`
[Link to full documentation]
## What's Next
[Roadmap tease for 1-2 upcoming features]
## Resources
- [Documentation]
- [Sample apps]
- [API reference]
- [Community Discord]
```
---
## Email Announcement Template
**Subject Lines (A/B test these):**
- "[Product] is now GA - [Key benefit]"
- "Ship faster with [Product]"
- "[Pain point solved]: Introducing [Product]"
**Body:**
```
Hi [Name],
We're excited to announce [Product] is now generally available.
What it does:
[One sentence technical description]
Why it matters to you:
[Specific benefit for recipient's role/tech stack]
Get started in 5 minutes:
```[language]
[Minimal code example]
```
Key features:
• [Feature 1 - one line]
• [Feature 2 - one line]
• [Feature 3 - one line]
Resources:
→ Documentation: [link]
→ Sample code: [link]
→ API reference: [link]
[If Beta]: As a beta user, you already have access. Check your dashboard to enable.
Questions? Hit reply or join us in [Discord/Slack].
Happy building,
[Name]
[Title]
P.S. [Call to action or incentive]
```
---
## Social Media Templates
### Twitter/X (Technical)
**Format 1: Problem → Solution**
```
Tired of [pain point]?
[Product] gives you [benefit]:
• [Feature 1]
• [Feature 2]
• [Feature 3]
Get started: [link]
[Include code snippet image or architecture diagram]
```
**Format 2: Show the Code**
```
This is all it takes to [achieve outcome]:
[Code snippet image]
Try it now: [link]
#developer #[tech stack]
```
**Format 3: Metrics**
```
We just reduced distributed tracing overhead from 5ms to < 1ms.
How? [Link to technical blog post]
Open-sourced the approach: [GitHub link]
```
### LinkedIn (Business + Technical)
**Format:**
```
[Company] is launching [Product] today.
The problem we're solving:
[2-3 sentences about developer pain]
Our approach:
[Technical differentiation]
Early results from beta:
• [Metric/testimonial 1]
• [Metric/testimonial 2]
If you're working on [use case], check it out: [link]
[Include demo video or architecture diagram]
```
### Hacker News Post
**Title Format:**
- "Show HN: [Product] [One-line description]"
- "[Product] [Interesting technical approach]"
**Comment (required):**
```
Hey HN! Creator here.
We built [Product] to solve [problem we experienced].
Technical approach:
[2-3 paragraphs explaining interesting technical decisions]
What's different:
[Why this approach vs. alternatives]
How to try it:
[Quick start instructions]
Happy to answer questions!
```
---
## Positioning Statements
### General Template
"For [target developers] who [need/pain point], [Product] is a [category] that [key benefit]. Unlike [alternatives], we [unique differentiation]."
### Examples
**API Tool:**
"For backend developers who need reliable API integrations, FastAPI Connect is an API orchestration platform that auto-retries, caches, and monitors all external calls. Unlike building retry logic yourself, we provide production-grade reliability out of the box."
**Developer Platform:**
"For platform teams building internal developer platforms, DevHub is a self-service portal that gives developers one-click access to infrastructure. Unlike traditional ticketing systems, we automate provisioning in seconds instead of days."
---
## Value Propositions by Persona
### Backend Developers
**Focus:** Performance, reliability, ease of integration
"Reduce latency by 40% with one line of code"
### DevOps/SRE
**Focus:** Reliability, observability, automation
"Cut MTTR from hours to minutes with automated root cause analysis"
### Engineering Leaders
**Focus:** Productivity, costs, team velocity
"Ship 2x faster by eliminating [bottleneck]"
### Security Teams
**Focus:** Compliance, security, visibility
"SOC 2 Type II compliant with built-in audit logging"
---
## Messaging by Launch Tier
### Tier 1 (Major Launch)
- **Bold claims** backed by data
- **Vision** for the future
- **Ecosystem** impact
- **Industry** transformation
**Example:**
"Redefining how developers build distributed systems"
### Tier 2 (Standard)
- **Practical benefits**
- **Specific use cases**
- **Integration** value
- **Productivity** gains
**Example:**
"The fastest way to add real-time features to your app"
### Tier 3 (Minor)
- **Specific improvement**
- **Developer benefit**
- **Clear changelog**
**Example:**
"Python SDK now 3x faster with async support"
---
## Competitive Positioning
### When to Mention Competitors
**DO mention when:**
- You have clear technical superiority
- Migration is a key use case
- Comparison requested by prospects
**DON'T mention when:**
- You're the market leader
- Competitor is much larger
- Claim isn't defensible
### Competitive Messaging Template
"Unlike [Competitor], [Product] [specific advantage]:
**[Competitor]:**
- [Limitation 1]
- [Limitation 2]
**[Product]:**
- [Advantage 1] - [metric]
- [Advantage 2] - [metric]
[Code comparison or performance benchmark]"
---
## Technical Credibility Signals
Include these to build trust:
- **Open source** components used
- **Standards** supported (OpenTelemetry, OAuth, etc.)
- **Scale** handled (requests/sec, data volume)
- **Customers** using in production (if allowed)
- **Team background** (ex-Google, ex-AWS, etc.)
- **Security** certifications (SOC 2, ISO 27001)
- **Performance** benchmarks
- **GitHub** stars (if applicable)
---
## Avoiding Common Mistakes
### Mistake 1: Too Abstract
**Bad:** "Simplify your workflow"
**Good:** "Reduce deployment time from 45 minutes to 2 minutes"
### Mistake 2: Jargon Overload
**Bad:** "Leverage synergistic paradigms"
**Good:** "Run the same code on AWS, GCP, and Azure"
### Mistake 3: No Proof
**Bad:** "The fastest API"
**Good:** "p99 latency < 50ms (see benchmark: [link])"
### Mistake 4: Feature List
**Bad:** "Includes caching, retries, and monitoring"
**Good:** "Auto-retry failed requests up to 3x with exponential backoff"
### Mistake 5: Ignoring Migration
**Bad:** [No mention of existing solutions]
**Good:** "Migrate from [Competitor] in under 1 hour: [guide]"
---
## Testing Your Messaging
### Internal Test
- [ ] Can a new engineer explain the value?
- [ ] Do engineers volunteer to use it?
- [ ] Does it pass the "so what?" test?
### External Test
- [ ] Beta feedback positive?
- [ ] Clear from HN/Reddit comments?
- [ ] Low support questions about "what is it?"
### Metrics to Watch
- Email open rate (> 25% good for developer emails)
- Click-through rate to docs (> 10%)
- Sign-up conversion (depends on product)
- Social engagement (shares, comments)
- Media pickup (for Tier 1)
---
## Summary
**Technical messaging succeeds when:**
1. Problem is relatable
2. Solution is clear (with code)
3. Benefits are concrete
4. Limitations are honest
5. Getting started is easy
**Keep developer-first always.**

View File

@@ -0,0 +1,553 @@
# Launch Tier Framework
Complete guide to determining and executing different launch tiers for technical products.
---
## Overview
Not all launches are created equal. The launch tier framework helps you allocate the right resources and effort based on the scope and impact of what you're launching.
**Key Principle:** Match investment to impact.
---
## The Three Tiers
| Tier | Type | Investment | Timeline | Example |
|------|------|------------|----------|---------|
| **Tier 1** | Major | Full GTM | 12-16 weeks | New product GA, v2.0 |
| **Tier 2** | Standard | Selective GTM | 6-8 weeks | New feature, integration |
| **Tier 3** | Minor | Minimal GTM | 2-4 weeks | Update, improvement |
---
## Tier 1: Major Launch
### When to Use
- **New product GA** (General Availability)
- **Major version release** (v2.0, v3.0)
- **Platform expansion** (new capabilities)
- **Game-changing feature** (industry first)
- **New market entry**
### Characteristics
**Scope:**
- Impacts all or most users
- New revenue stream potential
- Significant competitive differentiation
- Industry-level interest expected
- Major technical undertaking
**Timeline:** 12-16 weeks
**Budget:** $50K-$500K+ depending on company size
---
### Deliverables
#### Documentation (Complete Set)
- [ ] Getting started guide
- [ ] Complete API reference
- [ ] Integration guides (3+)
- [ ] Migration guide
- [ ] Best practices guide
- [ ] Troubleshooting guide
- [ ] Video tutorial series (5+ videos)
- [ ] Architecture documentation
#### Code Assets
- [ ] Multiple SDKs (3+ languages)
- [ ] Sample applications (3+ different use cases)
- [ ] Starter templates
- [ ] Code snippet library
- [ ] Interactive playground/sandbox
- [ ] CLI tools (if applicable)
#### Marketing Assets
- [ ] Launch blog post (long-form)
- [ ] Product page redesign
- [ ] Demo video (professional)
- [ ] Case studies (2-3)
- [ ] Infographic/visual assets
- [ ] Explainer video
- [ ] Social media campaign
- [ ] Email nurture series
#### PR & Communications
- [ ] Press release
- [ ] Media kit
- [ ] Analyst briefings (Gartner, Forrester)
- [ ] Press tour
- [ ] Spokesperson training
- [ ] Crisis communication plan
#### Sales Enablement
- [ ] Technical battlecard
- [ ] Competitive analysis
- [ ] Demo script (detailed)
- [ ] ROI calculator
- [ ] Customer presentation deck
- [ ] Pricing/packaging materials
- [ ] FAQ (20+ questions)
#### Events
- [ ] Launch event/webinar
- [ ] Customer workshops
- [ ] Conference talks
- [ ] Community meetups
---
### Launch Channels
**Primary:**
- Developer documentation (hero banner)
- Company blog (featured)
- Email (entire developer base)
- Social media (coordinated campaign)
- Product Hunt launch
- Hacker News announcement
- Press release distribution
**Secondary:**
- Tech press outreach (TechCrunch, VentureBeat, etc.)
- Developer communities (Reddit, Dev.to)
- YouTube (demo + tutorials)
- Podcasts (interviews)
- Webinars
- Virtual events
**Tertiary:**
- Conference presentations
- Industry publications
- Analyst reports
- Partner co-marketing
- Influencer outreach
---
### Team & Resources
**Core Launch Team:**
- Product Marketing Lead
- Product Manager
- Engineering Lead
- Developer Relations
- Sales Engineering
- PR/Communications
- Content Marketing
- Design
- Legal/Compliance
**External Resources:**
- PR agency
- Video production
- Event planning
- Analyst relations
**Time Commitment:**
- PMM: 100% for 8+ weeks
- PM: 50%
- Eng: 25% (docs, demos)
- DevRel: 75%
---
### Success Metrics (Tier 1)
**Week 1:**
- 10K+ API keys / sign-ups
- 50%+ activation rate
- 1M+ webpage views
- 100K+ social impressions
- 10+ press mentions
**Month 1:**
- 25K+ active developers
- 40%+ Day 7 retention
- 5%+ paid conversion (if applicable)
- NPS > 40
**Quarter 1:**
- 50K+ active developers
- $X ARR (if revenue product)
- 3+ case studies published
- Industry recognition (awards, mentions)
---
### Budget Breakdown (Example)
| Item | Cost Range |
|------|------------|
| PR Agency | $20K-$50K |
| Video Production | $10K-$30K |
| Event/Webinar | $15K-$40K |
| Paid Promotion | $25K-$100K |
| Analyst Relations | $10K-$30K |
| Design Assets | $5K-$15K |
| Tools/Software | $5K-$10K |
| **Total** | **$90K-$275K** |
---
## Tier 2: Standard Launch
### When to Use
- **New feature** (significant but not transformative)
- **Integration** with popular tool
- **SDK** for new language
- **Regional expansion**
- **Beta to GA** transition
### Characteristics
**Scope:**
- Impacts segment of users (25-75%)
- Moderate revenue impact
- Some competitive differentiation
- Developer community interest
- Moderate technical complexity
**Timeline:** 6-8 weeks
**Budget:** $10K-$50K
---
### Deliverables
#### Documentation
- [ ] Feature guide
- [ ] API reference updates
- [ ] Code samples (3-5)
- [ ] Integration tutorial
- [ ] Migration guide (if applicable)
- [ ] Video demo (1-2)
#### Code Assets
- [ ] SDK (if new language)
- [ ] Sample application (1-2)
- [ ] Code snippets
- [ ] Sandbox example
#### Marketing Assets
- [ ] Launch blog post
- [ ] Product page update
- [ ] Demo video
- [ ] Email template
- [ ] Social media posts
- [ ] Changelog entry (detailed)
#### Sales Enablement
- [ ] Feature overview (1-pager)
- [ ] Demo talking points
- [ ] FAQ (10+ questions)
- [ ] Competitive comparison
---
### Launch Channels
**Primary:**
- Developer blog
- Email (targeted segment)
- Changelog (featured)
- Social media
- In-product notification
**Secondary:**
- Developer newsletter
- Community forums
- YouTube demo
- Partner channels (if applicable)
**Optional:**
- Dev.to article
- Reddit post (relevant subreddits)
- Product Hunt (if major feature)
---
### Team & Resources
**Core Team:**
- Product Marketing Lead
- Product Manager
- Developer Relations
- Engineering (docs)
- Content Writer
**Time Commitment:**
- PMM: 75% for 4 weeks
- PM: 25%
- Eng: 10% (docs)
- DevRel: 40%
---
### Success Metrics (Tier 2)
**Week 1:**
- 2K+ feature adoptions
- 1K+ email opens
- 50K+ blog views
**Month 1:**
- 5K+ active users
- 25%+ engagement rate
- NPS > 30
---
### Budget (Example)
| Item | Cost |
|------|------|
| Video Production | $3K-$8K |
| Design Assets | $2K-$5K |
| Email Platform | $500 |
| Paid Promotion (optional) | $5K-$15K |
| **Total** | **$10.5K-$28.5K** |
---
## Tier 3: Minor Launch
### When to Use
- **Incremental improvements**
- **Bug fixes** (significant ones)
- **Performance enhancements**
- **Small feature** additions
- **UI/UX updates**
- **Deprecation** notices
### Characteristics
**Scope:**
- Impacts small segment (<25%)
- Minimal revenue impact
- No competitive angle
- Low external interest
- Simple technical change
**Timeline:** 2-4 weeks
**Budget:** $1K-$5K
---
### Deliverables
#### Documentation
- [ ] Release notes
- [ ] Documentation updates
- [ ] Changelog entry
#### Marketing Assets
- [ ] Short blog post or announcement
- [ ] Email (optional)
- [ ] Social media post (single)
---
### Launch Channels
**Primary:**
- Changelog
- Release notes
- Documentation
**Secondary (optional):**
- Short blog post
- Email mention
- Social media (single post)
- In-product notification
---
### Team & Resources
**Minimal Team:**
- Product Manager or PMM
- Engineering (docs)
**Time Commitment:**
- PM/PMM: 25% for 1 week
- Eng: 5% (docs)
---
### Success Metrics (Tier 3)
**Week 1:**
- Documentation viewed
- Feature adopted by target users
- No support spikes
**Month 1:**
- 10-20% of eligible users adopt
- Positive sentiment
---
### Budget
Typically < $5K, mostly internal time.
---
## Decision Framework
### Scoring System
Use the `assess_launch_tier.sh` script or manually score:
**Score Components:**
1. **Type of Launch** (0-10 points)
- New product/GA: 10
- Major version: 8
- New feature: 5
- Improvement: 2
- Bug fix: 0
2. **User Impact** (0-10 points)
- All users (100%): 10
- Most users (50-99%): 7
- Segment (25-50%): 5
- Small segment (<25%): 2
- Beta only: 1
3. **Revenue Impact** (0-10 points)
- New revenue stream: 10
- Major driver: 7
- Moderate: 4
- Minor: 2
- None: 0
4. **Competitive Differentiation** (0-8 points)
- Industry first: 8
- Significant: 6
- Some: 4
- Parity: 1
- None: 0
5. **Technical Complexity** (0-7 points)
- New platform: 7
- Significant: 5
- Moderate: 3
- Simple: 1
- Minor: 0
6. **Documentation Needs** (0-6 points)
- Complete new set: 6
- Major updates: 5
- New guides: 3
- Updates: 1
- Release notes only: 0
7. **External Interest** (0-7 points)
- High (industry news): 7
- Moderate (tech press): 5
- Some (community): 3
- Low (niche): 1
- Minimal: 0
**Total Score: 0-58**
**Tier Assignment:**
- **40-58:** Tier 1 (Major)
- **20-39:** Tier 2 (Standard)
- **0-19:** Tier 3 (Minor)
---
## Common Scenarios
### Scenario 1: API GA Launch
**Type:** New product
**Users:** All (new audience)
**Revenue:** New stream
**Competitive:** Industry first capability
**Technical:** New platform
**Docs:** Complete set
**Interest:** High
**Score:** 52 → **Tier 1**
---
### Scenario 2: New Language SDK
**Type:** New integration
**Users:** Segment (e.g., Python devs)
**Revenue:** Moderate impact
**Competitive:** Parity
**Technical:** Moderate
**Docs:** New guide
**Interest:** Some
**Score:** 25 → **Tier 2**
---
### Scenario 3: Performance Update
**Type:** Improvement
**Users:** All
**Revenue:** None direct
**Competitive:** None
**Technical:** Simple
**Docs:** Updates
**Interest:** Low
**Score:** 12 → **Tier 3**
---
## Best Practices
### Right-Sizing
**Over-investing (Tier 3 as Tier 1):**
- Wastes resources
- Confuses users ("This isn't major")
- Diminishes future Tier 1 launches
**Under-investing (Tier 1 as Tier 3):**
- Misses opportunity
- Poor adoption
- Competitive disadvantage
### Flexibility
**Adjust tier based on:**
- Company stage (early vs. mature)
- Market position (leader vs. challenger)
- Resources available
- Strategic importance
### Communication
**Be explicit with stakeholders:**
- "This is a Tier 2 launch, so we'll do X but not Y"
- Set clear expectations upfront
- Document tier decision and reasoning
---
## Summary
Use launch tiers to:
1. **Match effort to impact**
2. **Set stakeholder expectations**
3. **Allocate resources efficiently**
4. **Maintain consistency**
5. **Maximize ROI**
**Remember:** A well-executed Tier 2 launch beats a poorly-executed Tier 1.

View File

@@ -0,0 +1,562 @@
# Developer Product Metrics
Comprehensive guide to measuring success for technical products, developer tools, and APIs.
---
## Why Developer Metrics Are Different
Developer products have unique characteristics:
- **High technical barriers** to adoption
- **Longer evaluation** periods
- **Community-driven** growth
- **Usage-based** pricing models
- **Quality over quantity** (one great developer > 100 casual users)
Traditional B2B SaaS metrics don't always apply directly.
---
## The Developer Funnel
```
Awareness → Interest → Evaluation → Activation → Engagement → Retention → Monetization
```
Each stage has specific metrics.
---
## 1. Awareness Metrics
### Top-of-Funnel
**Website Traffic:**
- Documentation page views
- Landing page visits
- Blog traffic
- GitHub repository views
**Search & Discovery:**
- Organic search rankings (for key terms)
- GitHub stars
- Stack Overflow mentions
- Social media mentions
**Community Presence:**
- Discord/Slack members
- Reddit subscribers
- Newsletter subscribers
- Conference attendance
**Targets (vary by company):**
- 50K monthly docs views (early stage)
- 500K monthly docs views (growth stage)
- 1K+ GitHub stars (open source component)
---
## 2. Interest Metrics
### Consideration Stage
**Engagement:**
- Time on documentation
- Pages per session
- Video views (tutorials)
- GitHub README views
**Content Consumption:**
- Blog post reads
- Tutorial completion rate
- Demo video watch time
- Webinar registrations
**Social Proof:**
- Case study views
- Customer testimonials read
- Comparison page visits
**Targets:**
- 5+ minute average session duration
- 4+ pages per session
- 50%+ video completion rate
---
## 3. Evaluation Metrics
### Trial/Sandbox Stage
**Sign-Up:**
- Developer sign-ups
- API key requests
- Sandbox activations
- Free tier activations
**Time to Value:**
- **Time to first API call** (target: < 10 minutes)
- **Time to "Hello World"** (target: < 15 minutes)
- **Time to integration** (target: < 1 hour)
**Documentation Engagement:**
- Getting started guide views
- Code sample copies
- SDK downloads
- Postman collection imports
**Targets:**
- 1K+ sign-ups per month (early stage)
- 60% make first API call within 24 hours
- 10 minutes median time to first call
---
## 4. Activation Metrics
### First Value Realized
**Critical Activation Events:**
- **First successful API call**
- **First integration deployed**
- **First production request**
- **SDK installed and used**
- **Sandbox → production migration**
**Activation Rate:**
```
Activation Rate = (Users who complete activation event) / (Total sign-ups)
```
**Depth of Activation:**
- Features explored
- Endpoints called
- SDKs used
- Integrations enabled
**Targets:**
- 50-70% activation rate (first API call)
- 30-40% activation rate (production deployment)
- 80%+ complete getting started guide
---
## 5. Engagement Metrics
### Active Usage
**Daily/Weekly/Monthly Active Developers (DAD/WAD/MAD):**
```
DAD = Unique developers making API calls daily
WAD = Unique developers active weekly
MAD = Unique developers active monthly
```
**Stickiness:**
```
Stickiness = DAD / MAD
```
- Target: > 20% (good)
- Target: > 40% (excellent)
**API Usage:**
- **Total API calls** per day/week/month
- **API calls per developer**
- **Endpoints used** per developer
- **Error rate** (target: < 1%)
**Feature Adoption:**
- % of developers using key features
- Time to feature adoption
- Feature depth (how many features per user)
**Targets:**
- 40%+ stickiness (DAD/MAD)
- 1K+ API calls per active developer per month
- < 1% error rate
- 3+ features adopted per developer
---
## 6. Retention Metrics
### Developer Retention
**Cohort Retention:**
```
Day 1 Retention = Developers active on Day 1 / Total sign-ups
Day 7 Retention = Developers active on Day 7 / Total sign-ups
Day 30 Retention = Developers active on Day 30 / Total sign-ups
```
**Typical Developer Product Retention:**
- Day 1: 60-70%
- Day 7: 30-50%
- Day 30: 20-40%
- Day 90: 15-30%
**Why Developer Retention Is Lower:**
- Evaluation period (many are just testing)
- Project-based usage (finish project, stop using)
- This is normal and expected
**Churn Rate:**
```
Monthly Churn = Developers who stopped using / Active developers at month start
```
**Resurrection Rate:**
```
Resurrection = Churned developers who return / Total churned developers
```
**Targets:**
- < 5% monthly churn (paid users)
- 40%+ Day 7 retention
- 25%+ Day 30 retention
---
## 7. Monetization Metrics
### Revenue Metrics
**Conversion Metrics:**
```
Free → Paid Conversion Rate = Paid users / Total active users
```
- Target: 3-10% (varies widely by product)
**Revenue Metrics:**
- **MRR** (Monthly Recurring Revenue)
- **ARR** (Annual Recurring Revenue)
- **ARPU** (Average Revenue Per User)
- **Net Revenue Retention** (NRR)
**Usage-Based Pricing Metrics:**
- **Average API calls per paid user**
- **Tier distribution** (how many in each pricing tier)
- **Upgrade rate** (free → paid, basic → pro)
- **Expansion revenue** (existing customers spending more)
**Targets:**
- 5%+ free-to-paid conversion
- 110%+ Net Revenue Retention
- $50-$500 ARPU (varies by product)
---
## Developer-Specific Metrics
### Code Quality Metrics
**SDK Quality:**
- **Downloads** per month
- **GitHub stars**
- **Issues opened** vs. closed
- **PR acceptance** rate
- **Time to resolve** issues
**Documentation Quality:**
- **Search success** rate (did they find what they needed?)
- **Time on page** (too short = unclear, too long = can't find)
- **Bounce rate** on docs
- **Feedback** (thumbs up/down on docs pages)
**Targets:**
- 90%+ search success rate
- < 40% bounce rate on docs
- 80%+ positive feedback on docs
---
### Developer Experience Metrics
**Time-Based:**
- Time to first API call
- Time to production
- Time to integrate
- Time to debug
**Friction Points:**
- Authentication failures
- API errors
- SDK install issues
- Documentation gaps
**Support Metrics:**
- Support tickets per MAD
- Time to first response
- Time to resolution
- Community forum response time
**Targets:**
- < 5 minutes to first API call
- < 1 support ticket per 100 MAD
- < 4 hours first response time
- 90%+ questions answered by community
---
## Developer Satisfaction
### Net Promoter Score (NPS)
Survey question: "How likely are you to recommend [product] to other developers?"
**Scale:** 0-10
**Calculation:**
```
NPS = % Promoters (9-10) - % Detractors (0-6)
```
**Developer Product Benchmarks:**
- **Excellent:** NPS > 50
- **Good:** NPS 30-50
- **Needs Work:** NPS < 30
### Developer Sentiment
**Qualitative Indicators:**
- Social media sentiment
- Community forum tone
- GitHub issue sentiment
- Review site ratings (G2, Capterra)
- Stack Overflow sentiment
**Quantitative Tracking:**
- Positive vs. negative mentions
- Sentiment score (automated analysis)
- Review ratings (1-5 stars)
---
## Launch-Specific Metrics
### Launch Day Metrics
**Day 1:**
- Sign-ups / API keys
- First API calls
- Documentation views
- Blog post views
- Social media impressions
- Email open rate
- Email click rate
**Targets (Tier 1 launch):**
- 5K+ sign-ups
- 50%+ activation rate (first call)
- 100K+ docs views
- 50K+ blog views
---
### Week 1 Metrics
- Total sign-ups
- Day 7 retention rate
- Active developers
- API calls made
- Support tickets
- Community questions
- Social mentions
**Targets (Tier 1):**
- 10K+ total sign-ups
- 40%+ Day 7 retention
- 5K+ active developers
- 1M+ API calls
- < 50 support tickets
---
### Month 1 Metrics
- Monthly Active Developers (MAD)
- Free → paid conversion
- NPS score
- Documentation coverage (no major gaps)
- Community health
- Feature adoption
**Targets (Tier 1):**
- 25K+ MAD
- 3-5% paid conversion
- NPS > 40
- 80%+ positive doc feedback
---
## Metrics Dashboard Template
### Executive Dashboard
**Adoption:**
- Total Developers: [X]
- MAD: [X]
- Growth Rate: [X%]
**Engagement:**
- DAD/MAD: [X%]
- API Calls/Day: [X]
- Error Rate: [X%]
**Retention:**
- Day 7: [X%]
- Day 30: [X%]
- Churn: [X%]
**Revenue:**
- MRR: $[X]
- ARPU: $[X]
- NRR: [X%]
**Quality:**
- NPS: [X]
- Support Tickets/MAD: [X]
---
### Product Team Dashboard
**This Week:**
- New Developers: [X]
- Activation Rate: [X%]
- Features Adopted: [X]
- Top API Endpoints: [List]
**Trends:**
- MAD (7-day trend): [Graph]
- API Calls (7-day): [Graph]
- Error Rate (7-day): [Graph]
**Health:**
- Documentation Gaps: [Count]
- Open Issues: [Count]
- P0 Bugs: [Count]
---
## Metric Collection
### Where to Track
**Product Analytics:**
- Amplitude
- Mixpanel
- Heap
- PostHog
**API Analytics:**
- Moesif
- API metrics (custom)
- CloudWatch / Datadog
**Documentation Analytics:**
- Google Analytics
- Readme.io analytics
- GitBook analytics
**Developer Feedback:**
- Intercom
- Zendesk
- Community forum analytics
- Survey tools (Delighted, SurveyMonkey)
---
## Setting Targets
### Early Stage (0-1 year)
Focus on **activation** and **engagement**:
- Sign-ups: 1K-10K/month
- Activation: 50%+
- MAD: 500-5K
- Day 7 Retention: 30%+
### Growth Stage (1-3 years)
Focus on **scale** and **retention**:
- Sign-ups: 10K-50K/month
- MAD: 10K-100K
- Day 30 Retention: 25%+
- Free→Paid: 5%+
### Mature Stage (3+ years)
Focus on **efficiency** and **expansion**:
- MAD: 100K+
- NRR: 110%+
- ARPU: Increasing
- CAC Payback: < 12 months
---
## Common Pitfalls
### Vanity Metrics
**Avoid:**
- Total registered users (most are inactive)
- Total API calls (could be from one user)
- GitHub stars alone (may not use product)
**Focus on:**
- Active users (making API calls)
- Retained users (coming back)
- Engaged users (using multiple features)
### Wrong Benchmarks
Don't compare developer product metrics to:
- B2C social apps (much higher DAU/MAU)
- Enterprise SaaS (lower volume, higher ACV)
- E-commerce (transactional, not sustained use)
Use developer product benchmarks instead.
---
## Summary: Key Metrics to Track
**Must Track:**
1. Monthly Active Developers (MAD)
2. Activation Rate (first API call)
3. Day 7 & Day 30 Retention
4. Stickiness (DAD/MAD)
5. API Error Rate
6. NPS
**Should Track:**
7. Free → Paid Conversion
8. Time to First API Call
9. Documentation Effectiveness
10. Support Ticket Volume
**Nice to Have:**
11. GitHub Stars/Activity
12. Community Engagement
13. Social Sentiment
14. Feature Adoption Depth
Start with the must-track metrics, then expand.
---
## Developer Metric Formulas
Quick reference:
```
Activation Rate = Activated Users / Sign-ups
Stickiness = DAD / MAD
Churn Rate = Users Lost / Total Users
NRR = (MRR + Expansion - Churn) / Starting MRR
LTV = ARPU / Churn Rate
CAC Payback = CAC / (ARPU * Gross Margin)
```
**Remember:** Metrics should drive action, not just reporting. If a metric doesn't change behavior, don't track it.

View File

@@ -0,0 +1,324 @@
#!/bin/bash
# Technical Launch Tier Assessment
# Helps determine the appropriate launch tier based on scope and impact
set -e
# Colors
GREEN='\033[0;32m'
BLUE='\033[0;34m'
YELLOW='\033[1;33m'
RED='\033[0;31m'
CYAN='\033[0;36m'
NC='\033[0m' # No Color
echo -e "${BLUE}╔════════════════════════════════════════════════╗${NC}"
echo -e "${BLUE}║ Technical Launch Tier Assessment ║${NC}"
echo -e "${BLUE}╚════════════════════════════════════════════════╝${NC}"
echo ""
echo -e "${CYAN}This assessment will help determine your launch tier.${NC}"
echo ""
# Scoring system
SCORE=0
# Question 1: What are you launching?
echo -e "${YELLOW}Question 1: What are you launching?${NC}"
echo " 1) New product/platform (GA)"
echo " 2) Major version update (v2.0, v3.0)"
echo " 3) New feature/integration"
echo " 4) Enhancement/improvement"
echo " 5) Bug fix/patch"
echo ""
read -p "Your answer (1-5): " Q1
case $Q1 in
1) SCORE=$((SCORE + 10));;
2) SCORE=$((SCORE + 8));;
3) SCORE=$((SCORE + 5));;
4) SCORE=$((SCORE + 2));;
5) SCORE=$((SCORE + 0));;
esac
echo ""
# Question 2: Target audience size
echo -e "${YELLOW}Question 2: How many developers/users will this impact?${NC}"
echo " 1) All users (100%)"
echo " 2) Most users (50-99%)"
echo " 3) Segment of users (25-50%)"
echo " 4) Small segment (<25%)"
echo " 5) Beta/limited group"
echo ""
read -p "Your answer (1-5): " Q2
case $Q2 in
1) SCORE=$((SCORE + 10));;
2) SCORE=$((SCORE + 7));;
3) SCORE=$((SCORE + 5));;
4) SCORE=$((SCORE + 2));;
5) SCORE=$((SCORE + 1));;
esac
echo ""
# Question 3: Revenue impact
echo -e "${YELLOW}Question 3: What's the revenue/business impact?${NC}"
echo " 1) New revenue stream"
echo " 2) Major revenue driver"
echo " 3) Moderate impact"
echo " 4) Minor impact"
echo " 5) No direct revenue impact"
echo ""
read -p "Your answer (1-5): " Q3
case $Q3 in
1) SCORE=$((SCORE + 10));;
2) SCORE=$((SCORE + 7));;
3) SCORE=$((SCORE + 4));;
4) SCORE=$((SCORE + 2));;
5) SCORE=$((SCORE + 0));;
esac
echo ""
# Question 4: Competitive differentiation
echo -e "${YELLOW}Question 4: Is this competitively differentiated?${NC}"
echo " 1) Industry first / unique capability"
echo " 2) Significant differentiation"
echo " 3) Some differentiation"
echo " 4) Parity feature"
echo " 5) No competitive angle"
echo ""
read -p "Your answer (1-5): " Q4
case $Q4 in
1) SCORE=$((SCORE + 8));;
2) SCORE=$((SCORE + 6));;
3) SCORE=$((SCORE + 4));;
4) SCORE=$((SCORE + 1));;
5) SCORE=$((SCORE + 0));;
esac
echo ""
# Question 5: Technical complexity
echo -e "${YELLOW}Question 5: How complex is this technically?${NC}"
echo " 1) New platform/architecture"
echo " 2) Significant technical undertaking"
echo " 3) Moderate complexity"
echo " 4) Simple feature"
echo " 5) Minor change"
echo ""
read -p "Your answer (1-5): " Q5
case $Q5 in
1) SCORE=$((SCORE + 7));;
2) SCORE=$((SCORE + 5));;
3) SCORE=$((SCORE + 3));;
4) SCORE=$((SCORE + 1));;
5) SCORE=$((SCORE + 0));;
esac
echo ""
# Question 6: Documentation/enablement needed
echo -e "${YELLOW}Question 6: What documentation/enablement is required?${NC}"
echo " 1) Complete new documentation set + SDKs"
echo " 2) Major documentation updates + samples"
echo " 3) New guides + code samples"
echo " 4) Documentation updates"
echo " 5) Release notes only"
echo ""
read -p "Your answer (1-5): " Q6
case $Q6 in
1) SCORE=$((SCORE + 6));;
2) SCORE=$((SCORE + 5));;
3) SCORE=$((SCORE + 3));;
4) SCORE=$((SCORE + 1));;
5) SCORE=$((SCORE + 0));;
esac
echo ""
# Question 7: External interest
echo -e "${YELLOW}Question 7: Expected external interest (press, analysts, community)?${NC}"
echo " 1) High (industry news)"
echo " 2) Moderate (tech press interest)"
echo " 3) Some (developer community)"
echo " 4) Low (niche interest)"
echo " 5) Minimal (internal mainly)"
echo ""
read -p "Your answer (1-5): " Q7
case $Q7 in
1) SCORE=$((SCORE + 7));;
2) SCORE=$((SCORE + 5));;
3) SCORE=$((SCORE + 3));;
4) SCORE=$((SCORE + 1));;
5) SCORE=$((SCORE + 0));;
esac
echo ""
# Calculate tier
echo -e "${BLUE}═══════════════════════════════════════════════${NC}"
echo -e "${CYAN}Analyzing your responses...${NC}"
echo ""
sleep 1
# Determine tier based on score
if [ $SCORE -ge 40 ]; then
TIER="Tier 1"
COLOR=$RED
TIMELINE="12-16 weeks"
INVESTMENT="Full GTM"
elif [ $SCORE -ge 20 ]; then
TIER="Tier 2"
COLOR=$YELLOW
TIMELINE="6-8 weeks"
INVESTMENT="Selective GTM"
else
TIER="Tier 3"
COLOR=$GREEN
TIMELINE="2-4 weeks"
INVESTMENT="Minimal GTM"
fi
# Display results
echo -e "${BLUE}╔════════════════════════════════════════════════╗${NC}"
echo -e "${BLUE}║ Assessment Results ║${NC}"
echo -e "${BLUE}╚════════════════════════════════════════════════╝${NC}"
echo ""
echo -e "Your Score: ${CYAN}$SCORE / 58${NC}"
echo -e "Launch Tier: ${COLOR}$TIER${NC}"
echo -e "Timeline: ${CYAN}$TIMELINE${NC}"
echo -e "Investment: ${CYAN}$INVESTMENT${NC}"
echo ""
# Tier-specific recommendations
echo -e "${BLUE}═══════════════════════════════════════════════${NC}"
echo -e "${COLOR}$TIER Recommendations:${NC}"
echo ""
if [ "$TIER" = "Tier 1" ]; then
echo -e "${YELLOW}Major Launch - Full GTM Treatment${NC}"
echo ""
echo "Required:"
echo " ✓ Complete documentation set"
echo " ✓ Multiple SDKs/client libraries"
echo " ✓ Sample applications"
echo " ✓ Video tutorials"
echo " ✓ Interactive demos/playground"
echo " ✓ Press release"
echo " ✓ Launch event/webinar"
echo " ✓ Partner coordination"
echo " ✓ Paid promotion"
echo " ✓ Analyst briefings"
echo ""
echo "Channels:"
echo " • Developer blog (launch post)"
echo " • Email (entire developer list)"
echo " • Social media (coordinated campaign)"
echo " • Hacker News / Reddit"
echo " • Tech press outreach"
echo " • Developer communities"
echo " • Conference talks"
echo ""
echo "Team involvement:"
echo " • Product Marketing (lead)"
echo " • Product Management"
echo " • Developer Relations"
echo " • Engineering"
echo " • Sales Engineering"
echo " • Partners"
echo " • PR/Comms"
echo ""
elif [ "$TIER" = "Tier 2" ]; then
echo -e "${YELLOW}Standard Launch - Selective GTM${NC}"
echo ""
echo "Required:"
echo " ✓ Feature documentation"
echo " ✓ Code samples"
echo " ✓ Blog post"
echo " ✓ Demo video"
echo " ✓ Email announcement"
echo " ✓ Updated API reference"
echo ""
echo "Channels:"
echo " • Developer blog"
echo " • Email (targeted segment)"
echo " • Social media"
echo " • Changelog"
echo " • Developer newsletter"
echo " • Relevant communities"
echo ""
echo "Team involvement:"
echo " • Product Marketing (lead)"
echo " • Developer Relations"
echo " • Product Management"
echo " • Engineering (docs)"
echo ""
else
echo -e "${GREEN}Minor Launch - Documentation Focus${NC}"
echo ""
echo "Required:"
echo " ✓ Release notes"
echo " ✓ Updated documentation"
echo " ✓ Changelog entry"
echo " ✓ In-app notification (if applicable)"
echo ""
echo "Channels:"
echo " • Changelog"
echo " • Documentation"
echo " • Social media (single post)"
echo " • Email (if significant)"
echo ""
echo "Team involvement:"
echo " • Product Marketing or PM"
echo " • Engineering (docs)"
echo ""
fi
echo -e "${BLUE}═══════════════════════════════════════════════${NC}"
echo ""
# Next steps
echo -e "${CYAN}Next Steps:${NC}"
echo ""
echo "1. Generate detailed launch plan:"
echo -e " ${YELLOW}scripts/generate_launch_plan.sh${NC}"
echo ""
echo "2. Review tier framework:"
echo -e " ${YELLOW}cat references/launch_tiers.md${NC}"
echo ""
echo "3. Check developer enablement checklist:"
echo -e " ${YELLOW}cat references/developer_enablement.md${NC}"
echo ""
# Save results
read -p "Save results to file? (y/n): " SAVE
if [[ "$SAVE" =~ ^[Yy]$ ]]; then
OUTPUT_FILE="launch_assessment_$(date +%Y%m%d_%H%M%S).txt"
{
echo "Technical Launch Tier Assessment"
echo "Date: $(date)"
echo ""
echo "Score: $SCORE / 58"
echo "Tier: $TIER"
echo "Timeline: $TIMELINE"
echo "Investment: $INVESTMENT"
echo ""
echo "Responses:"
echo "Q1: $Q1"
echo "Q2: $Q2"
echo "Q3: $Q3"
echo "Q4: $Q4"
echo "Q5: $Q5"
echo "Q6: $Q6"
echo "Q7: $Q7"
} > "$OUTPUT_FILE"
echo -e "${GREEN}✓ Results saved to: $OUTPUT_FILE${NC}"
fi
echo ""
echo -e "${GREEN}✓ Assessment complete!${NC}"

View File

@@ -0,0 +1,465 @@
#!/bin/bash
# Technical Launch Plan Generator
# Creates comprehensive launch plan document
set -e
# Colors
GREEN='\033[0;32m'
BLUE='\033[0;34m'
YELLOW='\033[1;33m'
CYAN='\033[0;36m'
NC='\033[0m'
echo -e "${BLUE}╔═══════════════════════════════════════════════╗${NC}"
echo -e "${BLUE}║ Technical Launch Plan Generator ║${NC}"
echo -e "${BLUE}╚═══════════════════════════════════════════════╝${NC}"
echo ""
# Gather information
echo -e "${YELLOW}Product/Feature Information${NC}"
echo ""
read -p "Product/Feature Name: " PRODUCT_NAME
read -p "Launch Date (YYYY-MM-DD): " LAUNCH_DATE
read -p "Launch Tier (1/2/3): " TIER
read -p "One-line Description: " DESCRIPTION
read -p "Target Audience (e.g., Backend developers, DevOps): " AUDIENCE
echo ""
OUTPUT_FILE="${PRODUCT_NAME// /_}_launch_plan.md"
# Generate plan
cat > "$OUTPUT_FILE" << EOF
# Technical Launch Plan: $PRODUCT_NAME
**Launch Date:** $LAUNCH_DATE
**Launch Tier:** Tier $TIER
**Owner:** $(whoami)
**Last Updated:** $(date +%Y-%m-%d)
---
## Executive Summary
### What We're Launching
$DESCRIPTION
### Target Audience
$AUDIENCE
### Launch Tier: Tier $TIER
EOF
# Add tier-specific details
if [ "$TIER" = "1" ]; then
cat >> "$OUTPUT_FILE" << 'EOF'
**Major Launch** - Full GTM treatment, 12-16 week timeline
### Success Criteria
- [ ] [Define target adoption metric]
- [ ] [Define engagement metric]
- [ ] [Define business/revenue metric]
---
## Timeline
### T-12 weeks: Planning Phase
**Week of [Date]**
- [ ] Launch tier confirmed
- [ ] Stakeholder kickoff meeting
- [ ] Success metrics defined
- [ ] Budget approved
- [ ] Project plan created
### T-8 weeks: Build Phase Starts
**Week of [Date]**
- [ ] Documentation outline complete
- [ ] SDK development started
- [ ] Marketing brief created
- [ ] Demo environment setup
- [ ] Beta customers identified
### T-6 weeks: Content Creation
**Week of [Date]**
- [ ] Getting started guide (first draft)
- [ ] API reference complete
- [ ] Sample apps in development
- [ ] Blog post (first draft)
- [ ] Demo video script
### T-4 weeks: Review & Refinement
**Week of [Date]**
- [ ] All docs reviewed by engineering
- [ ] SDKs in beta testing
- [ ] Demo video recorded
- [ ] Sales enablement created
- [ ] Press release draft
### T-2 weeks: Final Prep
**Week of [Date]**
- [ ] All content finalized
- [ ] Internal enablement complete
- [ ] Launch email scheduled
- [ ] Social media calendar
- [ ] Monitoring/analytics ready
### Launch Week
**Week of [Date]**
- [ ] Documentation published
- [ ] SDKs released
- [ ] Blog post live
- [ ] Email sent
- [ ] Social campaign
- [ ] PR outreach
- [ ] Launch event
### Post-Launch
**Weeks 1-4**
- [ ] Daily metrics monitoring
- [ ] Community engagement
- [ ] Follow-up content
- [ ] Feedback synthesis
- [ ] Launch retrospective
---
## Deliverables
### Documentation
- [ ] Getting started guide
- [ ] API reference
- [ ] Integration guides
- [ ] Migration guide (if applicable)
- [ ] Troubleshooting FAQ
- [ ] Video tutorials
### Code Assets
- [ ] SDK: Python
- [ ] SDK: JavaScript/Node
- [ ] SDK: [Other language]
- [ ] Sample application: [Type]
- [ ] Sample application: [Type]
- [ ] Code snippets library
- [ ] Interactive playground
### Marketing Assets
- [ ] Launch blog post
- [ ] Demo video
- [ ] Product page
- [ ] Email template
- [ ] Social media posts
- [ ] Press release
- [ ] Infographic/diagram
### Sales Enablement
- [ ] Technical battlecard
- [ ] Demo script
- [ ] FAQ/objection handling
- [ ] Pricing materials
- [ ] Customer deck
---
## Stakeholders & Owners
| Area | Owner | Status |
|------|-------|--------|
| Product Marketing | [Name] | ✓ |
| Product Management | [Name] | Pending |
| Engineering | [Name] | Pending |
| Developer Relations | [Name] | Pending |
| Sales Engineering | [Name] | Pending |
| PR/Communications | [Name] | Pending |
| Partners | [Name] | Pending |
---
## Launch Channels
### Primary
- [ ] Developer Documentation
- [ ] Product Blog
- [ ] Email (Developer List)
- [ ] Social Media
- [ ] Changelog
### Secondary
- [ ] Hacker News
- [ ] Reddit (r/programming, r/[relevant])
- [ ] Dev.to
- [ ] Product Hunt
- [ ] YouTube
### Tertiary
- [ ] Tech Press
- [ ] Podcasts
- [ ] Webinars
- [ ] Conferences
- [ ] Community Forums
EOF
elif [ "$TIER" = "2" ]; then
cat >> "$OUTPUT_FILE" << 'EOF'
**Standard Launch** - Selective GTM, 6-8 week timeline
### Success Criteria
- [ ] [Define adoption target]
- [ ] [Define engagement metric]
---
## Timeline
### T-6 weeks: Planning & Build
- [ ] Feature spec finalized
- [ ] Documentation started
- [ ] Marketing brief created
### T-4 weeks: Content Creation
- [ ] Feature docs complete
- [ ] Code samples created
- [ ] Blog post drafted
- [ ] Demo video recorded
### T-2 weeks: Review
- [ ] Engineering review complete
- [ ] Content finalized
- [ ] Email scheduled
### Launch Week
- [ ] Documentation published
- [ ] Blog post live
- [ ] Email sent
- [ ] Social posts
### Post-Launch (Weeks 1-2)
- [ ] Metrics monitoring
- [ ] Community Q&A
- [ ] Follow-up content
---
## Deliverables
### Documentation
- [ ] Feature guide
- [ ] API updates
- [ ] Code samples (3+)
- [ ] Integration guide
### Marketing
- [ ] Blog post
- [ ] Demo video
- [ ] Email announcement
- [ ] Social posts
### Sales Enablement
- [ ] Feature overview
- [ ] Demo talking points
EOF
else
cat >> "$OUTPUT_FILE" << 'EOF'
**Minor Launch** - Minimal GTM, 2-4 week timeline
### Success Criteria
- [ ] Documentation updated
- [ ] Users notified
---
## Timeline
### T-2 weeks: Prep
- [ ] Release notes drafted
- [ ] Documentation updated
### Launch Week
- [ ] Release notes published
- [ ] Changelog updated
- [ ] Notification sent
---
## Deliverables
- [ ] Release notes
- [ ] Updated documentation
- [ ] Changelog entry
- [ ] In-app notification (if applicable)
EOF
fi
# Add common sections
cat >> "$OUTPUT_FILE" << 'EOF'
---
## Success Metrics
### Activation Metrics
- **Metric:** [e.g., API key created]
- **Target:** [e.g., 1000 in Week 1]
- **Measurement:** [Dashboard link]
### Engagement Metrics
- **Metric:** [e.g., First API call made]
- **Target:** [e.g., 60% activation rate]
- **Measurement:** [Analytics]
### Retention Metrics
- **Metric:** [e.g., Day 7 retention]
- **Target:** [e.g., 40%]
- **Measurement:** [Cohort analysis]
### Business Metrics
- **Metric:** [e.g., Paid conversions]
- **Target:** [e.g., 5%]
- **Measurement:** [Revenue dashboard]
---
## Risks & Mitigation
| Risk | Impact | Probability | Mitigation |
|------|--------|------------|------------|
| Documentation not ready | High | Medium | Start docs 2 weeks earlier |
| [Add risks] | | | |
---
## Budget
| Item | Cost | Owner |
|------|------|-------|
| [e.g., PR agency] | $[amount] | [Name] |
| [e.g., Demo production] | $[amount] | [Name] |
| **Total** | **$[total]** | |
---
## Post-Launch Plan
### Week 1
- Daily metrics check
- Community Q&A
- Bug triage
### Week 2-4
- Follow-up blog posts
- Customer interviews
- Documentation refinements
### Month 2
- Case study development
- Webinar/workshop
- Integration showcases
---
## Launch Day Playbook
### Pre-Launch (Day Before)
- [ ] All assets staged
- [ ] Team briefed
- [ ] Monitoring ready
### Launch Day Morning (9 AM)
- [ ] Publish documentation
- [ ] Release packages/SDKs
- [ ] Deploy blog post
- [ ] Send email
- [ ] Post to social
### Midday (12 PM)
- [ ] Monitor metrics
- [ ] Respond to questions
- [ ] Share to communities
### Afternoon (3 PM)
- [ ] Post to HN/Reddit (if Tier 1)
- [ ] Dev advocate content
- [ ] Partner announcements
### End of Day
- [ ] Day 1 report
- [ ] Team debrief
- [ ] Issue triage
---
## Notes
[Add any additional notes, context, or decisions]
---
## Appendix
### Links
- [Project spec]
- [Design doc]
- [Marketing brief]
- [Asset folder]
EOF
echo -e "${GREEN}✓ Launch plan generated!${NC}"
echo ""
echo -e "Output: ${CYAN}$OUTPUT_FILE${NC}"
echo ""
echo -e "${YELLOW}Next steps:${NC}"
echo "1. Review and customize the plan"
echo "2. Fill in specific names, dates, and metrics"
echo "3. Share with stakeholders for review"
echo "4. Use as living document throughout launch"
echo ""
echo -e "${CYAN}Validate readiness before launch:${NC}"
echo " scripts/validate_readiness.sh"
echo ""

View File

@@ -0,0 +1,158 @@
#!/bin/bash
# Launch Readiness Validator
# Checks if technical launch is ready
set -e
# Colors
GREEN='\033[0;32m'
BLUE='\033[0;34m'
YELLOW='\033[1;33m'
RED='\033[0;31m'
CYAN='\033[0;36m'
NC='\033[0m'
echo -e "${BLUE}╔═══════════════════════════════════════════════╗${NC}"
echo -e "${BLUE}║ Technical Launch Readiness Check ║${NC}"
echo -e "${BLUE}╚═══════════════════════════════════════════════╝${NC}"
echo ""
# Counters
PASSED=0
FAILED=0
WARNINGS=0
# Helper functions
check_yes_no() {
local question="$1"
local critical="$2"
read -p "$question (y/n): " answer
if [[ "$answer" =~ ^[Yy]$ ]]; then
echo -e " ${GREEN}${NC} Pass"
((PASSED++))
return 0
else
if [ "$critical" = "true" ]; then
echo -e " ${RED}${NC} FAIL (Critical)"
((FAILED++))
else
echo -e " ${YELLOW}${NC} Warning"
((WARNINGS++))
fi
return 1
fi
}
# Documentation Check
echo -e "${CYAN}━━━ Documentation ━━━${NC}"
echo ""
check_yes_no "Getting started guide complete and reviewed?" true
check_yes_no "API reference up to date?" true
check_yes_no "At least 3 code samples ready?" true
check_yes_no "Integration guide written?" false
check_yes_no "Migration guide (if needed)?" false
check_yes_no "Troubleshooting FAQ added?" false
echo ""
# Code Assets
echo -e "${CYAN}━━━ Code Assets ━━━${NC}"
echo ""
check_yes_no "SDKs built and tested?" false
check_yes_no "Sample applications functional?" false
check_yes_no "Interactive demo/playground ready?" false
check_yes_no "Code snippets library created?" false
echo ""
# Technical Infrastructure
echo -e "${CYAN}━━━ Technical Infrastructure ━━━${NC}"
echo ""
check_yes_no "Production environment tested?" true
check_yes_no "Monitoring/analytics instrumented?" true
check_yes_no "Error tracking configured?" true
check_yes_no "Rate limiting verified?" false
check_yes_no "Load testing completed?" false
echo ""
# Marketing Assets
echo -e "${CYAN}━━━ Marketing Assets ━━━${NC}"
echo ""
check_yes_no "Launch blog post written and reviewed?" true
check_yes_no "Demo video recorded?" false
check_yes_no "Email template created?" true
check_yes_no "Social media posts scheduled?" true
check_yes_no "Product page updated?" true
echo ""
# Sales Enablement
echo -e "${CYAN}━━━ Sales Enablement ━━━${NC}"
echo ""
check_yes_no "Sales team briefed?" false
check_yes_no "Demo script prepared?" false
check_yes_no "FAQ/objections documented?" false
check_yes_no "Pricing materials ready?" false
echo ""
# Team Readiness
echo -e "${CYAN}━━━ Team Readiness ━━━${NC}"
echo ""
check_yes_no "Support team trained?" true
check_yes_no "On-call rotation set?" true
check_yes_no "Escalation path defined?" true
check_yes_no "Launch day roles assigned?" true
echo ""
# Final Checks
echo -e "${CYAN}━━━ Final Checks ━━━${NC}"
echo ""
check_yes_no "All stakeholders approved?" true
check_yes_no "Legal/compliance review (if needed)?" true
check_yes_no "Rollback plan documented?" true
check_yes_no "Launch day playbook ready?" true
echo ""
# Results
echo -e "${BLUE}╔═══════════════════════════════════════════════╗${NC}"
echo -e "${BLUE}║ Readiness Summary ║${NC}"
echo -e "${BLUE}╚═══════════════════════════════════════════════╝${NC}"
echo ""
echo -e "Checks Passed: ${GREEN}$PASSED${NC}"
echo -e "Warnings: ${YELLOW}$WARNINGS${NC}"
echo -e "Failed: ${RED}$FAILED${NC}"
echo ""
# Decision
if [ $FAILED -eq 0 ]; then
if [ $WARNINGS -eq 0 ]; then
echo -e "${GREEN}✅ READY TO LAUNCH!${NC}"
echo ""
echo "All critical checks passed. You're good to go!"
else
echo -e "${YELLOW}⚠ LAUNCH WITH CAUTION${NC}"
echo ""
echo "Critical checks passed, but $WARNINGS warnings remain."
echo "Consider addressing warnings before launch."
fi
exit 0
else
echo -e "${RED}❌ NOT READY TO LAUNCH${NC}"
echo ""
echo "You have $FAILED critical failures that must be addressed."
echo "Do not launch until these are resolved."
exit 1
fi