linear-incident-runbook

# Linear Incident Runbook ## Overview Step-by-step runbooks for handling production incidents with Linear integrations. Covers API authentication failures, rate limiting, webhook issues, and Linear platform outages. ## Incident Classification | Severity | Impact | Response | Examples | |----------|--------|----------|----------| | SEV1 | Complete integration outage | < 15 min | Auth broken, API unreachable | | SEV2 | Major degradation | < 30 min | High error rate, rate limited | | SEV3 | Minor issues | < 2 hours | Some features affected | | SEV4 | Low impact | < 24 hours | Warnings, non-critical | ## Immediate Actions (All Incidents) ### Step 1: Confirm the Issue ```bash set -euo pipefail # 1. Check Linear platform status curl -s https://status.linear.app/api/v2/status.json | jq '.status' # 2. Test your API key curl -s -X POST https://api.linear.app/graphql \ -H "Authorization: $LINEAR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "{ viewer { name email } }"}' | jq . # 3. Check rate limit status curl -s -I -X POST https://api.linear.app/graphql \ -H "Authorization: $LINEAR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "{ viewer { id } }"}' 2>&1 | grep -i ratelimit # 4. Check your app health endpoint curl -s https://yourapp.com/health/linear | jq . ``` ### Step 2: Gather Diagnostic Info ```typescript // scripts/incident-diagnostic.ts import { LinearClient } from "@linear/sdk"; async function diagnose() { console.log("=...