---
name: New Rule Proposal
about: Propose a new best practice rule for the cosmosdb-best-practices skill
title: '[Rule] '
labels: new-rule
assignees: ''
---

## Rule Proposal

**Proposed rule name:** `{prefix}-{description}.md`

**Category/Prefix:** <!-- e.g., query-, model-, sdk-, partition-, index- -->

**Impact level:** <!-- Critical / High / Medium / Low -->

## Description

<!-- What problem does this rule address? Why is it important? -->

## Recommendation

<!-- What should the rule advise? Be specific. -->

## Example

<!-- Show a before/after code example or configuration snippet -->

```
// Bad practice

// Good practice
```

## References

<!-- Links to official docs, blog posts, or benchmarks that support this rule -->

- 

## Evaluation Test

<!-- Propose a prompt that would validate this rule's guidance -->

**Test prompt:** 
<!-- e.g., "How should I paginate results in Cosmos DB?" -->

**Expected guidance should mention:**
<!-- Key terms the response should include -->

- 
