[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-azure-sdaf-orientation-and-surface":3,"mdc--i5ce66-key":35,"related-org-azure-sdaf-orientation-and-surface":674,"related-repo-azure-sdaf-orientation-and-surface":840},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":24,"repoUrl":25,"updatedAt":26,"license":27,"forks":28,"topics":29,"repo":30,"sourceUrl":33,"mdContent":34},"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},"azure","Azure (Microsoft)","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fazure.png","Azure",[13,15,18,21],{"name":11,"slug":8,"type":14},"tag",{"name":16,"slug":17,"type":14},"Architecture","architecture",{"name":19,"slug":20,"type":14},"Documentation","documentation",{"name":22,"slug":23,"type":14},"SAP","sap",143,"https:\u002F\u002Fgithub.com\u002FAzure\u002Fsap-automation","2026-09-02T07:46:52.116557","MIT",173,[],{"repoUrl":25,"stars":24,"forks":28,"topics":31,"description":32},[],"This is the repository supporting the SAP deployment automation framework on Azure","https:\u002F\u002Fgithub.com\u002FAzure\u002Fsap-automation\u002Ftree\u002FHEAD\u002Fskills\u002Fsdaf-orientation-and-surface","---\nname: sdaf-orientation-and-surface\ndescription: >\n  Orient a newcomer to the SAP Deployment Automation Framework (SDAF): explain\n  the spine (control plane → workload zone → SAP system → software → install →\n  operate\u002Fremove), summarise the three execution surfaces (Local, Azure DevOps,\n  GitHub Actions), and print the install command for the matching surface\n  bootstrap plugin — as documented in this repository's `docs\u002FPLUGINS.md` —\n  so the operator can run it manually. Use when a user says \"what is SDAF\",\n  \"how is SDAF structured\", \"where do I start with SDAF\", \"which surface\n  should I use\", \"SDAF Local vs ADO vs GitHub\", \"workstation vs Azure\n  Pipelines vs GitHub workflows\", \"how do I install the SDAF ADO\u002FGitHub\n  plugin\", or \"I'm new to SDAF\". Do NOT use for readiness pre-flight (see\n  sdaf-readiness-check), workspace\u002Ftfvars layout (see\n  sdaf-workspace-and-tfvars), or troubleshooting a failed run (see\n  sdaf-failure-triage).\nallowed-tools: shell\nlicense: MIT\n---\n\n# SDAF Orientation and Surface Choice\n\nPrimer skill. Answers *\"what is SDAF and which execution surface should I use?\"*\nand hands off to the next action-loop skill. Grounded in the shipped docs; no\ninferred procedures.\n\n## When to invoke\n\nTrigger on: \"what is SDAF\", \"where do I start\", \"SDAF surface\", \"Local vs ADO\nvs GitHub\", \"SDAF plugin install command\", \"how do I install azure-sap-automation-devops\",\n\"which surface for SDAF\".\n\nDo NOT trigger on: pre-flight readiness checks, tfvars\u002FWORKSPACES authoring,\nBOM selection, failed-run triage. Route to the sibling skill instead.\n\n## The spine (order is enforced)\n\nDocs enforce this order for every surface:\n\n1. **Control plane** — deployer + SAP library, establishes remote Terraform\n   state (`docs\u002Flocal\u002F03-00-control-plane.md § Outcome`, `§ What the\n   automation does`).\n2. **Workload zone** — landscape \u002F networking \u002F zone Key Vault; reads\n   control-plane state (`docs\u002Flocal\u002F04-00-workload-zone.md § Outcome`).\n3. **SAP system** — VMs + inventory; reads deployer + landscape state\n   (`docs\u002Flocal\u002F05-00-sap-system.md § Outcome`).\n4. **Software download** — needs the workload-zone Key Vault credentials\n   (`docs\u002Flocal\u002F06-00-software-and-installation.md § Download software`).\n5. **Install** — OS + DB + SAP via Ansible playbooks\n   (`docs\u002Flocal\u002F06-00-software-and-installation.md § Run configuration and installation`).\n6. **Operate \u002F recover \u002F remove** — reverse dependency order for removal\n   (`docs\u002Flocal\u002F07-00-operations.md § Remove resources`).\n\nNever let a stage run before the prior one completed\n(`docs\u002Flocal\u002FREADME.md § Complete the journey`).\n\n## The three execution surfaces\n\nDocs explicitly frame the surfaces as \"capability differences, not a ranking\":\nthere is **no declared primary** (`docs\u002Fdeployment-options.md § Select an\nexecution model`). They are not one-to-one equivalent.\n\n| Surface | When it fits | Doc anchor |\n|---|---|---|\n| **Local \u002F scripted** | You run `deploy\u002Fscripts\u002F*` directly from a workstation, deployer, or automation host. No hosted stage generator. | `docs\u002Fdeployment-options.md § Local or scripted execution`; `docs\u002Flocal\u002FREADME.md § Run SDAF locally` |\n| **Azure DevOps** | Azure Repos\u002FPipelines, service connections, agent pools own the process. Wrapper pipelines exist but docs note ADO \"does not currently provide verified one-to-one equivalents for all GitHub generation workflows\". | `docs\u002Fdeployment-options.md § Azure DevOps` |\n| **GitHub Actions** | GitHub owns the config repo and approvals. Includes stage-generation workflows and deploy workflows. | `docs\u002Fdeployment-options.md § GitHub Actions` |\n\nSee [`references\u002Fsurface-decision.md`](references\u002Fsurface-decision.md) for the\ntwo-question decision walkthrough and the hand-off to the next skill.\n\n## What this skill does and does NOT do\n\n**Does:** classify the request, explain the spine, help pick a surface, and\n*print* the install command for the matching bootstrap plugin — the operator\nruns it themselves.\n\n**Does NOT:** install anything. Does not run a plan\u002Fapply. Does not fabricate\n\"which surface is best\" — the docs decline to rank them and this skill honours\nthat.\n\n## Print the surface bootstrap install command\n\nThe canonical install commands for the hub and both surface plugins are\ndocumented in [`docs\u002FPLUGINS.md`](..\u002F..\u002Fdocs\u002FPLUGINS.md) (this repo). Print\nthe block that matches the operator's chosen surface **verbatim** from that\nfile, and instruct the operator to run it themselves. Do not invent\nalternatives, do not paraphrase, do not shorten.\n\nThe exact command shapes at the time this skill was authored (source:\n`docs\u002FPLUGINS.md`):\n\n**Azure DevOps** — from `docs\u002FPLUGINS.md § Install: Azure DevOps surface plugin (`azure-sap-automation-devops`)`:\n\n```text\n# GitHub Copilot CLI\ncopilot plugin marketplace add Azure\u002Fsap-automation-bootstrap\ncopilot plugin install azure-sap-automation-devops@sap-automation-bootstrap\n\n# Claude Code\n\u002Fplugin marketplace add Azure\u002Fsap-automation-bootstrap\n\u002Fplugin install azure-sap-automation-devops@sap-automation-bootstrap\n\n# Gemini CLI\ngemini extensions install https:\u002F\u002Fgithub.com\u002FAzure\u002Fsap-automation-bootstrap\n```\n\n**GitHub Actions** — from `docs\u002FPLUGINS.md § Install: GitHub Actions surface plugin (`azure-sap-automation-github`)`:\n\n```text\n# GitHub Copilot CLI\ncopilot plugin marketplace add Azure\u002Fsap-automation-gh-bootstrap\ncopilot plugin install azure-sap-automation-github@sap-automation-gh-bootstrap\n\n# Claude Code\n\u002Fplugin marketplace add Azure\u002Fsap-automation-gh-bootstrap\n\u002Fplugin install azure-sap-automation-github@sap-automation-gh-bootstrap\n\n# Gemini CLI\ngemini extensions install https:\u002F\u002Fgithub.com\u002FAzure\u002Fsap-automation-gh-bootstrap\n```\n\n**Local** — no surface plugin is required. Hand off directly to\n`sdaf-readiness-check`.\n\nThe Copilot install form is `\u003Cplugin-name>@\u003Cmarketplace-name>` where the\nmarketplace name matches the repository slug (e.g.\n`sap-automation-bootstrap`), not the plugin name. If `docs\u002FPLUGINS.md` and\nthis skill body ever diverge, `docs\u002FPLUGINS.md` is the source of truth —\nupdate this skill in lockstep.\n\n## Hand-off\n\nAfter the surface is chosen and the surface plugin (if any) is installed by\nthe operator, hand off to `sdaf-readiness-check` for pre-flight, then\n`sdaf-workspace-and-tfvars` before any deploy skill.\n\n## See also\n\n- [`docs\u002FPLUGINS.md`](..\u002F..\u002Fdocs\u002FPLUGINS.md) — canonical install commands.\n- `sdaf-readiness-check`, `sdaf-workspace-and-tfvars`,\n  `sdaf-control-plane-bootstrap`.\n- `docs\u002Flocal\u002FREADME.md`, `docs\u002Fdeployment-options.md`.",{"data":36,"body":38},{"name":4,"description":6,"allowed-tools":37,"license":27},"shell",{"type":39,"children":40},"root",[41,50,64,71,76,81,87,92,210,222,228,248,372,389,395,412,422,428,452,464,489,501,523,532,550,585,591,611,617],{"type":42,"tag":43,"props":44,"children":46},"element","h1",{"id":45},"sdaf-orientation-and-surface-choice",[47],{"type":48,"value":49},"text","SDAF Orientation and Surface Choice",{"type":42,"tag":51,"props":52,"children":53},"p",{},[54,56,62],{"type":48,"value":55},"Primer skill. Answers ",{"type":42,"tag":57,"props":58,"children":59},"em",{},[60],{"type":48,"value":61},"\"what is SDAF and which execution surface should I use?\"",{"type":48,"value":63},"\nand hands off to the next action-loop skill. Grounded in the shipped docs; no\ninferred procedures.",{"type":42,"tag":65,"props":66,"children":68},"h2",{"id":67},"when-to-invoke",[69],{"type":48,"value":70},"When to invoke",{"type":42,"tag":51,"props":72,"children":73},{},[74],{"type":48,"value":75},"Trigger on: \"what is SDAF\", \"where do I start\", \"SDAF surface\", \"Local vs ADO\nvs GitHub\", \"SDAF plugin install command\", \"how do I install azure-sap-automation-devops\",\n\"which surface for SDAF\".",{"type":42,"tag":51,"props":77,"children":78},{},[79],{"type":48,"value":80},"Do NOT trigger on: pre-flight readiness checks, tfvars\u002FWORKSPACES authoring,\nBOM selection, failed-run triage. Route to the sibling skill instead.",{"type":42,"tag":65,"props":82,"children":84},{"id":83},"the-spine-order-is-enforced",[85],{"type":48,"value":86},"The spine (order is enforced)",{"type":42,"tag":51,"props":88,"children":89},{},[90],{"type":48,"value":91},"Docs enforce this order for every surface:",{"type":42,"tag":93,"props":94,"children":95},"ol",{},[96,125,142,159,176,193],{"type":42,"tag":97,"props":98,"children":99},"li",{},[100,106,108,115,117,123],{"type":42,"tag":101,"props":102,"children":103},"strong",{},[104],{"type":48,"value":105},"Control plane",{"type":48,"value":107}," — deployer + SAP library, establishes remote Terraform\nstate (",{"type":42,"tag":109,"props":110,"children":112},"code",{"className":111},[],[113],{"type":48,"value":114},"docs\u002Flocal\u002F03-00-control-plane.md § Outcome",{"type":48,"value":116},", ",{"type":42,"tag":109,"props":118,"children":120},{"className":119},[],[121],{"type":48,"value":122},"§ What the automation does",{"type":48,"value":124},").",{"type":42,"tag":97,"props":126,"children":127},{},[128,133,135,141],{"type":42,"tag":101,"props":129,"children":130},{},[131],{"type":48,"value":132},"Workload zone",{"type":48,"value":134}," — landscape \u002F networking \u002F zone Key Vault; reads\ncontrol-plane state (",{"type":42,"tag":109,"props":136,"children":138},{"className":137},[],[139],{"type":48,"value":140},"docs\u002Flocal\u002F04-00-workload-zone.md § Outcome",{"type":48,"value":124},{"type":42,"tag":97,"props":143,"children":144},{},[145,150,152,158],{"type":42,"tag":101,"props":146,"children":147},{},[148],{"type":48,"value":149},"SAP system",{"type":48,"value":151}," — VMs + inventory; reads deployer + landscape state\n(",{"type":42,"tag":109,"props":153,"children":155},{"className":154},[],[156],{"type":48,"value":157},"docs\u002Flocal\u002F05-00-sap-system.md § Outcome",{"type":48,"value":124},{"type":42,"tag":97,"props":160,"children":161},{},[162,167,169,175],{"type":42,"tag":101,"props":163,"children":164},{},[165],{"type":48,"value":166},"Software download",{"type":48,"value":168}," — needs the workload-zone Key Vault credentials\n(",{"type":42,"tag":109,"props":170,"children":172},{"className":171},[],[173],{"type":48,"value":174},"docs\u002Flocal\u002F06-00-software-and-installation.md § Download software",{"type":48,"value":124},{"type":42,"tag":97,"props":177,"children":178},{},[179,184,186,192],{"type":42,"tag":101,"props":180,"children":181},{},[182],{"type":48,"value":183},"Install",{"type":48,"value":185}," — OS + DB + SAP via Ansible playbooks\n(",{"type":42,"tag":109,"props":187,"children":189},{"className":188},[],[190],{"type":48,"value":191},"docs\u002Flocal\u002F06-00-software-and-installation.md § Run configuration and installation",{"type":48,"value":124},{"type":42,"tag":97,"props":194,"children":195},{},[196,201,203,209],{"type":42,"tag":101,"props":197,"children":198},{},[199],{"type":48,"value":200},"Operate \u002F recover \u002F remove",{"type":48,"value":202}," — reverse dependency order for removal\n(",{"type":42,"tag":109,"props":204,"children":206},{"className":205},[],[207],{"type":48,"value":208},"docs\u002Flocal\u002F07-00-operations.md § Remove resources",{"type":48,"value":124},{"type":42,"tag":51,"props":211,"children":212},{},[213,215,221],{"type":48,"value":214},"Never let a stage run before the prior one completed\n(",{"type":42,"tag":109,"props":216,"children":218},{"className":217},[],[219],{"type":48,"value":220},"docs\u002Flocal\u002FREADME.md § Complete the journey",{"type":48,"value":124},{"type":42,"tag":65,"props":223,"children":225},{"id":224},"the-three-execution-surfaces",[226],{"type":48,"value":227},"The three execution surfaces",{"type":42,"tag":51,"props":229,"children":230},{},[231,233,238,240,246],{"type":48,"value":232},"Docs explicitly frame the surfaces as \"capability differences, not a ranking\":\nthere is ",{"type":42,"tag":101,"props":234,"children":235},{},[236],{"type":48,"value":237},"no declared primary",{"type":48,"value":239}," (",{"type":42,"tag":109,"props":241,"children":243},{"className":242},[],[244],{"type":48,"value":245},"docs\u002Fdeployment-options.md § Select an execution model",{"type":48,"value":247},"). They are not one-to-one equivalent.",{"type":42,"tag":249,"props":250,"children":251},"table",{},[252,276],{"type":42,"tag":253,"props":254,"children":255},"thead",{},[256],{"type":42,"tag":257,"props":258,"children":259},"tr",{},[260,266,271],{"type":42,"tag":261,"props":262,"children":263},"th",{},[264],{"type":48,"value":265},"Surface",{"type":42,"tag":261,"props":267,"children":268},{},[269],{"type":48,"value":270},"When it fits",{"type":42,"tag":261,"props":272,"children":273},{},[274],{"type":48,"value":275},"Doc anchor",{"type":42,"tag":277,"props":278,"children":279},"tbody",{},[280,322,347],{"type":42,"tag":257,"props":281,"children":282},{},[283,292,305],{"type":42,"tag":284,"props":285,"children":286},"td",{},[287],{"type":42,"tag":101,"props":288,"children":289},{},[290],{"type":48,"value":291},"Local \u002F scripted",{"type":42,"tag":284,"props":293,"children":294},{},[295,297,303],{"type":48,"value":296},"You run ",{"type":42,"tag":109,"props":298,"children":300},{"className":299},[],[301],{"type":48,"value":302},"deploy\u002Fscripts\u002F*",{"type":48,"value":304}," directly from a workstation, deployer, or automation host. No hosted stage generator.",{"type":42,"tag":284,"props":306,"children":307},{},[308,314,316],{"type":42,"tag":109,"props":309,"children":311},{"className":310},[],[312],{"type":48,"value":313},"docs\u002Fdeployment-options.md § Local or scripted execution",{"type":48,"value":315},"; ",{"type":42,"tag":109,"props":317,"children":319},{"className":318},[],[320],{"type":48,"value":321},"docs\u002Flocal\u002FREADME.md § Run SDAF locally",{"type":42,"tag":257,"props":323,"children":324},{},[325,333,338],{"type":42,"tag":284,"props":326,"children":327},{},[328],{"type":42,"tag":101,"props":329,"children":330},{},[331],{"type":48,"value":332},"Azure DevOps",{"type":42,"tag":284,"props":334,"children":335},{},[336],{"type":48,"value":337},"Azure Repos\u002FPipelines, service connections, agent pools own the process. Wrapper pipelines exist but docs note ADO \"does not currently provide verified one-to-one equivalents for all GitHub generation workflows\".",{"type":42,"tag":284,"props":339,"children":340},{},[341],{"type":42,"tag":109,"props":342,"children":344},{"className":343},[],[345],{"type":48,"value":346},"docs\u002Fdeployment-options.md § Azure DevOps",{"type":42,"tag":257,"props":348,"children":349},{},[350,358,363],{"type":42,"tag":284,"props":351,"children":352},{},[353],{"type":42,"tag":101,"props":354,"children":355},{},[356],{"type":48,"value":357},"GitHub Actions",{"type":42,"tag":284,"props":359,"children":360},{},[361],{"type":48,"value":362},"GitHub owns the config repo and approvals. Includes stage-generation workflows and deploy workflows.",{"type":42,"tag":284,"props":364,"children":365},{},[366],{"type":42,"tag":109,"props":367,"children":369},{"className":368},[],[370],{"type":48,"value":371},"docs\u002Fdeployment-options.md § GitHub Actions",{"type":42,"tag":51,"props":373,"children":374},{},[375,377,387],{"type":48,"value":376},"See ",{"type":42,"tag":378,"props":379,"children":381},"a",{"href":380},"references\u002Fsurface-decision.md",[382],{"type":42,"tag":109,"props":383,"children":385},{"className":384},[],[386],{"type":48,"value":380},{"type":48,"value":388}," for the\ntwo-question decision walkthrough and the hand-off to the next skill.",{"type":42,"tag":65,"props":390,"children":392},{"id":391},"what-this-skill-does-and-does-not-do",[393],{"type":48,"value":394},"What this skill does and does NOT do",{"type":42,"tag":51,"props":396,"children":397},{},[398,403,405,410],{"type":42,"tag":101,"props":399,"children":400},{},[401],{"type":48,"value":402},"Does:",{"type":48,"value":404}," classify the request, explain the spine, help pick a surface, and\n",{"type":42,"tag":57,"props":406,"children":407},{},[408],{"type":48,"value":409},"print",{"type":48,"value":411}," the install command for the matching bootstrap plugin — the operator\nruns it themselves.",{"type":42,"tag":51,"props":413,"children":414},{},[415,420],{"type":42,"tag":101,"props":416,"children":417},{},[418],{"type":48,"value":419},"Does NOT:",{"type":48,"value":421}," install anything. Does not run a plan\u002Fapply. Does not fabricate\n\"which surface is best\" — the docs decline to rank them and this skill honours\nthat.",{"type":42,"tag":65,"props":423,"children":425},{"id":424},"print-the-surface-bootstrap-install-command",[426],{"type":48,"value":427},"Print the surface bootstrap install command",{"type":42,"tag":51,"props":429,"children":430},{},[431,433,443,445,450],{"type":48,"value":432},"The canonical install commands for the hub and both surface plugins are\ndocumented in ",{"type":42,"tag":378,"props":434,"children":436},{"href":435},"..\u002F..\u002Fdocs\u002FPLUGINS.md",[437],{"type":42,"tag":109,"props":438,"children":440},{"className":439},[],[441],{"type":48,"value":442},"docs\u002FPLUGINS.md",{"type":48,"value":444}," (this repo). Print\nthe block that matches the operator's chosen surface ",{"type":42,"tag":101,"props":446,"children":447},{},[448],{"type":48,"value":449},"verbatim",{"type":48,"value":451}," from that\nfile, and instruct the operator to run it themselves. Do not invent\nalternatives, do not paraphrase, do not shorten.",{"type":42,"tag":51,"props":453,"children":454},{},[455,457,462],{"type":48,"value":456},"The exact command shapes at the time this skill was authored (source:\n",{"type":42,"tag":109,"props":458,"children":460},{"className":459},[],[461],{"type":48,"value":442},{"type":48,"value":463},"):",{"type":42,"tag":51,"props":465,"children":466},{},[467,471,473,479,481,487],{"type":42,"tag":101,"props":468,"children":469},{},[470],{"type":48,"value":332},{"type":48,"value":472}," — from ",{"type":42,"tag":109,"props":474,"children":476},{"className":475},[],[477],{"type":48,"value":478},"docs\u002FPLUGINS.md § Install: Azure DevOps surface plugin (",{"type":48,"value":480},"azure-sap-automation-devops",{"type":42,"tag":109,"props":482,"children":484},{"className":483},[],[485],{"type":48,"value":486},")",{"type":48,"value":488},":",{"type":42,"tag":490,"props":491,"children":496},"pre",{"className":492,"code":494,"language":48,"meta":495},[493],"language-text","# GitHub Copilot CLI\ncopilot plugin marketplace add Azure\u002Fsap-automation-bootstrap\ncopilot plugin install azure-sap-automation-devops@sap-automation-bootstrap\n\n# Claude Code\n\u002Fplugin marketplace add Azure\u002Fsap-automation-bootstrap\n\u002Fplugin install azure-sap-automation-devops@sap-automation-bootstrap\n\n# Gemini CLI\ngemini extensions install https:\u002F\u002Fgithub.com\u002FAzure\u002Fsap-automation-bootstrap\n","",[497],{"type":42,"tag":109,"props":498,"children":499},{"__ignoreMap":495},[500],{"type":48,"value":494},{"type":42,"tag":51,"props":502,"children":503},{},[504,508,509,515,517,522],{"type":42,"tag":101,"props":505,"children":506},{},[507],{"type":48,"value":357},{"type":48,"value":472},{"type":42,"tag":109,"props":510,"children":512},{"className":511},[],[513],{"type":48,"value":514},"docs\u002FPLUGINS.md § Install: GitHub Actions surface plugin (",{"type":48,"value":516},"azure-sap-automation-github",{"type":42,"tag":109,"props":518,"children":520},{"className":519},[],[521],{"type":48,"value":486},{"type":48,"value":488},{"type":42,"tag":490,"props":524,"children":527},{"className":525,"code":526,"language":48,"meta":495},[493],"# GitHub Copilot CLI\ncopilot plugin marketplace add Azure\u002Fsap-automation-gh-bootstrap\ncopilot plugin install azure-sap-automation-github@sap-automation-gh-bootstrap\n\n# Claude Code\n\u002Fplugin marketplace add Azure\u002Fsap-automation-gh-bootstrap\n\u002Fplugin install azure-sap-automation-github@sap-automation-gh-bootstrap\n\n# Gemini CLI\ngemini extensions install https:\u002F\u002Fgithub.com\u002FAzure\u002Fsap-automation-gh-bootstrap\n",[528],{"type":42,"tag":109,"props":529,"children":530},{"__ignoreMap":495},[531],{"type":48,"value":526},{"type":42,"tag":51,"props":533,"children":534},{},[535,540,542,548],{"type":42,"tag":101,"props":536,"children":537},{},[538],{"type":48,"value":539},"Local",{"type":48,"value":541}," — no surface plugin is required. Hand off directly to\n",{"type":42,"tag":109,"props":543,"children":545},{"className":544},[],[546],{"type":48,"value":547},"sdaf-readiness-check",{"type":48,"value":549},".",{"type":42,"tag":51,"props":551,"children":552},{},[553,555,561,563,569,571,576,578,583],{"type":48,"value":554},"The Copilot install form is ",{"type":42,"tag":109,"props":556,"children":558},{"className":557},[],[559],{"type":48,"value":560},"\u003Cplugin-name>@\u003Cmarketplace-name>",{"type":48,"value":562}," where the\nmarketplace name matches the repository slug (e.g.\n",{"type":42,"tag":109,"props":564,"children":566},{"className":565},[],[567],{"type":48,"value":568},"sap-automation-bootstrap",{"type":48,"value":570},"), not the plugin name. If ",{"type":42,"tag":109,"props":572,"children":574},{"className":573},[],[575],{"type":48,"value":442},{"type":48,"value":577}," and\nthis skill body ever diverge, ",{"type":42,"tag":109,"props":579,"children":581},{"className":580},[],[582],{"type":48,"value":442},{"type":48,"value":584}," is the source of truth —\nupdate this skill in lockstep.",{"type":42,"tag":65,"props":586,"children":588},{"id":587},"hand-off",[589],{"type":48,"value":590},"Hand-off",{"type":42,"tag":51,"props":592,"children":593},{},[594,596,601,603,609],{"type":48,"value":595},"After the surface is chosen and the surface plugin (if any) is installed by\nthe operator, hand off to ",{"type":42,"tag":109,"props":597,"children":599},{"className":598},[],[600],{"type":48,"value":547},{"type":48,"value":602}," for pre-flight, then\n",{"type":42,"tag":109,"props":604,"children":606},{"className":605},[],[607],{"type":48,"value":608},"sdaf-workspace-and-tfvars",{"type":48,"value":610}," before any deploy skill.",{"type":42,"tag":65,"props":612,"children":614},{"id":613},"see-also",[615],{"type":48,"value":616},"See also",{"type":42,"tag":618,"props":619,"children":620},"ul",{},[621,634,657],{"type":42,"tag":97,"props":622,"children":623},{},[624,632],{"type":42,"tag":378,"props":625,"children":626},{"href":435},[627],{"type":42,"tag":109,"props":628,"children":630},{"className":629},[],[631],{"type":48,"value":442},{"type":48,"value":633}," — canonical install commands.",{"type":42,"tag":97,"props":635,"children":636},{},[637,642,643,648,650,656],{"type":42,"tag":109,"props":638,"children":640},{"className":639},[],[641],{"type":48,"value":547},{"type":48,"value":116},{"type":42,"tag":109,"props":644,"children":646},{"className":645},[],[647],{"type":48,"value":608},{"type":48,"value":649},",\n",{"type":42,"tag":109,"props":651,"children":653},{"className":652},[],[654],{"type":48,"value":655},"sdaf-control-plane-bootstrap",{"type":48,"value":549},{"type":42,"tag":97,"props":658,"children":659},{},[660,666,667,673],{"type":42,"tag":109,"props":661,"children":663},{"className":662},[],[664],{"type":48,"value":665},"docs\u002Flocal\u002FREADME.md",{"type":48,"value":116},{"type":42,"tag":109,"props":668,"children":670},{"className":669},[],[671],{"type":48,"value":672},"docs\u002Fdeployment-options.md",{"type":48,"value":549},{"items":675,"total":839},[676,695,714,726,738,756,767,778,788,801,808,826],{"slug":677,"name":677,"fn":678,"description":679,"org":680,"tags":681,"stars":692,"repoUrl":693,"updatedAt":694},"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},[682,683,686,689],{"name":11,"slug":8,"type":14},{"name":684,"slug":685,"type":14},"Compliance","compliance",{"name":687,"slug":688,"type":14},"Governance","governance",{"name":690,"slug":691,"type":14},"Policy","policy",1689,"https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-policy","2026-07-12T08:17:48.378432",{"slug":696,"name":696,"fn":697,"description":698,"org":699,"tags":700,"stars":711,"repoUrl":712,"updatedAt":713},"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},[701,702,705,708],{"name":11,"slug":8,"type":14},{"name":703,"slug":704,"type":14},"Deployment","deployment",{"name":706,"slug":707,"type":14},"Infrastructure as Code","infrastructure-as-code",{"name":709,"slug":710,"type":14},"Migration","migration",261,"https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-blueprints","2026-08-20T03:28:18.136156",{"slug":715,"name":715,"fn":716,"description":717,"org":718,"tags":719,"stars":24,"repoUrl":25,"updatedAt":725},"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},[720,721,724],{"name":11,"slug":8,"type":14},{"name":722,"slug":723,"type":14},"Configuration","configuration",{"name":22,"slug":23,"type":14},"2026-09-02T07:47:45.597063",{"slug":655,"name":655,"fn":727,"description":728,"org":729,"tags":730,"stars":24,"repoUrl":25,"updatedAt":737},"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},[731,732,733,736],{"name":11,"slug":8,"type":14},{"name":703,"slug":704,"type":14},{"name":734,"slug":735,"type":14},"Infrastructure","infrastructure",{"name":22,"slug":23,"type":14},"2026-09-02T07:46:51.573641",{"slug":739,"name":739,"fn":740,"description":741,"org":742,"tags":743,"stars":24,"repoUrl":25,"updatedAt":755},"sdaf-failure-triage","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},[744,745,748,751,752],{"name":11,"slug":8,"type":14},{"name":746,"slug":747,"type":14},"Diagnostics","diagnostics",{"name":749,"slug":750,"type":14},"Operations","operations",{"name":22,"slug":23,"type":14},{"name":753,"slug":754,"type":14},"Triage","triage","2026-09-02T07:47:40.607437",{"slug":757,"name":757,"fn":758,"description":759,"org":760,"tags":761,"stars":24,"repoUrl":25,"updatedAt":766},"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},[762,763,764,765],{"name":11,"slug":8,"type":14},{"name":746,"slug":747,"type":14},{"name":749,"slug":750,"type":14},{"name":22,"slug":23,"type":14},"2026-09-02T07:48:04.154501",{"slug":768,"name":768,"fn":769,"description":770,"org":771,"tags":772,"stars":24,"repoUrl":25,"updatedAt":777},"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},[773,774,775,776],{"name":16,"slug":17,"type":14},{"name":11,"slug":8,"type":14},{"name":734,"slug":735,"type":14},{"name":22,"slug":23,"type":14},"2026-09-02T07:47:43.405138",{"slug":779,"name":779,"fn":780,"description":781,"org":782,"tags":783,"stars":24,"repoUrl":25,"updatedAt":787},"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},[784,785,786],{"name":11,"slug":8,"type":14},{"name":749,"slug":750,"type":14},{"name":22,"slug":23,"type":14},"2026-09-02T07:46:44.504107",{"slug":789,"name":789,"fn":790,"description":791,"org":792,"tags":793,"stars":24,"repoUrl":25,"updatedAt":800},"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},[794,795,796,797],{"name":11,"slug":8,"type":14},{"name":746,"slug":747,"type":14},{"name":22,"slug":23,"type":14},{"name":798,"slug":799,"type":14},"Storage","storage","2026-09-02T07:48:06.369058",{"slug":4,"name":4,"fn":5,"description":6,"org":802,"tags":803,"stars":24,"repoUrl":25,"updatedAt":26},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[804,805,806,807],{"name":16,"slug":17,"type":14},{"name":11,"slug":8,"type":14},{"name":19,"slug":20,"type":14},{"name":22,"slug":23,"type":14},{"slug":809,"name":809,"fn":810,"description":811,"org":812,"tags":813,"stars":24,"repoUrl":25,"updatedAt":825},"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},[814,817,818,820,823],{"name":815,"slug":816,"type":14},"Automation","automation",{"name":11,"slug":8,"type":14},{"name":332,"slug":819,"type":14},"azure-devops",{"name":821,"slug":822,"type":14},"CI\u002FCD","ci-cd",{"name":357,"slug":824,"type":14},"github-actions","2026-09-02T07:48:08.951811",{"slug":827,"name":827,"fn":828,"description":829,"org":830,"tags":831,"stars":24,"repoUrl":25,"updatedAt":838},"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},[832,833,834,837],{"name":815,"slug":816,"type":14},{"name":11,"slug":8,"type":14},{"name":835,"slug":836,"type":14},"Quality Assurance","quality-assurance",{"name":22,"slug":23,"type":14},"2026-09-02T07:46:49.932123",145,{"items":841,"total":890},[842,848,855,863,870,877,883],{"slug":715,"name":715,"fn":716,"description":717,"org":843,"tags":844,"stars":24,"repoUrl":25,"updatedAt":725},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[845,846,847],{"name":11,"slug":8,"type":14},{"name":722,"slug":723,"type":14},{"name":22,"slug":23,"type":14},{"slug":655,"name":655,"fn":727,"description":728,"org":849,"tags":850,"stars":24,"repoUrl":25,"updatedAt":737},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[851,852,853,854],{"name":11,"slug":8,"type":14},{"name":703,"slug":704,"type":14},{"name":734,"slug":735,"type":14},{"name":22,"slug":23,"type":14},{"slug":739,"name":739,"fn":740,"description":741,"org":856,"tags":857,"stars":24,"repoUrl":25,"updatedAt":755},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[858,859,860,861,862],{"name":11,"slug":8,"type":14},{"name":746,"slug":747,"type":14},{"name":749,"slug":750,"type":14},{"name":22,"slug":23,"type":14},{"name":753,"slug":754,"type":14},{"slug":757,"name":757,"fn":758,"description":759,"org":864,"tags":865,"stars":24,"repoUrl":25,"updatedAt":766},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[866,867,868,869],{"name":11,"slug":8,"type":14},{"name":746,"slug":747,"type":14},{"name":749,"slug":750,"type":14},{"name":22,"slug":23,"type":14},{"slug":768,"name":768,"fn":769,"description":770,"org":871,"tags":872,"stars":24,"repoUrl":25,"updatedAt":777},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[873,874,875,876],{"name":16,"slug":17,"type":14},{"name":11,"slug":8,"type":14},{"name":734,"slug":735,"type":14},{"name":22,"slug":23,"type":14},{"slug":779,"name":779,"fn":780,"description":781,"org":878,"tags":879,"stars":24,"repoUrl":25,"updatedAt":787},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[880,881,882],{"name":11,"slug":8,"type":14},{"name":749,"slug":750,"type":14},{"name":22,"slug":23,"type":14},{"slug":789,"name":789,"fn":790,"description":791,"org":884,"tags":885,"stars":24,"repoUrl":25,"updatedAt":800},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[886,887,888,889],{"name":11,"slug":8,"type":14},{"name":746,"slug":747,"type":14},{"name":22,"slug":23,"type":14},{"name":798,"slug":799,"type":14},18]