name: azure-developer-cli description: 'Design, create, review, migrate, or troubleshoot Azure Developer CLI (azd) projects using current Microsoft guidance. Use for azd, azure.yaml, AZD templates, Bicep or Terraform under infra, AZD environments and secrets, hooks, deployment workflows, and azd-managed CI/CD.' license: MIT
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:
- Find
azure.yaml, the configuredinfra.path, source projects, deployment scripts,.gitignore, and pipeline definitions. - Read
azure.yamlbefore inferring services or the IaC provider. - Identify whether the task is to create, migrate, review, deploy, or troubleshoot.
- Identify the active environment only when an environment-specific operation is required.
- Read the relevant reference:
- Repository layout or
azure.yaml: references/project-structure.md - Bicep, Terraform, parameters, outputs, or environments: references/iac-and-environments.md
- Repository layout or