---
name: prepare-release-plan
license: MIT
metadata:
  version: "1.0.0"
  distribution: shared
description: "Create and manage release plan work items for Azure SDK releases across languages. **UTILITY SKILL**. USE FOR: \"create release plan\", \"update release plan\", \"link SDK PR to plan\", \"namespace approval\", \"check release plan status\". DO NOT USE FOR: SDK code generation, pipeline troubleshooting, API review feedback. INVOKES: azure-sdk-mcp:azsdk_create_release_plan, azure-sdk-mcp:azsdk_get_release_plan, azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan."
compatibility: "azure-sdk-mcp server, API spec PR, or TypeSpec project path"
---

# Prepare Release Plan

> Do not display Azure DevOps work item URLs. Only provide Release Plan Link and ID.

## MCP Tools

| Tool | Purpose |
|------|---------|
| `azure-sdk-mcp:azsdk_create_release_plan` | Create plan |
| `azure-sdk-mcp:azsdk_get_release_plan` | Get details |
| `azure-sdk-mcp:azsdk_get_release_plan_for_spec_pr` | Find by spec PR |
| `azure-sdk-mcp:azsdk_update_sdk_details_in_release_plan` | Update SDK info |
| `azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan` | Link SDK PR |
| `azure-sdk-mcp:azsdk_link_namespace_approval_issue` | Link namespace |

## Steps

1. **Prerequisites** — Check for API spec PR link or a TypeSpec project path; prompt if unavailable.
2. **Check Existing** — Query by release plan number or spec PR link (do not query by work item ID).
3. **Gather Info** — Collect Service Tree IDs, timeline. See [details](references/release-plan-details.md).
4. **Create** — Run `azure-sdk-mcp:azsdk_create_release_plan`.
5. **Namespace** — For mgmt plane first releases, link approval issue.
6. **Link PRs** — Link SDK PRs to plan.

## Examples

- "Create a release plan for my spec PR"
- "Create a release plan for my TypeSpec project"
- "Link my SDK PR to release plan"

## Troubleshooting

- Requires `azure-sdk-mcp` server; no CLI fallback.
- If creation fails, verify Service Tree IDs and the provided spec PR URL or TypeSpec project path.