Dev environment for Azure Cosmos DB projects

This repository provides shared setup guidance for AI coding agents launched from Azure Cosmos DB documentation.

Use this repository as a neutral starting point for agent-assisted quickstart work. The agent should read the source Microsoft Learn article named in the prompt, generate a small runnable app, use safe placeholder configuration values, and validate the result before finishing.

Agent guidance

• AGENTS.md contains the shared instructions for all coding agents.
• CLAUDE.md contains Claude Code-specific entry-point guidance.
• .github/copilot-instructions.md contains GitHub Copilot-specific entry-point guidance.
• .github/SECURITY.md explains how agents should handle credentials, placeholders, and generated code.

Azure Cosmos DB Agent Kit

Agents should install the Azure Cosmos DB Agent Kit before working on generated Azure Cosmos DB apps:

npx --yes skills add AzureCosmosDB/cosmosdb-agent-kit

GitHub Copilot installs the kit through .github/workflows/copilot-setup-steps.yml. The source is intentionally unpinned, so each fresh Copilot environment installs the current kit from its default branch. Other clients can run the command above when they don't provide an equivalent setup hook. The generated skill files and skills-lock.json aren't committed to this repository.