[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-azure-sdaf-plan-and-test-semantics":3,"mdc--ty6mp5-key":38,"related-org-azure-sdaf-plan-and-test-semantics":916,"related-repo-azure-sdaf-plan-and-test-semantics":1081},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":27,"repoUrl":28,"updatedAt":29,"license":30,"forks":31,"topics":32,"repo":33,"sourceUrl":36,"mdContent":37},"sdaf-plan-and-test-semantics","manage SDAF plan and test semantics","Explain SDAF plan-only \u002F test \u002F 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\u002FGitHub 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 \u002F sdaf-workload-zone \u002F sdaf-sap-system \u002F sdaf-failure-triage).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},"azure","Azure (Microsoft)","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fazure.png","Azure",[13,15,18,21,24],{"name":11,"slug":8,"type":14},"tag",{"name":16,"slug":17,"type":14},"GitHub Actions","github-actions",{"name":19,"slug":20,"type":14},"Automation","automation",{"name":22,"slug":23,"type":14},"Azure DevOps","azure-devops",{"name":25,"slug":26,"type":14},"CI\u002FCD","ci-cd",143,"https:\u002F\u002Fgithub.com\u002FAzure\u002Fsap-automation","2026-09-02T07:48:08.951811","MIT",173,[],{"repoUrl":28,"stars":27,"forks":31,"topics":34,"description":35},[],"This is the repository supporting the SAP deployment automation framework on Azure","https:\u002F\u002Fgithub.com\u002FAzure\u002Fsap-automation\u002Ftree\u002FHEAD\u002Fskills\u002Fsdaf-plan-and-test-semantics","---\nname: sdaf-plan-and-test-semantics\ndescription: >\n  Explain SDAF plan-only \u002F test \u002F apply semantics without pretending they are\n  universal. Compares the documented Local commands, Azure DevOps wrapper\n  pipelines, and GitHub Actions workflows for control plane, workload zone,\n  and SAP system: local stage commands show Terraform plans and then apply\n  after approval; ADO\u002FGitHub workload-zone and SAP-system test runs stop after\n  the plan; the current hosted control-plane test options do not provide a\n  plan-only run. Use when a user says \"what does test do in SDAF\", \"is this a\n  real dry run\", \"plan-only vs apply\", \"workflow 01 dry-run\", \"pipeline 02\n  test\", or \"TEST_ONLY\". Do NOT use to actually deploy a stage or to triage a\n  failed run (see\n  sdaf-control-plane-bootstrap \u002F sdaf-workload-zone \u002F sdaf-sap-system \u002F\n  sdaf-failure-triage).\nallowed-tools: shell\nlicense: MIT\n---\n\n# SDAF Plan and Test Semantics\n\nContext-primer. Answers *\"what does test \u002F plan-only \u002F apply mean here?\"*\nacross surfaces. Canonical rule: **there is no SDAF-wide dry-run switch**.\nClassify by execution surface and deployment stage before answering.\n\nFor the file-by-file evidence matrix, including the hosted wrapper docs and\nworkflow\u002Fpipeline paths, see\n[`references\u002Fplan-test-matrix.md`](references\u002Fplan-test-matrix.md).\n\n## When to invoke\n\nTrigger on: \"what does test do\", \"is this a dry run\", \"plan-only vs apply\",\n\"control-plane dry-run limitation\", \"workflow 01 dry-run\", \"pipeline 02\ntest\", \"TEST_ONLY\", \"which SDAF stages can review a Terraform plan without\napplying\".\n\nDo NOT trigger on: actually deploying a control plane \u002F workload zone \u002F SAP\nsystem, or triaging a failed run after the fact.\n\n## Rule zero — identify the surface and stage first\n\n`docs\u002Fdeployment-options.md` is explicit that Local, Azure DevOps, and GitHub\nActions are different execution models. Never answer *\"test means X in\nSDAF\"* without naming:\n\n- the surface (Local \u002F ADO \u002F GitHub); and\n- the stage (control plane \u002F workload zone \u002F SAP system).\n\n## The shortest correct answer\n\n| Path | What plan\u002Ftest means | What apply means |\n|---|---|---|\n| **Local control plane** | No separate documented `test` switch. `deploy_controlplane.sh` displays Terraform plans and asks for approval before apply. | The same run applies after operator approval. |\n| **Local workload zone** | No separate documented local `test` path. `install_workloadzone.sh` shows the plan and waits for approval. | The same run applies after approval. |\n| **Local SAP system** | No separate documented local `test` path. `installer.sh` shows the plan and waits for approval. | The same run applies after approval. |\n| **ADO control plane (`01`)** | `test` exists on the wrapper\u002Ftemplate, 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. |\n| **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`. |\n| **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`. |\n| **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. |\n| **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. |\n| **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. |\n\n## Local \u002F scripted semantics\n\nFor local execution, the docs do **not** define a universal `test` flag that\noperators should export by hand. Instead, the documented stage commands\nthemselves are the review gate:\n\n- `docs\u002Flocal\u002F03-00-control-plane.md § Run`: `deploy_controlplane.sh`\n  displays Terraform plans and asks for approval before apply.\n- `docs\u002Flocal\u002F04-00-workload-zone.md § Run`: `install_workloadzone.sh`\n  displays the plan and asks for approval before apply.\n- `docs\u002Flocal\u002F05-00-sap-system.md § Run`: `installer.sh` displays the plan\n  and asks for approval before apply.\n\nIf the operator is on Local, answer with the documented stage command, not\nwith a hosted-only `TEST_ONLY` story.\n\n## Hosted semantics\n\nThis is the boundary that prevents most bad advice:\n\nFor Azure DevOps or GitHub Actions, answer from the documented pipeline or\nworkflow inputs and outcomes. Do not transfer Local behavior to hosted\nautomation merely because both surfaces use the word `test`.\n\n## Control-plane special case\n\nThe control plane is different from workload zone and SAP system:\n\n- Local control-plane docs rely on interactive plan review inside the\n  documented run.\n- Current ADO and GitHub control-plane wrappers expose a `test`\u002Fdry-run\n  input, but the reviewed docs say that input is not forwarded to the\n  control-plane scripts.\n\nSo the correct answer to *\"is control-plane `test` safe?\"* is **no for the\nhosted wrappers as currently documented**.\n\n## Hard rules\n\n- Do not claim there is a single SDAF-wide dry-run flag.\n- Do not transfer Local behavior to hosted automation or vice versa.\n- Do not tell an operator to rely on ADO\u002FGitHub control-plane `test` as a\n  safety gate.\n- For local operator-reviewed deployment, do not add `--auto-approve`\n  (`docs\u002Flocal\u002F03-00-control-plane.md § Review before execution`;\n  `docs\u002Flocal\u002F04-00-workload-zone.md § Review before execution`;\n  `docs\u002Flocal\u002F05-00-sap-system.md § Review before execution`).\n\n## Hand-off\n\n- Actual control-plane execution → `sdaf-control-plane-bootstrap`\n- Actual workload-zone execution → `sdaf-workload-zone`\n- Actual SAP-system execution → `sdaf-sap-system`\n- Failed \u002F contradictory run outcomes → `sdaf-failure-triage`\n\n## See also\n\n- [`references\u002Fplan-test-matrix.md`](references\u002Fplan-test-matrix.md)\n- `sdaf-control-plane-bootstrap`, `sdaf-workload-zone`, `sdaf-sap-system`,\n  `sdaf-failure-triage`\n- `docs\u002Fdeployment-options.md`, `docs\u002Flocal\u002FREADME.md`,\n  `docs\u002Flocal\u002F03-00-control-plane.md`, `docs\u002Flocal\u002F04-00-workload-zone.md`,\n  `docs\u002Flocal\u002F05-00-sap-system.md`\n",{"data":39,"body":41},{"name":4,"description":6,"allowed-tools":40,"license":30},"shell",{"type":42,"children":43},"root",[44,52,74,92,99,104,109,115,133,148,154,543,549,567,622,634,640,645,656,662,667,687,712,718,779,785,832,838],{"type":45,"tag":46,"props":47,"children":48},"element","h1",{"id":4},[49],{"type":50,"value":51},"text","SDAF Plan and Test Semantics",{"type":45,"tag":53,"props":54,"children":55},"p",{},[56,58,64,66,72],{"type":50,"value":57},"Context-primer. Answers ",{"type":45,"tag":59,"props":60,"children":61},"em",{},[62],{"type":50,"value":63},"\"what does test \u002F plan-only \u002F apply mean here?\"",{"type":50,"value":65},"\nacross surfaces. Canonical rule: ",{"type":45,"tag":67,"props":68,"children":69},"strong",{},[70],{"type":50,"value":71},"there is no SDAF-wide dry-run switch",{"type":50,"value":73},".\nClassify by execution surface and deployment stage before answering.",{"type":45,"tag":53,"props":75,"children":76},{},[77,79,90],{"type":50,"value":78},"For the file-by-file evidence matrix, including the hosted wrapper docs and\nworkflow\u002Fpipeline paths, see\n",{"type":45,"tag":80,"props":81,"children":83},"a",{"href":82},"references\u002Fplan-test-matrix.md",[84],{"type":45,"tag":85,"props":86,"children":88},"code",{"className":87},[],[89],{"type":50,"value":82},{"type":50,"value":91},".",{"type":45,"tag":93,"props":94,"children":96},"h2",{"id":95},"when-to-invoke",[97],{"type":50,"value":98},"When to invoke",{"type":45,"tag":53,"props":100,"children":101},{},[102],{"type":50,"value":103},"Trigger on: \"what does test do\", \"is this a dry run\", \"plan-only vs apply\",\n\"control-plane dry-run limitation\", \"workflow 01 dry-run\", \"pipeline 02\ntest\", \"TEST_ONLY\", \"which SDAF stages can review a Terraform plan without\napplying\".",{"type":45,"tag":53,"props":105,"children":106},{},[107],{"type":50,"value":108},"Do NOT trigger on: actually deploying a control plane \u002F workload zone \u002F SAP\nsystem, or triaging a failed run after the fact.",{"type":45,"tag":93,"props":110,"children":112},{"id":111},"rule-zero-identify-the-surface-and-stage-first",[113],{"type":50,"value":114},"Rule zero — identify the surface and stage first",{"type":45,"tag":53,"props":116,"children":117},{},[118,124,126,131],{"type":45,"tag":85,"props":119,"children":121},{"className":120},[],[122],{"type":50,"value":123},"docs\u002Fdeployment-options.md",{"type":50,"value":125}," is explicit that Local, Azure DevOps, and GitHub\nActions are different execution models. Never answer ",{"type":45,"tag":59,"props":127,"children":128},{},[129],{"type":50,"value":130},"\"test means X in\nSDAF\"",{"type":50,"value":132}," without naming:",{"type":45,"tag":134,"props":135,"children":136},"ul",{},[137,143],{"type":45,"tag":138,"props":139,"children":140},"li",{},[141],{"type":50,"value":142},"the surface (Local \u002F ADO \u002F GitHub); and",{"type":45,"tag":138,"props":144,"children":145},{},[146],{"type":50,"value":147},"the stage (control plane \u002F workload zone \u002F SAP system).",{"type":45,"tag":93,"props":149,"children":151},{"id":150},"the-shortest-correct-answer",[152],{"type":50,"value":153},"The shortest correct answer",{"type":45,"tag":155,"props":156,"children":157},"table",{},[158,182],{"type":45,"tag":159,"props":160,"children":161},"thead",{},[162],{"type":45,"tag":163,"props":164,"children":165},"tr",{},[166,172,177],{"type":45,"tag":167,"props":168,"children":169},"th",{},[170],{"type":50,"value":171},"Path",{"type":45,"tag":167,"props":173,"children":174},{},[175],{"type":50,"value":176},"What plan\u002Ftest means",{"type":45,"tag":167,"props":178,"children":179},{},[180],{"type":50,"value":181},"What apply means",{"type":45,"tag":183,"props":184,"children":185},"tbody",{},[186,224,260,292,339,388,431,465,505],{"type":45,"tag":163,"props":187,"children":188},{},[189,198,219],{"type":45,"tag":190,"props":191,"children":192},"td",{},[193],{"type":45,"tag":67,"props":194,"children":195},{},[196],{"type":50,"value":197},"Local control plane",{"type":45,"tag":190,"props":199,"children":200},{},[201,203,209,211,217],{"type":50,"value":202},"No separate documented ",{"type":45,"tag":85,"props":204,"children":206},{"className":205},[],[207],{"type":50,"value":208},"test",{"type":50,"value":210}," switch. ",{"type":45,"tag":85,"props":212,"children":214},{"className":213},[],[215],{"type":50,"value":216},"deploy_controlplane.sh",{"type":50,"value":218}," displays Terraform plans and asks for approval before apply.",{"type":45,"tag":190,"props":220,"children":221},{},[222],{"type":50,"value":223},"The same run applies after operator approval.",{"type":45,"tag":163,"props":225,"children":226},{},[227,235,255],{"type":45,"tag":190,"props":228,"children":229},{},[230],{"type":45,"tag":67,"props":231,"children":232},{},[233],{"type":50,"value":234},"Local workload zone",{"type":45,"tag":190,"props":236,"children":237},{},[238,240,245,247,253],{"type":50,"value":239},"No separate documented local ",{"type":45,"tag":85,"props":241,"children":243},{"className":242},[],[244],{"type":50,"value":208},{"type":50,"value":246}," path. ",{"type":45,"tag":85,"props":248,"children":250},{"className":249},[],[251],{"type":50,"value":252},"install_workloadzone.sh",{"type":50,"value":254}," shows the plan and waits for approval.",{"type":45,"tag":190,"props":256,"children":257},{},[258],{"type":50,"value":259},"The same run applies after approval.",{"type":45,"tag":163,"props":261,"children":262},{},[263,271,288],{"type":45,"tag":190,"props":264,"children":265},{},[266],{"type":45,"tag":67,"props":267,"children":268},{},[269],{"type":50,"value":270},"Local SAP system",{"type":45,"tag":190,"props":272,"children":273},{},[274,275,280,281,287],{"type":50,"value":239},{"type":45,"tag":85,"props":276,"children":278},{"className":277},[],[279],{"type":50,"value":208},{"type":50,"value":246},{"type":45,"tag":85,"props":282,"children":284},{"className":283},[],[285],{"type":50,"value":286},"installer.sh",{"type":50,"value":254},{"type":45,"tag":190,"props":289,"children":290},{},[291],{"type":50,"value":259},{"type":45,"tag":163,"props":293,"children":294},{},[295,311,334],{"type":45,"tag":190,"props":296,"children":297},{},[298],{"type":45,"tag":67,"props":299,"children":300},{},[301,303,309],{"type":50,"value":302},"ADO control plane (",{"type":45,"tag":85,"props":304,"children":306},{"className":305},[],[307],{"type":50,"value":308},"01",{"type":50,"value":310},")",{"type":45,"tag":190,"props":312,"children":313},{},[314,319,321,326,328,333],{"type":45,"tag":85,"props":315,"children":317},{"className":316},[],[318],{"type":50,"value":208},{"type":50,"value":320}," exists on the wrapper\u002Ftemplate, but current docs say it is ",{"type":45,"tag":67,"props":322,"children":323},{},[324],{"type":50,"value":325},"not forwarded",{"type":50,"value":327}," to the control-plane scripts. Treat it as ",{"type":45,"tag":67,"props":329,"children":330},{},[331],{"type":50,"value":332},"not plan-only",{"type":50,"value":91},{"type":45,"tag":190,"props":335,"children":336},{},[337],{"type":50,"value":338},"The queued run is state-changing.",{"type":45,"tag":163,"props":340,"children":341},{},[342,357,376],{"type":45,"tag":190,"props":343,"children":344},{},[345],{"type":45,"tag":67,"props":346,"children":347},{},[348,350,356],{"type":50,"value":349},"ADO workload zone (",{"type":45,"tag":85,"props":351,"children":353},{"className":352},[],[354],{"type":50,"value":355},"02",{"type":50,"value":310},{"type":45,"tag":190,"props":358,"children":359},{},[360,366,368,374],{"type":45,"tag":85,"props":361,"children":363},{"className":362},[],[364],{"type":50,"value":365},"test: true",{"type":50,"value":367}," becomes ",{"type":45,"tag":85,"props":369,"children":371},{"className":370},[],[372],{"type":50,"value":373},"TEST_ONLY",{"type":50,"value":375}," and the hosted installer exits after Terraform plan.",{"type":45,"tag":190,"props":377,"children":378},{},[379,381,387],{"type":50,"value":380},"Re-queue the same pipeline with ",{"type":45,"tag":85,"props":382,"children":384},{"className":383},[],[385],{"type":50,"value":386},"test: false",{"type":50,"value":91},{"type":45,"tag":163,"props":389,"children":390},{},[391,406,421],{"type":45,"tag":190,"props":392,"children":393},{},[394],{"type":45,"tag":67,"props":395,"children":396},{},[397,399,405],{"type":50,"value":398},"ADO SAP system (",{"type":45,"tag":85,"props":400,"children":402},{"className":401},[],[403],{"type":50,"value":404},"03",{"type":50,"value":310},{"type":45,"tag":190,"props":407,"children":408},{},[409,414,415,420],{"type":45,"tag":85,"props":410,"children":412},{"className":411},[],[413],{"type":50,"value":365},{"type":50,"value":367},{"type":45,"tag":85,"props":416,"children":418},{"className":417},[],[419],{"type":50,"value":373},{"type":50,"value":375},{"type":45,"tag":190,"props":422,"children":423},{},[424,425,430],{"type":50,"value":380},{"type":45,"tag":85,"props":426,"children":428},{"className":427},[],[429],{"type":50,"value":386},{"type":50,"value":91},{"type":45,"tag":163,"props":432,"children":433},{},[434,448,460],{"type":45,"tag":190,"props":435,"children":436},{},[437],{"type":45,"tag":67,"props":438,"children":439},{},[440,442,447],{"type":50,"value":441},"GitHub control plane (",{"type":45,"tag":85,"props":443,"children":445},{"className":444},[],[446],{"type":50,"value":308},{"type":50,"value":310},{"type":45,"tag":190,"props":449,"children":450},{},[451,453,458],{"type":50,"value":452},"The workflow exposes a dry-run input, but the docs say it does ",{"type":45,"tag":67,"props":454,"children":455},{},[456],{"type":50,"value":457},"not",{"type":50,"value":459}," reach either control-plane script.",{"type":45,"tag":190,"props":461,"children":462},{},[463],{"type":50,"value":464},"Treat the run as state-changing; get a reviewed control-plane plan through a separately validated SDAF path first.",{"type":45,"tag":163,"props":466,"children":467},{},[468,482,493],{"type":45,"tag":190,"props":469,"children":470},{},[471],{"type":45,"tag":67,"props":472,"children":473},{},[474,476,481],{"type":50,"value":475},"GitHub workload zone (",{"type":45,"tag":85,"props":477,"children":479},{"className":478},[],[480],{"type":50,"value":404},{"type":50,"value":310},{"type":45,"tag":190,"props":483,"children":484},{},[485,487,492],{"type":50,"value":486},"Enable the test option, review the plan, then rerun with test disabled. The workflow exports ",{"type":45,"tag":85,"props":488,"children":490},{"className":489},[],[491],{"type":50,"value":373},{"type":50,"value":91},{"type":45,"tag":190,"props":494,"children":495},{},[496,498,503],{"type":50,"value":497},"Re-dispatch workflow ",{"type":45,"tag":85,"props":499,"children":501},{"className":500},[],[502],{"type":50,"value":404},{"type":50,"value":504}," with test disabled.",{"type":45,"tag":163,"props":506,"children":507},{},[508,523,533],{"type":45,"tag":190,"props":509,"children":510},{},[511],{"type":45,"tag":67,"props":512,"children":513},{},[514,516,522],{"type":50,"value":515},"GitHub SAP system (",{"type":45,"tag":85,"props":517,"children":519},{"className":518},[],[520],{"type":50,"value":521},"05",{"type":50,"value":310},{"type":45,"tag":190,"props":524,"children":525},{},[526,527,532],{"type":50,"value":486},{"type":45,"tag":85,"props":528,"children":530},{"className":529},[],[531],{"type":50,"value":373},{"type":50,"value":91},{"type":45,"tag":190,"props":534,"children":535},{},[536,537,542],{"type":50,"value":497},{"type":45,"tag":85,"props":538,"children":540},{"className":539},[],[541],{"type":50,"value":521},{"type":50,"value":504},{"type":45,"tag":93,"props":544,"children":546},{"id":545},"local-scripted-semantics",[547],{"type":50,"value":548},"Local \u002F scripted semantics",{"type":45,"tag":53,"props":550,"children":551},{},[552,554,558,560,565],{"type":50,"value":553},"For local execution, the docs do ",{"type":45,"tag":67,"props":555,"children":556},{},[557],{"type":50,"value":457},{"type":50,"value":559}," define a universal ",{"type":45,"tag":85,"props":561,"children":563},{"className":562},[],[564],{"type":50,"value":208},{"type":50,"value":566}," flag that\noperators should export by hand. Instead, the documented stage commands\nthemselves are the review gate:",{"type":45,"tag":134,"props":568,"children":569},{},[570,588,605],{"type":45,"tag":138,"props":571,"children":572},{},[573,579,581,586],{"type":45,"tag":85,"props":574,"children":576},{"className":575},[],[577],{"type":50,"value":578},"docs\u002Flocal\u002F03-00-control-plane.md § Run",{"type":50,"value":580},": ",{"type":45,"tag":85,"props":582,"children":584},{"className":583},[],[585],{"type":50,"value":216},{"type":50,"value":587},"\ndisplays Terraform plans and asks for approval before apply.",{"type":45,"tag":138,"props":589,"children":590},{},[591,597,598,603],{"type":45,"tag":85,"props":592,"children":594},{"className":593},[],[595],{"type":50,"value":596},"docs\u002Flocal\u002F04-00-workload-zone.md § Run",{"type":50,"value":580},{"type":45,"tag":85,"props":599,"children":601},{"className":600},[],[602],{"type":50,"value":252},{"type":50,"value":604},"\ndisplays the plan and asks for approval before apply.",{"type":45,"tag":138,"props":606,"children":607},{},[608,614,615,620],{"type":45,"tag":85,"props":609,"children":611},{"className":610},[],[612],{"type":50,"value":613},"docs\u002Flocal\u002F05-00-sap-system.md § Run",{"type":50,"value":580},{"type":45,"tag":85,"props":616,"children":618},{"className":617},[],[619],{"type":50,"value":286},{"type":50,"value":621}," displays the plan\nand asks for approval before apply.",{"type":45,"tag":53,"props":623,"children":624},{},[625,627,632],{"type":50,"value":626},"If the operator is on Local, answer with the documented stage command, not\nwith a hosted-only ",{"type":45,"tag":85,"props":628,"children":630},{"className":629},[],[631],{"type":50,"value":373},{"type":50,"value":633}," story.",{"type":45,"tag":93,"props":635,"children":637},{"id":636},"hosted-semantics",[638],{"type":50,"value":639},"Hosted semantics",{"type":45,"tag":53,"props":641,"children":642},{},[643],{"type":50,"value":644},"This is the boundary that prevents most bad advice:",{"type":45,"tag":53,"props":646,"children":647},{},[648,650,655],{"type":50,"value":649},"For Azure DevOps or GitHub Actions, answer from the documented pipeline or\nworkflow inputs and outcomes. Do not transfer Local behavior to hosted\nautomation merely because both surfaces use the word ",{"type":45,"tag":85,"props":651,"children":653},{"className":652},[],[654],{"type":50,"value":208},{"type":50,"value":91},{"type":45,"tag":93,"props":657,"children":659},{"id":658},"control-plane-special-case",[660],{"type":50,"value":661},"Control-plane special case",{"type":45,"tag":53,"props":663,"children":664},{},[665],{"type":50,"value":666},"The control plane is different from workload zone and SAP system:",{"type":45,"tag":134,"props":668,"children":669},{},[670,675],{"type":45,"tag":138,"props":671,"children":672},{},[673],{"type":50,"value":674},"Local control-plane docs rely on interactive plan review inside the\ndocumented run.",{"type":45,"tag":138,"props":676,"children":677},{},[678,680,685],{"type":50,"value":679},"Current ADO and GitHub control-plane wrappers expose a ",{"type":45,"tag":85,"props":681,"children":683},{"className":682},[],[684],{"type":50,"value":208},{"type":50,"value":686},"\u002Fdry-run\ninput, but the reviewed docs say that input is not forwarded to the\ncontrol-plane scripts.",{"type":45,"tag":53,"props":688,"children":689},{},[690,692,704,706,711],{"type":50,"value":691},"So the correct answer to ",{"type":45,"tag":59,"props":693,"children":694},{},[695,697,702],{"type":50,"value":696},"\"is control-plane ",{"type":45,"tag":85,"props":698,"children":700},{"className":699},[],[701],{"type":50,"value":208},{"type":50,"value":703}," safe?\"",{"type":50,"value":705}," is ",{"type":45,"tag":67,"props":707,"children":708},{},[709],{"type":50,"value":710},"no for the\nhosted wrappers as currently documented",{"type":50,"value":91},{"type":45,"tag":93,"props":713,"children":715},{"id":714},"hard-rules",[716],{"type":50,"value":717},"Hard rules",{"type":45,"tag":134,"props":719,"children":720},{},[721,726,731,743],{"type":45,"tag":138,"props":722,"children":723},{},[724],{"type":50,"value":725},"Do not claim there is a single SDAF-wide dry-run flag.",{"type":45,"tag":138,"props":727,"children":728},{},[729],{"type":50,"value":730},"Do not transfer Local behavior to hosted automation or vice versa.",{"type":45,"tag":138,"props":732,"children":733},{},[734,736,741],{"type":50,"value":735},"Do not tell an operator to rely on ADO\u002FGitHub control-plane ",{"type":45,"tag":85,"props":737,"children":739},{"className":738},[],[740],{"type":50,"value":208},{"type":50,"value":742}," as a\nsafety gate.",{"type":45,"tag":138,"props":744,"children":745},{},[746,748,754,756,762,764,770,771,777],{"type":50,"value":747},"For local operator-reviewed deployment, do not add ",{"type":45,"tag":85,"props":749,"children":751},{"className":750},[],[752],{"type":50,"value":753},"--auto-approve",{"type":50,"value":755},"\n(",{"type":45,"tag":85,"props":757,"children":759},{"className":758},[],[760],{"type":50,"value":761},"docs\u002Flocal\u002F03-00-control-plane.md § Review before execution",{"type":50,"value":763},";\n",{"type":45,"tag":85,"props":765,"children":767},{"className":766},[],[768],{"type":50,"value":769},"docs\u002Flocal\u002F04-00-workload-zone.md § Review before execution",{"type":50,"value":763},{"type":45,"tag":85,"props":772,"children":774},{"className":773},[],[775],{"type":50,"value":776},"docs\u002Flocal\u002F05-00-sap-system.md § Review before execution",{"type":50,"value":778},").",{"type":45,"tag":93,"props":780,"children":782},{"id":781},"hand-off",[783],{"type":50,"value":784},"Hand-off",{"type":45,"tag":134,"props":786,"children":787},{},[788,799,810,821],{"type":45,"tag":138,"props":789,"children":790},{},[791,793],{"type":50,"value":792},"Actual control-plane execution → ",{"type":45,"tag":85,"props":794,"children":796},{"className":795},[],[797],{"type":50,"value":798},"sdaf-control-plane-bootstrap",{"type":45,"tag":138,"props":800,"children":801},{},[802,804],{"type":50,"value":803},"Actual workload-zone execution → ",{"type":45,"tag":85,"props":805,"children":807},{"className":806},[],[808],{"type":50,"value":809},"sdaf-workload-zone",{"type":45,"tag":138,"props":811,"children":812},{},[813,815],{"type":50,"value":814},"Actual SAP-system execution → ",{"type":45,"tag":85,"props":816,"children":818},{"className":817},[],[819],{"type":50,"value":820},"sdaf-sap-system",{"type":45,"tag":138,"props":822,"children":823},{},[824,826],{"type":50,"value":825},"Failed \u002F contradictory run outcomes → ",{"type":45,"tag":85,"props":827,"children":829},{"className":828},[],[830],{"type":50,"value":831},"sdaf-failure-triage",{"type":45,"tag":93,"props":833,"children":835},{"id":834},"see-also",[836],{"type":50,"value":837},"See also",{"type":45,"tag":134,"props":839,"children":840},{},[841,852,880],{"type":45,"tag":138,"props":842,"children":843},{},[844],{"type":45,"tag":80,"props":845,"children":846},{"href":82},[847],{"type":45,"tag":85,"props":848,"children":850},{"className":849},[],[851],{"type":50,"value":82},{"type":45,"tag":138,"props":853,"children":854},{},[855,860,862,867,868,873,875],{"type":45,"tag":85,"props":856,"children":858},{"className":857},[],[859],{"type":50,"value":798},{"type":50,"value":861},", ",{"type":45,"tag":85,"props":863,"children":865},{"className":864},[],[866],{"type":50,"value":809},{"type":50,"value":861},{"type":45,"tag":85,"props":869,"children":871},{"className":870},[],[872],{"type":50,"value":820},{"type":50,"value":874},",\n",{"type":45,"tag":85,"props":876,"children":878},{"className":877},[],[879],{"type":50,"value":831},{"type":45,"tag":138,"props":881,"children":882},{},[883,888,889,895,896,902,903,909,910],{"type":45,"tag":85,"props":884,"children":886},{"className":885},[],[887],{"type":50,"value":123},{"type":50,"value":861},{"type":45,"tag":85,"props":890,"children":892},{"className":891},[],[893],{"type":50,"value":894},"docs\u002Flocal\u002FREADME.md",{"type":50,"value":874},{"type":45,"tag":85,"props":897,"children":899},{"className":898},[],[900],{"type":50,"value":901},"docs\u002Flocal\u002F03-00-control-plane.md",{"type":50,"value":861},{"type":45,"tag":85,"props":904,"children":906},{"className":905},[],[907],{"type":50,"value":908},"docs\u002Flocal\u002F04-00-workload-zone.md",{"type":50,"value":874},{"type":45,"tag":85,"props":911,"children":913},{"className":912},[],[914],{"type":50,"value":915},"docs\u002Flocal\u002F05-00-sap-system.md",{"items":917,"total":1080},[918,937,956,970,982,999,1010,1023,1033,1046,1059,1067],{"slug":919,"name":919,"fn":920,"description":921,"org":922,"tags":923,"stars":934,"repoUrl":935,"updatedAt":936},"azure-arg-external-evaluation-policy-author","author and test Azure Resource Graph policies","Use when the user wants to author, design, or test an Azure Policy that queries Azure Resource Graph (ARG) at request-time — i.e. a policy whose deny\u002Faudit decision depends on data from elsewhere in the subscription (sibling\u002Fparent resource state, RG-wide invariants, multi-hop relationships, etc.). Formally called Azure Policy External Evaluation; sometimes referred to colloquially as \"Invoke\". Drives an iterative KQL co-design loop against the user's real subscription via `az graph query`, then emits a policy definition, assignment, `.http` test flow, and an `EXPLANATION.md` companion. Read-only; never provisions anything.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[924,925,928,931],{"name":11,"slug":8,"type":14},{"name":926,"slug":927,"type":14},"Compliance","compliance",{"name":929,"slug":930,"type":14},"Governance","governance",{"name":932,"slug":933,"type":14},"Policy","policy",1689,"https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-policy","2026-07-12T08:17:48.378432",{"slug":938,"name":938,"fn":939,"description":940,"org":941,"tags":942,"stars":953,"repoUrl":954,"updatedAt":955},"azure-blueprints-migration","migrate Azure Blueprints to Template Specs","Use when a user needs to migrate off Azure Blueprints (definitions and\u002For assignments) to Template Specs and Deployment Stacks before the January 31, 2027 retirement. Covers inventory, export, conversion to Bicep, policy decoupling, Template Spec publishing, Deployment Stack deployment with deny-settings, validation, and cutover.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[943,944,947,950],{"name":11,"slug":8,"type":14},{"name":945,"slug":946,"type":14},"Deployment","deployment",{"name":948,"slug":949,"type":14},"Infrastructure as Code","infrastructure-as-code",{"name":951,"slug":952,"type":14},"Migration","migration",261,"https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-blueprints","2026-08-20T03:28:18.136156",{"slug":957,"name":957,"fn":958,"description":959,"org":960,"tags":961,"stars":27,"repoUrl":28,"updatedAt":969},"sdaf-bom-selection","select SAP Bill of Materials","Pick the right SDAF BOM for a target SAP product \u002F release \u002F DB platform \u002F version \u002F kernel \u002F topology. Explains where BOMs live in the samples repo (`SAP\u002F` for whole products, `BOM\u002F` for components), decodes the `ms`, `v####`, and `latest` suffix conventions, points at the compatibility guardrails (`supportedPlatforms`, `supportedDBVersions`, `supportedKernels`), and reminds the operator that the download flow needs four explicit BOM keys in `sap-parameters.yaml`. Use when a user says \"which BOM do I use\", \"product BOM vs component BOM\", \"SAP samples BOM catalog\", \"BOM_CATALOG\", \"S4\u002F2023 BOM\", \"HANA BOM\", or \"how do I pick a BOM for HANA\u002FOracle\u002FDB2\u002FASE\". Do NOT use to author a new BOM, to acquire media (`sdaf-media-acquisition`), or to troubleshoot a checksum \u002F 404 (`sdaf-media-diagnostics`).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[962,963,966],{"name":11,"slug":8,"type":14},{"name":964,"slug":965,"type":14},"Configuration","configuration",{"name":967,"slug":968,"type":14},"SAP","sap","2026-09-02T07:47:45.597063",{"slug":798,"name":798,"fn":971,"description":972,"org":973,"tags":974,"stars":27,"repoUrl":28,"updatedAt":981},"deploy SDAF control plane infrastructure","Deploy the SDAF control plane locally: prepare DEPLOYER and LIBRARY tfvars, review the plan, run `deploy_controlplane.sh` per `docs\u002Flocal\u002F03-00-control-plane.md § Run`, and validate the deployer + library + state hand-off. Grounded in `docs\u002Flocal\u002F03-00-control-plane.md`. Use when a user says \"deploy the SDAF control plane\", \"run deploy_controlplane.sh\", \"bootstrap SDAF from an empty subscription\", \"install the deployer\" or \"create the SAP library\". Do NOT use for workload zone (see sdaf-workload-zone), SAP system (see sdaf-sap-system), removal (`sdaf-safe-removal`), or Azure Government \u002F sovereign-cloud deltas (`sdaf-sovereign-cloud`).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[975,976,977,980],{"name":11,"slug":8,"type":14},{"name":945,"slug":946,"type":14},{"name":978,"slug":979,"type":14},"Infrastructure","infrastructure",{"name":967,"slug":968,"type":14},"2026-09-02T07:46:51.573641",{"slug":831,"name":831,"fn":983,"description":984,"org":985,"tags":986,"stars":27,"repoUrl":28,"updatedAt":998},"triage failed SAP automation runs","Triage a failed or suspicious SDAF run: distinguish a real failure from a green no-op or a clean plan reported as failure, map the observed symptom to a documented cause in `docs\u002Flocal\u002Ftroubleshooting.md`, and hand off to the stage-owning skill for retry. Use when a user says \"SDAF run failed\", \"my deploy exited non-zero\", \"the plan was clean but exit 1\", \"the run said success but nothing was deployed\", \"state lock error\", \"unexpected replacement\", \"control plane stopped partway\", \"generated hosts.yaml missing\", \"workload-zone private endpoint failure\", \"workload-zone subnet policy failure\", or \"SDAF exit 2\". Do NOT use to actually deploy or to redesign the workspace layout.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[987,988,991,994,995],{"name":11,"slug":8,"type":14},{"name":989,"slug":990,"type":14},"Diagnostics","diagnostics",{"name":992,"slug":993,"type":14},"Operations","operations",{"name":967,"slug":968,"type":14},{"name":996,"slug":997,"type":14},"Triage","triage","2026-09-02T07:47:40.607437",{"slug":1000,"name":1000,"fn":1001,"description":1002,"org":1003,"tags":1004,"stars":27,"repoUrl":28,"updatedAt":1009},"sdaf-ha-diagnostics","diagnose SDAF high-availability cluster failures","Diagnose a live or recently failed SDAF high-availability cluster without changing cluster state. Start read-first: capture `crm status full` or `pcs status --full`, inspect SBD or fencing evidence, confirm current resource placement, and reuse existing quality-assurance or HCMT artifacts. Grounded in `docs\u002Flocal\u002F07-10-quality-assurance.md`, the shipped Pacemaker role vars\u002Ftasks, and the SAP Automation QA setup role. Use when a user says \"diagnose my HANA failover\", \"crm status\", \"pcs status\", \"check fencing\", \"why is the SCS\u002FERS cluster unhealthy\", \"offline_validation\u002Fcib\", or \"review an HCMT result zip\". Do NOT use for pre-deploy topology or design choices (see `sdaf-ha-topology`), fresh installation\u002Fdeploy, or disruptive failover\u002Ffencing exercises (see `sdaf-quality-assurance`).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1005,1006,1007,1008],{"name":11,"slug":8,"type":14},{"name":989,"slug":990,"type":14},{"name":992,"slug":993,"type":14},{"name":967,"slug":968,"type":14},"2026-09-02T07:48:04.154501",{"slug":1011,"name":1011,"fn":1012,"description":1013,"org":1014,"tags":1015,"stars":27,"repoUrl":28,"updatedAt":1022},"sdaf-ha-topology","design high-availability SAP topologies","Choose the documented SDAF high-availability design before SAP-system deployment. Use when a user asks which HA topology to deploy, whether to use AFA or SBD, AFS or ANF, HANA scale-up or scale-out, whether ANGI is allowed, or which HA inputs must be set before deployment. Ground answers in the current support matrix, Ansible roles, sample tfvars, and validation logic. Do NOT use for live cluster diagnosis (sdaf-ha-diagnostics) or for running the installers (sdaf-sap-installation).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1016,1019,1020,1021],{"name":1017,"slug":1018,"type":14},"Architecture","architecture",{"name":11,"slug":8,"type":14},{"name":978,"slug":979,"type":14},{"name":967,"slug":968,"type":14},"2026-09-02T07:47:43.405138",{"slug":1024,"name":1024,"fn":1025,"description":1026,"org":1027,"tags":1028,"stars":27,"repoUrl":28,"updatedAt":1032},"sdaf-media-acquisition","acquire SAP installation media","Acquire approved SAP media into the SDAF library after SAP-system infrastructure exists. Drives local `deploy\u002Fansible\u002Fdownload_menu.sh` per `docs\u002Flocal\u002F06-00-software-and-installation.md § Download software`, enforces the documented `BOM_CATALOG` root and the four required `sap-parameters.yaml` BOM keys (`application_bom_name`, `database_bom_name`, `sap_kernel_bom_name`, `save_bom_as`), and explains the documented download and validation flow. Use for \"download SAP media\", \"run download_menu.sh\", \"acquire software into the library\", \"BOM Downloader\", \"BOM_CATALOG\", or \"assemble application\u002Fdatabase\u002Fkernel BOMs for download\". Do NOT use to choose a BOM, troubleshoot a failed download, or run installation playbooks.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1029,1030,1031],{"name":11,"slug":8,"type":14},{"name":992,"slug":993,"type":14},{"name":967,"slug":968,"type":14},"2026-09-02T07:46:44.504107",{"slug":1034,"name":1034,"fn":1035,"description":1036,"org":1037,"tags":1038,"stars":27,"repoUrl":28,"updatedAt":1045},"sdaf-media-diagnostics","diagnose SDAF media and BOM processing","Diagnose SDAF software-download and BOM-processing failures after a BOM is already selected. Covers the documented local media path, SAP download, storage-account upload\u002Fdownload, checksum validation, and `SAPCAR` \u002F `.EXE` extraction. Use when a user says \"download_menu failed\", \"BOM downloader 404\", \"missing archive\", \"checksum mismatch\", \"SAPCAR failed\", \"bom-processing-done missing\", or \"my SPS07 media run can't find a file\". Do NOT use to choose a BOM (see `sdaf-bom-selection`), to run a clean first-time media download with no failure, or to diagnose a later non-media install failure.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1039,1040,1041,1042],{"name":11,"slug":8,"type":14},{"name":989,"slug":990,"type":14},{"name":967,"slug":968,"type":14},{"name":1043,"slug":1044,"type":14},"Storage","storage","2026-09-02T07:48:06.369058",{"slug":1047,"name":1047,"fn":1048,"description":1049,"org":1050,"tags":1051,"stars":27,"repoUrl":28,"updatedAt":1058},"sdaf-orientation-and-surface","orient users to SDAF architecture","Orient a newcomer to the SAP Deployment Automation Framework (SDAF): explain the spine (control plane → workload zone → SAP system → software → install → operate\u002Fremove), summarise the three execution surfaces (Local, Azure DevOps, GitHub Actions), and print the install command for the matching surface bootstrap plugin — as documented in this repository's `docs\u002FPLUGINS.md` — so the operator can run it manually. Use when a user says \"what is SDAF\", \"how is SDAF structured\", \"where do I start with SDAF\", \"which surface should I use\", \"SDAF Local vs ADO vs GitHub\", \"workstation vs Azure Pipelines vs GitHub workflows\", \"how do I install the SDAF ADO\u002FGitHub plugin\", or \"I'm new to SDAF\". Do NOT use for readiness pre-flight (see sdaf-readiness-check), workspace\u002Ftfvars layout (see sdaf-workspace-and-tfvars), or troubleshooting a failed run (see sdaf-failure-triage).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1052,1053,1054,1057],{"name":1017,"slug":1018,"type":14},{"name":11,"slug":8,"type":14},{"name":1055,"slug":1056,"type":14},"Documentation","documentation",{"name":967,"slug":968,"type":14},"2026-09-02T07:46:52.116557",{"slug":4,"name":4,"fn":5,"description":6,"org":1060,"tags":1061,"stars":27,"repoUrl":28,"updatedAt":29},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1062,1063,1064,1065,1066],{"name":19,"slug":20,"type":14},{"name":11,"slug":8,"type":14},{"name":22,"slug":23,"type":14},{"name":25,"slug":26,"type":14},{"name":16,"slug":17,"type":14},{"slug":1068,"name":1068,"fn":1069,"description":1070,"org":1071,"tags":1072,"stars":27,"repoUrl":28,"updatedAt":1079},"sdaf-quality-assurance","validate deployed SDAF SAP systems","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. Choose configuration checks vs functional tests, apply `TEST_GROUPS` \u002F `TEST_CASES` safely, interpret `quality_assurance\u002F` and `logs\u002F`, and enforce the documented boundary that the GitHub Actions wrapper is still pending. Use when a user says \"run quality assurance\", \"run configuration checks\", \"pipeline 13 QA\", \"offline HA validation\", or \"why does the report say No test results found\". Do NOT use to deploy the SAP system or generate `sap-parameters.yaml` \u002F `\u003CSID>_hosts.yaml` (see `sdaf-sap-system`), or for a generic failed-run report with no QA-stage context (see `sdaf-failure-triage`).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1073,1074,1075,1078],{"name":19,"slug":20,"type":14},{"name":11,"slug":8,"type":14},{"name":1076,"slug":1077,"type":14},"Quality Assurance","quality-assurance",{"name":967,"slug":968,"type":14},"2026-09-02T07:46:49.932123",145,{"items":1082,"total":1131},[1083,1089,1096,1104,1111,1118,1124],{"slug":957,"name":957,"fn":958,"description":959,"org":1084,"tags":1085,"stars":27,"repoUrl":28,"updatedAt":969},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1086,1087,1088],{"name":11,"slug":8,"type":14},{"name":964,"slug":965,"type":14},{"name":967,"slug":968,"type":14},{"slug":798,"name":798,"fn":971,"description":972,"org":1090,"tags":1091,"stars":27,"repoUrl":28,"updatedAt":981},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1092,1093,1094,1095],{"name":11,"slug":8,"type":14},{"name":945,"slug":946,"type":14},{"name":978,"slug":979,"type":14},{"name":967,"slug":968,"type":14},{"slug":831,"name":831,"fn":983,"description":984,"org":1097,"tags":1098,"stars":27,"repoUrl":28,"updatedAt":998},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1099,1100,1101,1102,1103],{"name":11,"slug":8,"type":14},{"name":989,"slug":990,"type":14},{"name":992,"slug":993,"type":14},{"name":967,"slug":968,"type":14},{"name":996,"slug":997,"type":14},{"slug":1000,"name":1000,"fn":1001,"description":1002,"org":1105,"tags":1106,"stars":27,"repoUrl":28,"updatedAt":1009},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1107,1108,1109,1110],{"name":11,"slug":8,"type":14},{"name":989,"slug":990,"type":14},{"name":992,"slug":993,"type":14},{"name":967,"slug":968,"type":14},{"slug":1011,"name":1011,"fn":1012,"description":1013,"org":1112,"tags":1113,"stars":27,"repoUrl":28,"updatedAt":1022},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1114,1115,1116,1117],{"name":1017,"slug":1018,"type":14},{"name":11,"slug":8,"type":14},{"name":978,"slug":979,"type":14},{"name":967,"slug":968,"type":14},{"slug":1024,"name":1024,"fn":1025,"description":1026,"org":1119,"tags":1120,"stars":27,"repoUrl":28,"updatedAt":1032},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1121,1122,1123],{"name":11,"slug":8,"type":14},{"name":992,"slug":993,"type":14},{"name":967,"slug":968,"type":14},{"slug":1034,"name":1034,"fn":1035,"description":1036,"org":1125,"tags":1126,"stars":27,"repoUrl":28,"updatedAt":1045},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1127,1128,1129,1130],{"name":11,"slug":8,"type":14},{"name":989,"slug":990,"type":14},{"name":967,"slug":968,"type":14},{"name":1043,"slug":1044,"type":14},18]