azure-prepare

Enforce Azure preparation before generating code or infrastructure.

242|189|Updated Oct 28, 2024
One-click install
npx skills add https://github.com/microsoft/GitHub-Copilot-for-Azure --skill azure-prepare
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azure-prepare
Source: https://github.com/microsoft/GitHub-Copilot-for-Azure/tree/main/plugin/skills/azure-prepare
Command: npx skills add https://github.com/microsoft/GitHub-Copilot-for-Azure --skill azure-prepare

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures every Azure project starts with mandatory preparation steps before generating code or infrastructure, preventing risky deployments and misconfigurations.

Core Features & Use Cases

  • Enforce first-step readiness: Ensures users perform Azure preparation prior to azure.yaml, Bicep, Terraform, or CLI commands.
  • Structured workflow guidance: Guides users through workspace analysis, requirements gathering, codebase scanning, and recipe selection.
  • Manifest-driven governance: Requires creating and updating the .azure/preparation-manifest.md after each phase to capture decisions and artifacts.
  • Pre-deployment checkpoint: Integrates with azure-validate to ensure readiness before deployment.

Quick Start

Invoke this skill before generating any Azure artifacts. Then follow the prompts to collect requirements, analyze the project, select a deployment recipe, and plan the architecture. After each phase, update the preparation manifest and finally run the azure-validate step before provisioning.

Frequently Asked Questions about azure-prepare

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prepare an Azure project before generating infrastructure code?

Azure preparation requires gathering requirements, analyzing the workspace, selecting a deployment recipe, and planning architecture before generating any code. This structured readiness workflow mandates updating a preparation manifest after each phase to capture decisions and prevent risky deployments.

What is the azure.yaml manifest used for in deployment workflows?

The azure.yaml manifest is referenced during Azure preparation to ensure readiness before generating infrastructure. You must complete workspace analysis, requirements gathering, and architecture planning phases first, updating a preparation manifest after each phase to govern the deployment workflow.

Do I need to run a preparation step before creating Bicep or Terraform files for Azure?

Yes, a mandatory preparation step is required before creating Bicep or Terraform files for Azure. You must gather requirements, scan the codebase, and plan the architecture first. This enforces manifest-driven governance to capture decisions before any provisioning occurs.

Can I use Azure preparation workflows for modernizing existing application deployments?

Yes, Azure preparation workflows apply to modernizing deployments, adding components, updating configurations, and creating new applications. The workflow guides you through codebase scanning and recipe selection, ensuring the preparation manifest is updated after each phase to maintain compliance.

What's the best way to enforce compliance checkpoints before deploying to Azure?

The best way to enforce compliance checkpoints is to mandate manifest updates after every preparation phase, from requirements gathering to architecture planning. Integrating a validation step before deployment ensures all readiness criteria and configuration decisions are captured and verified.

Why does my Azure deployment fail without a preparation manifest?

Azure deployments fail without a preparation manifest because mandatory readiness steps were skipped, leading to misconfigurations. You must coordinate requirements gathering, workspace analysis, and recipe selection first, capturing all artifacts and decisions in the manifest before provisioning.