Official agent skill

Sdaf Plan And Test Semantics

by Azure in Azure/sap-automation

Explain SDAF plan-only / test / apply semantics without pretending they are universal.

OfficialMITAuto-check passedDevOps & Cloud

Install Sdaf Plan And Test Semantics

skills CLI
$ npx skills add Azure/sap-automation --skill sdaf-plan-and-test-semantics -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Azure/sap-automation sdaf-plan-and-test-semantics --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Azure/sap-automation.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/sdaf-plan-and-test-semantics .claude/skills/sdaf-plan-and-test-semantics && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sdaf-plan-and-test-semantics
GitHub stars
145
Token cost
~1.6k tokens
SKILL.md length
684 words
Files
2 (incl. references)
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

Explain SDAF plan-only / test / apply semantics without pretending they are universal.

  • A user says what does test do in SDAF
  • SKILL.md covers When to invoke, Rule zero — identify the…, The shortest correct answer and Local / scripted semantics, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Is this a real dry run

What it does

Sdaf Plan And Test Semantics is an agent skill from Azure/sap-automation, published by the product's own GitHub organization. Explain SDAF plan-only / test / apply semantics without pretending they are universal. Compares the documented Local commands, Azure DevOps wrapper pipelines, and GitHub Actions workflows for control plane, workload zone, and SAP system: local stage commands show Terraform plans and then apply after approval; ADO/GitHub workload-zone and SAP-system test runs stop after the plan; the current hosted control-plane test options do not provide a plan-only run. Use when a user says "what does test do in SDAF", "is this…

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/plan-test-matrix.md`).

It sits in DevOps & Cloud, covering Infrastructure as code and CI/CD. It works with Azure DevOps, Terraform, GitHub and GitHub Actions. The repository describes itself as: This is the repository supporting the SAP deployment automation framework on Azure. The licence is MIT.

When your agent uses it

  • A user says what does test do in SDAF
  • Is this a real dry run
  • Plan-only vs apply
  • Workflow 01 dry-run

Example prompts

  • “what does test do in SDAF”
  • “is this a real dry run”
  • “plan-only vs apply”
  • “/sdaf-plan-and-test-semantics”

Requirements

  • Pre-approved tools (allowed-tools): shell

What it can do on your machine

Read from SKILL.md and the folder at commit 78835f0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • shell

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sdaf Plan And Test Semantics loads about 1.6k tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 202 tokens; SKILL.md has 684 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~202
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Azure/sap-automation at commit 78835f0, republished under its MIT licence (© Azure). 684 words, ~1,602 tokens.

Download SKILL.mdSave it as .claude/skills/sdaf-plan-and-test-semantics/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
sdaf-plan-and-test-semantics
description
Explain SDAF plan-only / test / apply semantics without pretending they are universal. Compares the documented Local commands, Azure DevOps wrapper pipelines, and GitHub Actions workflows for control plane, workload zone, and SAP system: local stage commands show Terraform plans and then apply after approval; ADO/GitHub workload-zone and SAP-system test runs stop after the plan; the current hosted control-plane test options do not provide a plan-only run. Use when a user says "what does test do in SDAF", "is this a real dry run", "plan-only vs apply", "workflow 01 dry-run", "pipeline 02 test", or "TEST_ONLY". Do NOT use to actually deploy a stage or to triage a failed run (see sdaf-control-plane-bootstrap / sdaf-workload-zone / sdaf-sap-system / sdaf-failure-triage).
allowed-tools
shell
license
MIT

SDAF Plan and Test Semantics

Context-primer. Answers "what does test / plan-only / apply mean here?" across surfaces. Canonical rule: there is no SDAF-wide dry-run switch. Classify by execution surface and deployment stage before answering.

For the file-by-file evidence matrix, including the hosted wrapper docs and workflow/pipeline paths, see references/plan-test-matrix.md.

When to invoke

Trigger on: "what does test do", "is this a dry run", "plan-only vs apply", "control-plane dry-run limitation", "workflow 01 dry-run", "pipeline 02 test", "TEST_ONLY", "which SDAF stages can review a Terraform plan without applying".

Do NOT trigger on: actually deploying a control plane / workload zone / SAP system, or triaging a failed run after the fact.

Rule zero — identify the surface and stage first

docs/deployment-options.md is explicit that Local, Azure DevOps, and GitHub Actions are different execution models. Never answer "test means X in SDAF" without naming:

  • the surface (Local / ADO / GitHub); and
  • the stage (control plane / workload zone / SAP system).

The shortest correct answer

PathWhat plan/test meansWhat apply means
Local control planeNo separate documented test switch. deploy_controlplane.sh displays Terraform plans and asks for approval before apply.The same run applies after operator approval.
Local workload zoneNo separate documented local test path. install_workloadzone.sh shows the plan and waits for approval.The same run applies after approval.
Local SAP systemNo separate documented local test path. installer.sh shows the plan and waits for approval.The same run applies after approval.
ADO control plane (01)test exists on the wrapper/template, but current docs say it is not forwarded to the control-plane scripts. Treat it as not plan-only.The queued run is state-changing.
ADO workload zone (02)test: true becomes TEST_ONLY and the hosted installer exits after Terraform plan.Re-queue the same pipeline with test: false.
ADO SAP system (03)test: true becomes TEST_ONLY and the hosted installer exits after Terraform plan.Re-queue the same pipeline with test: false.
GitHub control plane (01)The workflow exposes a dry-run input, but the docs say it does not reach either control-plane script.Treat the run as state-changing; get a reviewed control-plane plan through a separately validated SDAF path first.
GitHub workload zone (03)Enable the test option, review the plan, then rerun with test disabled. The workflow exports TEST_ONLY.Re-dispatch workflow 03 with test disabled.
GitHub SAP system (05)Enable the test option, review the plan, then rerun with test disabled. The workflow exports TEST_ONLY.Re-dispatch workflow 05 with test disabled.
Show full SKILL.md (284 more words)Show less

Local / scripted semantics

For local execution, the docs do not define a universal test flag that operators should export by hand. Instead, the documented stage commands themselves are the review gate:

  • docs/local/03-00-control-plane.md § Run: deploy_controlplane.sh displays Terraform plans and asks for approval before apply.
  • docs/local/04-00-workload-zone.md § Run: install_workloadzone.sh displays the plan and asks for approval before apply.
  • docs/local/05-00-sap-system.md § Run: installer.sh displays the plan and asks for approval before apply.

If the operator is on Local, answer with the documented stage command, not with a hosted-only TEST_ONLY story.

Hosted semantics

This is the boundary that prevents most bad advice:

For Azure DevOps or GitHub Actions, answer from the documented pipeline or workflow inputs and outcomes. Do not transfer Local behavior to hosted automation merely because both surfaces use the word test.

Control-plane special case

The control plane is different from workload zone and SAP system:

  • Local control-plane docs rely on interactive plan review inside the documented run.
  • Current ADO and GitHub control-plane wrappers expose a test/dry-run input, but the reviewed docs say that input is not forwarded to the control-plane scripts.

So the correct answer to "is control-plane test safe?" is no for the hosted wrappers as currently documented.

Hard rules

  • Do not claim there is a single SDAF-wide dry-run flag.
  • Do not transfer Local behavior to hosted automation or vice versa.
  • Do not tell an operator to rely on ADO/GitHub control-plane test as a safety gate.
  • For local operator-reviewed deployment, do not add --auto-approve (docs/local/03-00-control-plane.md § Review before execution; docs/local/04-00-workload-zone.md § Review before execution; docs/local/05-00-sap-system.md § Review before execution).

Hand-off

  • Actual control-plane execution → sdaf-control-plane-bootstrap
  • Actual workload-zone execution → sdaf-workload-zone
  • Actual SAP-system execution → sdaf-sap-system
  • Failed / contradictory run outcomes → sdaf-failure-triage

See also

  • references/plan-test-matrix.md
  • sdaf-control-plane-bootstrap, sdaf-workload-zone, sdaf-sap-system, sdaf-failure-triage
  • docs/deployment-options.md, docs/local/README.md, docs/local/03-00-control-plane.md, docs/local/04-00-workload-zone.md, docs/local/05-00-sap-system.md

© Azure, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/sdaf-plan-and-test-semantics of Azure/sap-automation.

  • SKILL.md
  • references/plan-test-matrix.md

Open the folder on GitHubat commit 78835f0

Compare with similar skills

Sdaf Plan And Test Semantics next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sdaf Plan And Test Semantics compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sdaf Plan And Test Semantics this skillAzure/sap-automation145—~1.6kAutomated safety check: PassMIT
Tirith PoliciesStackGuardian/tirith170—~1.8kAutomated safety check: PassApache-2.0
APIOps Deployment for Azure APIMthomast1906/github-copilot-agent-skills202—~3.6kAutomated safety check: PassMIT
AWS GitHub Oidc Scoped Rolemizchi/skills356—~1.6kAutomated safety check: PassNone
Devops Pipelineluongnv89/skills131—~4.8kAutomated safety check: PassMIT
Oraclecloud CI Integrationjeremylongshore/tons-of-skills-marketplace2.8k—~2kAutomated safety check: PassMIT

Similar skills

  • Tirith Policies

    StackGuardian/tirith

    Write, validate, run and debug Tirith IaC governance policies, install Tirith, and add it to a CI pipeline (GitHub Actions, GitLab CI, Bitbucket Pipelines, Jenkins, Azure DevOps, CircleCI or any…

    170 GitHub stars~1.8k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • APIOps Deployment for Azure APIM

    thomast1906/github-copilot-agent-skills

    Supplies Bicep and Terraform templates, CI/CD pipeline patterns and phased promotion plans for deploying Azure API Management with APIOps workflows.

    202 GitHub stars~3.6k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • OpenTofu/Terraform pattern for GitHub Actions OIDC trust with AWS IAM.

    356 GitHub stars~1.6k tokensUpdated 6 days ago
    DevOps & CloudAuto-check passed
  • Devops Pipeline

    luongnv89/skills

    Configure pre-commit hooks and lean GitHub Actions for shift-left quality assurance.

    131 GitHub stars~4.8k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Oraclecloud CI Integration

    jeremylongshore/tons-of-skills-marketplace

    Configure CI/CD pipelines for OCI with Terraform and GitHub Actions.

    2.8k GitHub stars~2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Senior DevOps Toolkit

    maslennikov-ig/claude-code-orchestrator-kit

    Comprehensive DevOps skill for CI/CD, infrastructure automation, containerization, and cloud platforms (AWS, GCP, Azure). Includes pipeline setup…

    260 GitHub starsUsed in 6 repos~1.1k tokens
    DevOps & CloudAuto-check: notes

More from Azure/sap-automation

All 19 skills in this repo
  • Sdaf Bom Selection

    Azure/sap-automation

    Official

    Pick the right SDAF BOM for a target SAP product / release / DB platform / version / kernel / topology.

    145 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Sdaf Orientation And Surface

    Azure/sap-automation

    Official

    Orient a newcomer to the SAP Deployment Automation Framework (SDAF): explain the spine (control plane → workload zone → SAP system → software → install → operate/remove), summarise the three…

    145 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Sdaf Quality Assurance

    Azure/sap-automation

    Official

    Validate a deployed SDAF SAP system through the SDAF-owned QA entry points: the local quality-assurance menu and the documented Azure DevOps pipeline 13 path.

    145 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Sdaf Sap Installation

    Azure/sap-automation

    Official

    Guide SDAF operating-system, database, and SAP installation after the SAP-system workspace and reviewed media are ready.

    145 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Sdaf Sovereign Cloud

    Azure/sap-automation

    Official

    Explain the current SDAF sovereign-cloud deltas without inventing a generic "all sovereigns" runbook.

    145 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Sdaf State Management

    Azure/sap-automation

    Official

    Inspect and repair SDAF Terraform state safely before any reviewed import/remove.

    145 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Sdaf Plan And Test Semantics

What does Sdaf Plan And Test Semantics do?

Explain SDAF plan-only / test / apply semantics without pretending they are universal. Sdaf Plan And Test Semantics is an agent skill from Azure/sap-automation, published by the product's own GitHub organization. Explain SDAF plan-only / test / apply semantics without pretending they are universal.

When should I use Sdaf Plan And Test Semantics?

Sdaf Plan And Test Semantics fits situations like: A user says what does test do in SDAF; is this a real dry run; plan-only vs apply; workflow 01 dry-run.

How do I install Sdaf Plan And Test Semantics in Claude Code?

Run `npx skills add Azure/sap-automation --skill sdaf-plan-and-test-semantics -a claude-code`. Or copy the skill folder (skills/sdaf-plan-and-test-semantics in Azure/sap-automation) into .claude/skills/sdaf-plan-and-test-semantics in your project. Claude Code loads it when a task matches its description.

How do I install Sdaf Plan And Test Semantics in Codex?

Run `npx skills add Azure/sap-automation --skill sdaf-plan-and-test-semantics -a codex`. Or copy the skill folder (skills/sdaf-plan-and-test-semantics in Azure/sap-automation) into .agents/skills/sdaf-plan-and-test-semantics in your project. Codex loads it when a task matches its description.

Can I use Sdaf Plan And Test Semantics in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Azure/sap-automation --skill sdaf-plan-and-test-semantics -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sdaf-plan-and-test-semantics, .gemini/skills/sdaf-plan-and-test-semantics, .github/skills/sdaf-plan-and-test-semantics and .opencode/skills/sdaf-plan-and-test-semantics in your project.

What does Sdaf Plan And Test Semantics need to run?

SKILL.md names no scripts, command-line tools or credentials: Sdaf Plan And Test Semantics is instructions for the agent only. Its frontmatter pre-approves these tools: shell.

Does Sdaf Plan And Test Semantics access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Sdaf Plan And Test Semantics safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Sdaf Plan And Test Semantics use?

Sdaf Plan And Test Semantics is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sdaf Plan And Test Semantics use?

About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 297 tokens, read only when the agent opens those files.

What are the alternatives to Sdaf Plan And Test Semantics?

Skills that share tags, products or a category with Sdaf Plan And Test Semantics: Tirith Policies (StackGuardian/tirith, 170 stars), APIOps Deployment for Azure APIM (thomast1906/github-copilot-agent-skills, 202 stars), AWS GitHub Oidc Scoped Role (mizchi/skills, 356 stars) and Devops Pipeline (luongnv89/skills, 131 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sdaf Plan And Test Semantics?

Azure (a GitHub organization, an official publisher) maintains it in Azure/sap-automation, which has 145 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 7, 2026.

Source: Azure/sap-automation on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.