Azure Developer CLI best practices

Use this skill to produce maintainable, secure, environment-aware azd projects. Prefer repository conventions when they are already coherent, and make the smallest complete change that improves the project.

Start with repository discovery

Before editing:

1. Find azure.yaml, the configured infra.path, source projects, deployment scripts, .gitignore, and pipeline definitions.
2. Read azure.yaml before inferring services or the IaC provider.
3. Identify whether the task is to create, migrate, review, deploy, or troubleshoot.
4. Identify the active environment only when an environment-specific operation is required.
5. Read the relevant reference:
   • Repository layout or azure.yaml: references/project-structure.md
   • Bicep, Terraform, parameters, outputs, or environments: references/iac-and-environments.md
   • Secrets, hooks, CI/CD, deployment, or troubleshooting: references/security-cicd-operations.md
   • Product details that may have changed: references/official-docs.md

Do not assume the default infra path, the default Bicep provider, or a single service when azure.yaml says otherwise.