[workshop-update] docs(workshops): align content with Deployment Stacks and previously uncovered skills

> [!TIP]
> **Your pull request is ready to create! 🎉 ✅**
>
> Everything is OK—the changes have been pushed to branch `workshop-content-update-2026-09-14-7a0e454e8b442249`. Please review the changes, including any protected files, before creating the pull request.
>
> **[Create the pull request](https://github.com/Azure/git-ape/compare/main...workshop-content-update-2026-09-14-7a0e454e8b442249?expand=1&title=%5Bworkshop-update%5D%20docs(workshops)%3A%20align%20content%20with%20Deployment%20Stacks%20and%20previously%20uncovered%20skills)**
>
> The original pull request description is below.

---

### Summary

Weekly workshop coverage assessment found no open `workshop-sync` issues, so this run's scope was the inventory's coarse "uncovered" signals plus a documentation-accuracy check against actual agent/skill/workflow source. After reading the real sources, four gaps were confirmed as genuinely user-facing and in-scope for the existing personas; the rest were judged out of scope or non-actionable (see coverage issue for full detail).

### What changed and why

| File | Change | Why |
|---|---|---|
| `workshops/track-3-platform-engineering/lab-06-destroy-lifecycle.md` | Rewrote Step 4 ("Watch the Destroy Workflow") to describe the actual `az stack sub show` / `az stack sub delete --action-on-unmanage deleteAll --bypass-stack-out-of-sync-error true` primitive (verified against `.github/skills/git-ape-onboarding/templates/workflows/git-ape-destroy.yml`), replacing a stale "deletes the resource group" description. Documented the legacy resource-group fallback path and cross-linked the local `azure-stack-destroy` skill. Removed duplicate Steps 7–8 that repeated the same (stale) content already fixed in Step 4. | **Existing feature, changed**: the destroy workflow moved from RG-deletion to Deployment Stacks; the lab text never caught up, so learners were shown behavior that no longer matches what the CI workflow does. Persona: DevOps/SRE (Track 3). |
| `workshops/track-1-zero-to-deploy/lab-02-first-deploy.md` | Step 3 now explicitly names the `azure-resource-availability` skill and lists the live-API checks it runs (region, runtime, provider registration, SKU restrictions), and notes the `availability-report.md` artifact. Step 5 and "Going further" cross-link `azure-stack-deploy` as the same primitive used standalone. | **New feature, uncovered** (`azure-resource-availability` skill had 0 refs). Persona: Beginner (Track 1) — the lab already described the *behavior* of this gate without naming the skill; naming it makes the artifact traceable and gives attendees a next-step skill to explore. |
| `workshops/track-2-deploy-like-a-pro/lab-02-web-app-sql.md` | Added two "Going further" links: `azure-rest-api-reference` (schema/API-version lookups the template generator uses) and `azure-stack-deploy` (local re-deploy primitive). | **New feature, uncovered** (`azure-rest-api-reference` and `azure-stack-deploy` both had 0 refs). Persona: Engineer/developer (Track 2) — this track's "Going further" sections are the established place for skill/agent source pointers, so new skills were added there rather than as new lab steps, keeping the 60-minute timing intact. |
| `workshops/shared/glossary.md` | Added glossary rows for the Azure Requirements Gatherer agent (0 refs — referenced by narrative text in three labs but never defined as a term) and the `azure-resource-availability`, `azure-rest-api-reference`, `azure-stack-deploy`, `azure-stack-destroy` skills. | Cross-track reference; every agent/skill named in lab text should be resolvable from the glossary. |

### Persona / track reasoning

- **Track 1 (beginner)**: availability-gate skill naming stays lightweight — no new jargon, just makes an already-described gate traceable to its source.
- **Track 3 (DevOps/SRE)**: destroy-lifecycle correction is the highest-value fix — it was describing wrong CI behavior, which is a factual-accuracy issue, not just a coverage gap.
- **Track 2 (engineer)**: new skill links added to existing "Going further" sections rather than new steps, since that section's established purpose is deep-dive source pointers for this persona.
- `azure-requirements-gatherer` agent and `azure-stack-destroy` skill both got glossary rows only (no new lab prose) — they are already described narratively in existing labs; the gap was strictly "not defined as a term," not "uncovered as a concept."

### Explicitly out of scope this run (see coverage issue for full list)

- `aws-*`-style out-of-program skills — none found; not applicable here.
- No new track or new lab file was warranted — all gaps fit within existing lab "Going further" sections or existing step text.

### Guardrails confirmed

- ✅ No lab timing changed (Track 1 Lab 2 still 15 min, Track 2 Lab 2 still 15 min, Track 3 Lab 6 still 5 min)
- ✅ No-Azure fallback paths untouched (Track 1 Lab 2's review-only path is unchanged)
- ✅ No rendered binaries (`*.pdf`, `*.pptx`, `*.html`) touched
- ✅ No `*_deck.md` files edited — deck lint rules (L1/L11/L15) not applicable this run
- ✅ No files outside `workshops/` touched
- ✅ Every command/property described (`az stack sub show`, `az stack sub delete --action-on-unmanage deleteAll --bypass-stack-out-of-sync-error true`, `az functionapp list-runtimes`, `az vm list-skus`) verified against the actual workflow/skill source before writing

Closes coverage issue: see linked `[workshop-coverage]` issue for the full gap table and per-feature notes.

---

> [!NOTE]
> GitHub Actions is not permitted to create or approve pull requests in this repository.

> The changes have been pushed to branch `workshop-content-update-2026-09-14-7a0e454e8b442249` and are ready to review.

To fix the permissions issue, go to **Settings** → **Actions** → **General** and enable **Allow GitHub Actions to create and approve pull requests**. See also: [gh-aw FAQ](https://github.github.com/gh-aw/reference/faq/#why-is-my-create-pull-request-workflow-failing-with-github-actions-is-not-permitted-to-create-or-approve-pull-requests)

Show patch preview (38 of 160 lines)

```diff
From f069d56b109d12a94a8b5a0ac1ceda372ba56d5e Mon Sep 17 00:00:00 2001
X-GH-AW-Base-Commit: 291405f052fa7975d146628b43a2f3be2e255d9b
From: "github-actions[bot]"
Date: Mon, 14 Sep 2026 01:58:00 +0000
Subject: [PATCH] docs(workshops): align content with Deployment Stacks and
uncovered skills

- Track 3 Lab 6 (destroy lifecycle): replace stale resource-group-deletion
description with the actual az stack sub delete / az stack sub show
primitive used by git-ape-destroy.yml; document the legacy resource-group
fallback path and cross-link the local azure-stack-destroy skill.
- Track 1 Lab 2 (first deploy): clarify the availability gate is powered by
the azure-resource-availability skill (region/SKU/runtime/quota checks via
live Azure APIs) and cross-link azure-stack-deploy as the local equivalent
of the chat-driven deploy step.
- Track 2 Lab 2 (web app + SQL): add a Going further pointer to
azure-rest-api-reference (schema lookups used by the template generator)
and azure-stack-deploy (local re-deploy primitive).
- Glossary: add entries for the Azure Requirements Gatherer agent and the
azure-resource-availability, azure-rest-api-reference, azure-stack-deploy,
and azure-stack-destroy skills, all previously uncovered per the workshop
inventory.

No timing changes, no-Azure fallback paths intact, no rendered binaries
touched, deck lint rules not applicable (no *_deck.md edited).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
workshops/shared/glossary.md | 5 +++
.../lab-02-first-deploy.md | 11 ++++--
.../lab-02-web-app-sql.md | 2 +
.../lab-06-destroy-lifecycle.md | 38 +++++++++----------
4 files changed, 32 insertions(+), 24 deletions(-)

diff --git a/workshops/shared/glossary.md b/workshops/shared/glossary.md
index 48cf741..9ecec41 100644
--- a/workshops/shared/glossary.md
+++ b/workshops/shared/glossary.
... (truncated)
```

> Generated by [Workshop Content Auto-Updater](https://github.com/Azure/git-ape/actions/runs/34797208381) · copilot · auto · 145.6 AIC · ⌖ 15.1 AIC · ⊞ 11.5K · [◷](https://github.com/search?q=repo%3AAzure%2Fgit-ape+%22gh-aw-workflow-id%3A+git-ape-workshop-content-updater%22&type=pullrequests)