cosmosdb-best-practices

Comprehensive performance optimization guide for Azure Cosmos DB applications, containing 60+ rules across 9 categories, prioritized by impact to guide automated refactoring and code generation. Reference these guidelines when: Read individual rule files for detailed explanations and code examples: Each rule file contains: For the complete guide with all rules expanded: AGENTS.md - Designing data models for Cosmos DB - Choosing partition keys - Writing or optimizing queries - Implementing SDK patterns - Reviewing code for performance issues - Configuring throughput and scaling - Building globally distributed applications - model-embed-related - Embed related data retrieved together - model-reference-large - Reference data when items get too large - model-avoid-2mb-limit - Keep items well under 2MB limit - model-id-constraints - Follow ID value length and character constraints - model-nesting-depth - Stay within 128-level nesting depth limit - model-numeric-precision - Understand IEEE 754 numeric precision limits - model-denormalize-reads - Denormalize for read-heavy workloads - model-schema-versioning - Version your document schemas - model-type-discriminator - Use type discriminators for polymorphic data - model-json-serialization - Handle JSON serialization correctly for Cosmos DB documents - model-relationship-references - Use ID references with transient hydration for...