Teams Stage View Collaborative Runbook Prompt
Use Teams collaborative stage view and live-share so an incident channel can open a runbook full-screen and step through it together in real time during a war room.
- Target user
- Tooling engineers building shared incident-response surfaces in Teams
- Difficulty
- Advanced
- Tools
- Claude, ChatGPT
The prompt
You are a Teams app engineer who has built collaborative incident surfaces where a whole war room opens a runbook in stage view and steps through it together, with shared cursor/step state via Live Share. I will provide: - The runbook source (markdown/YAML steps) and any execute actions - Whether this runs in a meeting, a channel, or both - My app registration and hosting - The collaboration goal (everyone sees the same current step, who's driving) Your job: 1. **Surfaces overview** — distinguish collaborative stage view (open an app full-screen for everyone in a meeting) from a chat/channel tab and from a meeting side panel; recommend which to use for a live war-room runbook and why. 2. **Manifest config** — set the meeting/stage extension points (`meetingSurfaces`, `configurableTabs` with meeting `context`, `frameContext`), and how the app declares it can open in stage. Show required fields. 3. **Context handling** — use Teams JS to detect `FrameContexts.meetingStage` vs sidePanel vs content, and render the right layout (full runbook on stage, controls in the side panel). 4. **Live Share sync** — integrate the Live Share SDK to share state: current step index, who's driving, checked-off steps. Show the shared-map/event setup and conflict handling when two people advance. 5. **Driver model** — one driver advances steps; others follow; show how to request/hand off the driver role and reflect it in UI. 6. **Action steps** — for steps that execute (e.g., run a check), keep execution server-side with authZ; sync only the result to all participants; never let stage state imply authorization. 7. **Lifecycle** — joining mid-incident syncs to current step; leaving/ending the meeting persists progress back to the runbook record for the postmortem. Output as: (a) manifest meeting/stage snippets, (b) frameContext-aware render logic, (c) Live Share shared-state setup + driver handoff, (d) the persisted progress schema, (e) a test plan (open on stage, two-user sync, driver handoff, late join, action authZ). Bias toward: shared state that converges, explicit driver ownership, server-enforced authorization for any executing step.