Teams Toolkit teamsapp.yaml Lifecycle Scaffolding Prompt
Design a Teams Toolkit teamsapp.yaml that drives provision, deploy, and publish lifecycle stages for a Teams app across dev and prod environments
- Target user
- platform engineers building Microsoft Teams ChatOps with Teams Toolkit
- Difficulty
- Intermediate
- Tools
- Claude, ChatGPT
The prompt
You are a senior platform engineer who builds Microsoft Teams automation and authors Teams Toolkit (TTK) project lifecycle definitions for CI/CD.
I will provide:
- My app's capabilities (bot, tab, message extension) and the Azure resources it needs (Bot Service, App Registration, hosting target)
- My environment layout (.env.dev / .env.prod, naming conventions, target subscription/resource group)
- My CI runner and where secrets are stored (GitHub Actions, Azure DevOps, key vault)
Your job:
1. **Map lifecycle stages** — separate `provision`, `deploy`, and `publish` lifecycle blocks and explain which actions belong in each so I don't redo provisioning on every deploy.
2. **Author the YAML actions** — produce a `teamsapp.yaml` using correct action names (`aadApp/create`, `botAadApp/create`, `arm/deploy`, `teamsApp/zipAppPackage`, `teamsApp/publishAppPackage`) with parameters wired to environment variables.
3. **Parameterize environments** — show the `.env.{env}` variable names each action reads and writes back, and how to avoid hardcoding tenant or resource IDs.
4. **Wire secret handling** — identify which values must be `SECRET_` prefixed and never written to the non-secret env file.
5. **Add a CI invocation** — give the exact `teamsapp` CLI commands (provision/deploy/publish) per stage and the order to run them in a pipeline.
6. **Call out idempotency risks** — flag actions that create vs. update and what happens on re-run.
7. **Validate the manifest** — include the manifest validation/package step before publish.
Output as: a complete commented `teamsapp.yaml`, a table of env variables (name, set-by-action, secret yes/no), and a numbered CI command sequence.
Do not invent action names or parameters; if an action or schema version is uncertain, mark it clearly and tell me to confirm against the current Teams Toolkit schema before running.
Run this prompt with AI
Test it, get an AI-improved version, or compare models — live in the Prompt Workspace. No copy-paste.
Related prompts
-
Teams Toolkit CI Pipeline for Multi-Environment App Publishing Prompt
Design a CI/CD pipeline that uses the Teams Toolkit CLI (teamsapp) to provision, deploy, validate, and publish a Teams app across dev/staging/prod environments with environment-specific manifests and zero manual portal clicks.
-
Teams Bot GitHub Actions Run Status Card Prompt
Build a Teams bot flow that posts GitHub Actions workflow run status as Adaptive Cards — queued/running/success/failure states, job breakdown, failed-step logs, and a re-run action.
-
Teams Release Notes Changelog Posting Prompt
Generate and post a clean release-notes / changelog Adaptive Card to Microsoft Teams from merged PRs and conventional commits whenever a release ships, tailored to a technical or stakeholder audience.
-
Teams App Manifest Versioning and Staged Rollout Rings Prompt
Plan a safe in-place upgrade of a custom Teams app — manifest version bumps, permission-change consent prompts, and ring-based rollout so a bad release does not hit the whole org at once.
More Microsoft Teams prompts & error guides
Browse every Microsoft Teams prompt and troubleshooting guide in one place.
Reading prompts? Get all 500 in one free PDF
500 battle-tested, copy-paste AI prompts engineered by a senior systems engineer — every one with fill-in placeholders and safety/back-out notes. Drop your email and it's yours.
- 500 prompts: Linux · Kubernetes · Terraform · OpenStack · GitLab · Docker · Monitoring · Incident Response
- Instant PDF download — yours free, forever
- Plus one practical AI-workflow email a week (no spam)
Single opt-in · unsubscribe anytime · no spam.