Azure Cosmos DB performance optimization and best practices guidelines for NoSQL,
partitioning, queries, SDK usage, and vector search. Use when writing, reviewing,
or refactoring code that interacts with Azure Cosmos DB, designing data models,
optimizing queries, or implementing high-performance database operations.
Azure Cosmos DB performance optimization and best practices guidelines for NoSQL,
partitioning, queries, SDK usage, and vector search. Use when writing, reviewing,
or refactoring code that interacts with Azure Cosmos DB, designing data models,
optimizing queries, or implementing high-performance database operations.
metadata
{"author":"cosmosdb-agent-kit","version":"1.0.0"}
Azure Cosmos DB Best Practices
Comprehensive performance optimization guide for Azure Cosmos DB applications, containing
73+ rules across 10 categories, prioritized by impact to guide automated
refactoring and code generation.
73 individual rule files are in the rules/ directory, one file per rule,
synced from the AzureCosmosDB/cosmosdb-agent-kit.
Load only the relevant rule file(s) when answering a question — do NOT load all files at once.
When to Apply
Reference these guidelines when:
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
Implementing vector search and RAG patterns
Rule Index
Rules are grouped by category prefix. For a given question, load files matching
the relevant prefix (e.g., model-*.md for data modeling, sdk-*.md for SDK usage).
See rules/_sections.md for category descriptions.
Each rule is a separate file under rules/. When answering a Cosmos DB question,
read only the relevant rule file(s) based on the prefix matching the topic:
Data modeling question → read rules/model-*.md files
