assemblyai-prod-checklist

name	assemblyai-prod-checklist
description	Execute AssemblyAI production deployment checklist and rollback procedures. Use when deploying AssemblyAI integrations to production, preparing for launch, or implementing go-live procedures for transcription services. Trigger with phrases like "assemblyai production", "deploy assemblyai", "assemblyai go-live", "assemblyai launch checklist".
allowed-tools	Read, Bash(kubectl:*), Bash(curl:*), Grep
version	1.5.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","ai","speech-to-text","assemblyai","transcription","production"]
compatibility	Designed for Claude Code

AssemblyAI Production Checklist

Overview

Complete checklist for deploying AssemblyAI-powered transcription services to production with health checks, monitoring, and rollback procedures.

Prerequisites

• Staging environment tested and verified
• Production API key from https://www.assemblyai.com/app/account
• Deployment pipeline configured
• Monitoring stack ready

Instructions

Pre-Deployment Checklist

API Key & Auth

• Production API key stored in secrets manager (not env files)
• Key is separate from dev/staging keys
• Temporary token endpoint configured for browser streaming
• API key rotation procedure documented

Code Quality

• All transcript.status === 'error' cases handled
• Rate limit retry with exponential backoff implemented
• No hardcoded API keys or audio URLs
• PII redaction enabled for sensitive audio content
• Webhook URL uses HTTPS
• Audio file upload size validated before submission

Error Handling

• 429 (rate limit) triggers retry with backoff
• 5xx (server error) triggers retry with backoff
• 401 (auth error) triggers alert, no retry
• transcript.status === 'error' logged with transcript ID and error message
• WebSocket disconnect triggers reconnection for streaming
• LeMUR errors handled (invalid transcript ID, context too long)

Performance

• Transcript results cached where appropriate