# Cosmosdb Design Patterns

> Azure Cosmos DB design patterns: change feed materialized views, efficient ranking, service layer relationship hydration, LangGraph multi-agent orchestration, human-in-the-loop interrupts, checkpoint resumption, agent routing, FastAPI startup, chat history separation, background task writes, async Cosmos DB routing, and agent name attribution. USE FOR: Cosmos DB change feed, materialized views, CQRS, event sourcing, ranking patterns, service layer, relationship hydration, LangGraph, multi-agent, human-in-the-loop, interrupt, checkpoint, agent routing, FastAPI startup, chat history, background tasks, async routing, agent attribution, AI grounding. DO NOT USE FOR: SDK configuration (use cosmosdb-sdk), data modeling (use cosmosdb-data-modeling).

- Skill: `atc-net/cosmosdb-design-patterns` (Agent Skill, multi-file: 15 files)
- Install (CLI): `npx skillmds@latest add atc-net/cosmosdb-design-patterns`
- Raw SKILL.md: https://api.skillmd.com/api/skills/atc-net/cosmosdb-design-patterns/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: atc-net (https://skillmd.com/u/atc-net)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/atc-net/cosmosdb-design-patterns

---


# Azure Cosmos DB Design Patterns

Architecture and integration patterns for Azure Cosmos DB applications, including AI agent orchestration with LangGraph.

## When to Apply

Reference these guidelines when:
- Implementing materialized views with change feed
- Building ranking or leaderboard features
- Hydrating document references across containers
- Building LangGraph multi-agent applications with Cosmos DB
- Implementing human-in-the-loop flows
- Managing chat history and agent routing

## Rules

- [pattern-change-feed-materialized-views](references/pattern-change-feed-materialized-views.md) - Use Change Feed for cross-partition query optimization
- [pattern-efficient-ranking](references/pattern-efficient-ranking.md) - Efficient ranking approaches
- [pattern-service-layer-relationships](references/pattern-service-layer-relationships.md) - Service layer for relationship hydration
- [pattern-langgraph-multi-agent](references/pattern-langgraph-multi-agent.md) - StateGraph with conditional edges for multi-agent routing
- [pattern-langgraph-interrupt-human](references/pattern-langgraph-interrupt-human.md) - LangGraph interrupt for human-in-the-loop
- [pattern-langgraph-resume-checkpoint](references/pattern-langgraph-resume-checkpoint.md) - Resume from checkpoint after interrupt
- [pattern-langgraph-agent-routing-cosmosdb](references/pattern-langgraph-agent-routing-cosmosdb.md) - Persist active agent in Cosmos DB
- [pattern-langgraph-fastapi-startup](references/pattern-langgraph-fastapi-startup.md) - Initialize LangGraph agents in FastAPI
- [pattern-langgraph-chat-history-separate](references/pattern-langgraph-chat-history-separate.md) - Store chat history in dedicated container
- [pattern-background-task-writes](references/pattern-background-task-writes.md) - FastAPI background tasks for non-blocking writes
- [pattern-langgraph-async-cosmos-routing](references/pattern-langgraph-async-cosmos-routing.md) - Async Cosmos DB calls in LangGraph routing
- [pattern-langgraph-async-cosmos-writes](references/pattern-langgraph-async-cosmos-writes.md) - Async active agent writes
- [pattern-langgraph-agent-name-attribution](references/pattern-langgraph-agent-name-attribution.md) - Tag AI messages with agent name
- [pattern-ai-grounding-access](references/pattern-ai-grounding-access.md) - AI grounding access patterns