grammarly-reference-architecture

# Grammarly Reference Architecture ## Architecture ``` ┌────────────────────────────────────┐ │ Your Application │ ├────────────────────────────────────┤ │ Content Quality Service │ │ (Score, AI Detect, Plagiarism) │ ├────────────────────────────────────┤ │ Grammarly API Client │ │ (Auth, Retry, Cache, Chunking) │ ├────────────────────────────────────┤ │ Grammarly APIs │ │ api.grammarly.com │ └────────────────────────────────────┘ ``` ## Project Structure ``` grammarly-integration/ ├── src/grammarly/ │ ├── client.ts # API client with token management │ ├── scoring.ts # Writing Score API │ ├── detection.ts # AI + Plagiarism detection │ ├── chunking.ts # Large document splitting │ └── types.ts # TypeScript interfaces ├── src/services/ │ ├── quality-gate.ts # Threshold enforcement │ └── content-audit.ts # Full audit pipeline ├── tests/ └── .env.example ``` ## API Decision Matrix | Need | API | Notes | |------|-----|-------| | Grammar/style quality | Writing Score v2 | Sync, fast | | AI content detection | AI Detection v1 | Sync, fast | | Source matching | Plagiarism v1 | Async, poll | | All three | Combined pipeline | Parallel where possible | ## Resources - [Grammarly Developer Portal](https://developer.grammarly.com/) ## Next Steps Start with `grammarly-install-auth`.