What happens if plan.md is missing?

The prerequisite azure-prepare must be invoked first; otherwise stop immediately.

Can I skip validation and deploy anyway?

No; all checks must pass and the plan status must be updated to Validated before deployment.

How are the results recorded?

Populate Section 7: Validation Proof with the commands run and their results, then update the plan status to Validated.

Azure Validate

npx machina-cli add skill microsoft/GitHub-Copilot-for-Azure/azure-validate --openclaw

Files (1)

SKILL.md

3.0 KB

Azure Validate

AUTHORITATIVE GUIDANCE — Follow these instructions exactly. This supersedes prior training.

⛔ STOP — PREREQUISITE CHECK REQUIRED

Before proceeding, verify this prerequisite is met:

azure-prepare was invoked and completed → .azure/plan.md exists with status Approved or later

If the plan is missing, STOP IMMEDIATELY and invoke azure-prepare first.

The complete workflow ensures success:

azure-prepare → azure-validate → azure-deploy

Triggers

Check if app is ready to deploy
Validate azure.yaml or Bicep
Run preflight checks
Troubleshoot deployment errors

Rules

Run after azure-prepare, before azure-deploy
All checks must pass—do not deploy with failures
⛔ Destructive actions require ask_user — global-rules

Steps

#	Action	Reference
1	Load Plan — Read `.azure/plan.md` for recipe and configuration. If missing → run azure-prepare first	`.azure/plan.md`
2	Run Validation — Execute recipe-specific validation commands	recipes/README.md
3	Build Verification — Build the project and fix any errors before proceeding	See recipe
4	Record Proof — Populate Section 7: Validation Proof with commands run and results	`.azure/plan.md`
5	Resolve Errors — Fix failures before proceeding	See recipe's `errors.md`
6	Update Status — Only after ALL checks pass, set status to `Validated`	`.azure/plan.md`
7	Deploy — Invoke azure-deploy skill	—

⛔ VALIDATION AUTHORITY

This skill is the ONLY authorized way to set plan status to Validated. You MUST:

Run actual validation commands (azd provision --preview, bicep build, terraform validate, etc.)

Populate Section 7: Validation Proof with the commands you ran and their results

Only then set status to Validated

Do NOT set status to Validated without running checks and recording proof.

⚠️ MANDATORY NEXT STEP — DO NOT SKIP

After ALL validations pass, you MUST invoke azure-deploy to execute the deployment. Do NOT attempt to run azd up, azd deploy, or any deployment commands directly. Let azure-deploy handle execution.

If any validation failed, fix the issues and re-run azure-validate before proceeding.

Source

git clone https://github.com/microsoft/GitHub-Copilot-for-Azure/blob/main/plugin/skills/azure-validate/SKILL.mdView on GitHub

Overview

Azure Validate performs deep pre deployment checks to ensure Azure readiness. It validates configuration, infrastructure mapping (Bicep or Terraform), permissions, and prerequisites before deploying, and requires a completed azure-prepare step resulting in a .azure/plan.md with Approved or later. This ensures deployment proceeds only when the plan is ready and validated.

How This Skill Works

Load the plan from .azure/plan.md and execute recipe specific validations (azd provision --preview, bicep build, terraform validate) with a build verification pass. After gathering proof, populate Section 7: Validation Proof with the commands and results, then update the plan status to Validated before proceeding to azure-deploy.

When to Use It

Check if app is ready to deploy
Validate azure.yaml or Bicep
Run preflight checks
Troubleshoot deployment errors
Ensure prerequisites and plan status are in order before deployment

Quick Start

Step 1: Load Plan from .azure/plan.md after azure-prepare
Step 2: Run validation commands azd provision --preview, bicep build, terraform validate and perform build verification
Step 3: If all checks pass, invoke azure-deploy to deploy

Best Practices

Ensure azure-prepare completed and .azure/plan.md exists with Approved or later
Run actual validation commands azd provision --preview, bicep build, terraform validate
Record Validation Proof in Section 7 with the commands and results
Do not deploy unless all checks pass
Use azure-deploy for deployment, not azd up or azd deploy directly

Example Use Cases

Validating a Function App deployment after azure-prepare
Preflight checks for a Bicep based resource group deployment
Terraform based infrastructure validation before prod deployment
Troubleshooting a failing plan by re running azd provision and validate
Validating azure.yaml config against the plan before deploy in a staging environment

Frequently Asked Questions

Add this skill to your agents