Incident response procedures for TwinMind integration failures. Use when experiencing outages, debugging production issues, or responding to alerts related to TwinMind. Trigger with phrases like "twinmind incident", "twinmind outage", "twinmind down", "twinmind emergency", "twinmind runbook".
Procedures for diagnosing and resolving TwinMind integration incidents, covering classification, diagnostics, common scenarios, escalation, and post-incident review.
Classify severity (P1=15min/P2=1hr/P3=4hr/P4=24hr). Acknowledge in PagerDuty, join incident Slack channel, note start time.
Check TwinMind status page, your service health endpoint, recent deployments, and infrastructure status using diagnostic commands.
Follow scenario-specific playbooks: all transcriptions failing (API down, invalid key, network issue), high latency (TwinMind slow, service overloaded, network latency), rate limiting (429 errors, heavy consumers), or authentication failures (401 errors, key rotation).
Apply resolution steps based on diagnosis. Follow escalation path: On-Call (0-15min) -> Team Lead (15-30min) -> Engineering Manager (30-60min) -> VP Engineering (60+ min).
Confirm resolution, update status page, notify stakeholders, document timeline, schedule post-mortem within 1 week, create action items.
See detailed implementation for diagnostic commands, scenario playbooks, and incident report template.
| Issue | Cause | Solution |
|---|---|---|
| All transcriptions failing | TwinMind API down | Monitor status.twinmind.com, notify users |
| High latency (P95 > 5s) | Service overloaded | Scale replicas, queue requests |
| Rate limit exceeded (429) | Too many requests | Enable request queue, request limit increase |
| Auth failures (401) | Key expired/revoked | Regenerate key, update secrets |
Basic usage: Apply twinmind incident runbook to a standard project setup with default configuration options.
Advanced scenario: Customize twinmind incident runbook for production environments with multiple constraints and team-specific requirements.
For data handling procedures, see twinmind-data-handling.43:["$","$L4c",null,{"content":"$4d","frontMatter":{"name":"twinmind-incident-runbook","description":"Incident response procedures for TwinMind integration failures.\nUse when experiencing outages, debugging production issues,\nor responding to alerts related to TwinMind.\nTrigger with phrases like "twinmind incident", "twinmind outage",\n"twinmind down", "twinmind emergency", "twinmind runbook".\n","allowed-tools":"Read, Bash(curl:*), Grep","version":"1.0.0","license":"MIT","author":"Jeremy Longshore [email protected]","compatible-with":"claude-code, codex, openclaw"}}]