v2.2.0 — local-dev tier + scale-to-zero cost protection

Azure Lean Stack v2.2.0

Two field learnings fed back into the pack — both proven in real production projects.

🖥️ Local development tier — local (main) → test → prod

New skill developing-azure-apps-locally: run the whole app offline on localhost — real local SQL + blob storage, no Azure cost — as the main-branch "try" tier.

• Docker stack: SQL Server 2022 + Azurite (docker-compose.yml)
• One-command bootstrap (up.sh): compose up → migrate → seed → CORS
• Idempotent local migrate.sh (reuses your infra/sql/migrations/*.sql)
• Mock-mode for unset service keys; local.settings.json.example preconfigured
• dev:test mode to run the frontend against the live test backend
• Apple-Silicon Rosetta guidance

Architecture Decision #0 is now explicitly local → test → prod: main is the offline try tier, then promote by pushing to test / production.

Proven by bc-videohub-lite (docs/LOCAL-DEV.md, scripts/local-dev/*).

💸 Scale-to-zero cost protection

A real overrun: a health endpoint that queried the DB on every call, plus a 5-minute scheduler polling it, kept a SQL Serverless database awake 24/7 — billing compute around the clock instead of pausing.

• Cost Guardrail #11 — "Don't let polling defeat scale-to-zero" with a serverless-vs-flat-Basic decision rule and an advisory-triggers table so Claude warns you before building a DB-querying health endpoint, uptime check, keep-alive, DB-reading scheduler, or minReplicas: 1.
• New detection script audit-cost-antipatterns.sh — greps app source for DB-querying health/status endpoints and frequent schedulers; exits non-zero to gate CI.
• Shallow health-check pattern — DB-free /api/health, DB check gated behind ?deep=1.
• Gotcha #40 (Cost) + a scheduler cost warning in the Logic Apps skill.

The fix is anchored to bc-videohub-lite, which switched serverless → flat Basic tier (~$5/mo, ~10× cheaper at steady low usage, no cold-start). Cause anchored to trg-directory-website.

Also

• 16 skills total; 2 new eval scenarios.
• plugin.json → 2.2.0.

Install

claude plugin install alexpizarro/azure-lean-stack-skills@v2.2.0

Full details in CHANGELOG.md.

v2.1.0 — Azure Lean Stack rename + lens-driven improvements

Azure Lean Stack v2.1.0

Azure apps that cost nothing when nobody's using them.

This release renames the plugin from azure-starter to Azure Lean Stack and ships the first batch of lens-driven improvements (Anthropic skill-design, Azure correctness, marketing readability).

Highlights

• Brand: Azure Lean Stack — install with claude plugin install alexpizarro/azure-lean-stack-skills
• New skill: scheduling-with-azure-logic-apps-consumption — recurring HTTP triggers / Power-Automate-style flows for ~$0.22/month at 5-minute cadence. Proven by a real production scheduler.
• Branch-per-environment is now Architecture Decision #0. Each git branch maps 1:1 to an isolated Azure resource group via OIDC-bound service principals. New environment = new branch + 10 minutes.
• pr-checks.yml workflow template — typecheck/build/test on every PR, lifted from real projects.
• Workflow-checklist pattern in the multi-step skills (OIDC, scaffolding, FC1, multi-tenant) so Claude doesn't skip critical setup steps.
• evals/ with 3 starter scenarios for skill testing.
• RECIPES.md — 8 proven Azure patterns lifted from real production projects, with cost figures and source-project attribution. No fabricated examples.
• MIT LICENSE file added.

Architecture decisions (non-negotiable)

1. Branch-per-environment — main is local dev only; test / production / any other branch maps to an isolated RG
2. SWA managed functions — Free tier, HTTP only, scale-to-zero
3. SQL Serverless — GP_S_Gen5_1 with auto-pause at 15 min
4. OIDC auth — never a client secret in CI
5. JSON parameter files (not .bicepparam)
6. SWA in eastasia (hard-coded; australiaeast not supported)
7. Every pattern proven in a real project — if no shipping project uses it, it doesn't get added

The 14 skills

Skill	When
orchestrating-azure-deployments	The router
scaffolding-azure-bicep-infrastructure	New project, Bicep + workflows
configuring-azure-oidc-for-github-actions	SPs + federated creds + GH secrets
managing-azure-sql-migrations	Idempotent SQL migrations via sqlcmd
deploying-azure-static-web-apps	SWA + managed functions
deploying-fc1-flex-consumption-functions	Timer/queue/AI workloads
deploying-azure-container-apps	Long-running, Jobs, sidecars
scheduling-with-azure-logic-apps-consumption	Recurring triggers (~$0.22/mo)
optimizing-azure-blob-storage-cost	Lifecycle rules + CORS
adding-azure-communication-services-email	Transactional email
instrumenting-azure-app-insights	Workspace-based AI + alerts
scaffolding-multi-tenant-azure-apps	One RG per tenant
applying-azure-cost-guardrails	Consumption-first defaults + auditor
diagnosing-azure-deployment-failures	37+ gotcha catalogue
curating-azure-deployment-learnings	Learnings → gotchas pipeline

Composes with

Designed to work alongside Microsoft's azure-skills plugin. Microsoft owns live diagnostics, cost queries, and RBAC verification via the Azure MCP; this pack owns the opinionated low-cost CI/CD patterns and the gotcha catalogue.

Upgrade from v1

If you were on v1.0.0, pin to it if you don't want the v2 breaking changes:

claude plugin install alexpizarro/azure-lean-stack-skills@v1.0.0

To upgrade to v2.1.0:

claude plugin install alexpizarro/azure-lean-stack-skills@v2.1.0

The old /azure-starter scaffold etc. argument-routed commands are gone. Describe what you want naturally — Claude picks the right sub-skill.

Full changelog

See CHANGELOG.md.