grammarly-prod-checklist

# Grammarly Production Checklist ## Overview Grammarly provides AI-powered writing assistance with grammar checking, tone detection, plagiarism scanning, and style suggestions. A production integration processes user-submitted text through Grammarly's API and returns actionable suggestions. Failures mean unchecked content goes live, suggestion latency degrades UX, or sensitive text leaks outside approved processing boundaries. ## Authentication & Secrets - [ ] `GRAMMARLY_API_KEY` stored in secrets manager (not config files) - [ ] Client credentials (ID + secret) separated from application code - [ ] Token refresh logic handles expiry before API calls fail - [ ] Separate credentials for dev/staging/prod environments - [ ] Key rotation schedule documented (90-day cycle) ## API Integration - [ ] Production base URL configured (`https://api.grammarly.com/v1`) - [ ] Rate limit handling with exponential backoff - [ ] Text chunking implemented for documents > 100K characters - [ ] Minimum 30-word validation before sending to API - [ ] Suggestion categories configured per use case (grammar, tone, clarity) - [ ] AI detection endpoint integrated if content authenticity required - [ ] Plagiarism check timeout handling (longer processing for large docs) ## Error Handling & Resilience - [ ] Circuit breaker configured for Grammarly API outages - [ ] Retry with backoff for 429/5xx responses - [ ] Writing score thresholds defined per content type - [ ] Graceful degradation when API i...