groq-prod-checklist

# Groq Production Checklist ## Overview Complete pre-launch checklist for deploying Groq-powered applications to production. Covers API key security, model selection, rate limit planning, fallback strategies, and monitoring setup. ## Prerequisites - Staging environment tested with Groq API - Groq Developer or Enterprise plan (free tier is not suitable for production) - Production API key created in console.groq.com - Monitoring and alerting infrastructure ready ## Pre-Deployment Checklist ### API Key & Auth - [ ] Production API key stored in secret manager (not `.env` files) - [ ] Key is NOT shared with development or staging environments - [ ] Key rotation procedure documented and tested - [ ] Pre-commit hook blocks `gsk_` pattern in code ### Model Selection - [ ] Production model chosen and tested (recommend `llama-3.3-70b-versatile`) - [ ] Fallback model configured (`llama-3.1-8b-instant`) - [ ] Deprecated model IDs removed (check [deprecations](https://console.groq.com/docs/deprecations)) - [ ] `max_tokens` set to actual expected output size (not context max) ### Rate Limit Planning - [ ] Production rate limits known (check console.groq.com/settings/limits) - [ ] Estimated peak RPM < 80% of limit - [ ] Estimated peak TPM < 80% of limit - [ ] Exponential backoff with `retry-after` header implemented - [ ] Request queue for burst protection (`p-queue` or similar) ### Error Handling - [ ] All Groq error types caught (`Groq.APIError`, `Groq.APIConnectionError`) - [ ] 4...