posthog-prod-checklist

Execute PostHog production deployment checklist and rollback procedures.Use when deploying PostHog integrations to production, preparing for launch,or implementing go-live procedures.Trigger with phrases like "posthog production", "deploy posthog","posthog go-live", "posthog launch checklist".

⭐939stars🔀114forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill automates the production deployment process for PostHog integrations by providing a comprehensive, step-by-step checklist. It ensures production readiness through rigorous configuration checks, code quality verification, and infrastructure setup, while facilitating safe deployments via gradual canary rollouts and automated rollback procedures to minimize downtime.

Use Cases

  • Executing a structured production launch for PostHog integrations to ensure all security and configuration prerequisites are met.
  • Managing gradual canary deployments (10% to 100%) using Kubernetes (kubectl) to monitor system health and latency in real-time before full release.
  • Automating emergency rollback procedures to quickly revert to a stable state if production health checks or error rates exceed defined thresholds.
  • Verifying environment security by auditing API key scopes, webhook HTTPS configurations, and secret storage as part of a pre-flight deployment routine.
nameposthog-prod-checklist
description|
allowed-toolsRead, Bash(kubectl:*), Bash(curl:*), Grep
version1.0.0
licenseMIT
authorJeremy Longshore <jeremy@intentsolutions.io>

PostHog Production Checklist

Overview

Complete checklist for deploying PostHog integrations to production.

Prerequisites

  • Staging environment tested and verified
  • Production API keys available
  • Deployment pipeline configured
  • Monitoring and alerting ready

Instructions

Step 1: Pre-Deployment Configuration

  • Production API keys in secure vault
  • Environment variables set in deployment platform
  • API key scopes are minimal (least privilege)
  • Webhook endpoints configured with HTTPS
  • Webhook secrets stored securely

Step 2: Code Quality Verification

  • All tests passing (npm test)
  • No hardcoded credentials
  • Error handling covers all PostHog error types
  • Rate limiting/backoff implemented
  • Logging is production-appropriate

Step 3: Infrastructure Setup

  • Health check endpoint includes PostHog connectivity
  • Monitoring/alerting configured
  • Circuit breaker pattern implemented
  • Graceful degradation configured

Step 4: Documentation Requirements

  • Incident runbook created
  • Key rotation procedure documented
  • Rollback procedure documented
  • On-call escalation path defined

Step 5: Deploy with Gradual Rollout

# Pre-flight checks
curl -f https://staging.example.com/health
curl -s https://status.posthog.com

# Gradual rollout - start with canary (10%)
kubectl apply -f k8s/production.yaml
kubectl set image deployment/posthog-integration app=image:new --record
kubectl rollout pause deployment/posthog-integration

# Monitor canary traffic for 10 minutes
sleep 600
# Check error rates and latency before continuing

# If healthy, continue rollout to 50%
kubectl rollout resume deployment/posthog-integration
kubectl rollout pause deployment/posthog-integration
sleep 300

# Complete rollout to 100%
kubectl rollout resume deployment/posthog-integration
kubectl rollout status deployment/posthog-integration

Output

  • Deployed PostHog integration
  • Health checks passing
  • Monitoring active
  • Rollback procedure documented

Error Handling

Alert Condition Severity
API Down 5xx errors > 10/min P1
High Latency p99 > 5000ms P2
Rate Limited 429 errors > 5/min P2
Auth Failures 401/403 errors > 0 P1

Examples

Health Check Implementation

async function healthCheck(): Promise<{ status: string; posthog: any }> {
  const start = Date.now();
  try {
    await posthogClient.ping();
    return { status: 'healthy', posthog: { connected: true, latencyMs: Date.now() - start } };
  } catch (error) {
    return { status: 'degraded', posthog: { connected: false, latencyMs: Date.now() - start } };
  }
}

Immediate Rollback

kubectl rollout undo deployment/posthog-integration
kubectl rollout status deployment/posthog-integration

Resources

Next Steps

For version upgrades, see posthog-upgrade-migration.