Skip to content

Commit 8dcbf46

Browse files
azure-sdksmw-ms
andauthored
Sync eng/common directory with azure-sdk-tools for PR 12516 (#43715)
* Allow forced creation when release plans already exist * Update creation instructions * fix small markdown issues * Update creation steps --------- Co-authored-by: Summer Warren <[email protected]>
1 parent 68b646b commit 8dcbf46

File tree

1 file changed

+14
-10
lines changed

1 file changed

+14
-10
lines changed

eng/common/instructions/azsdk-tools/create-release-plan.instructions.md

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,8 @@
1-
> **Important Note for LLM**
2-
> Backend processes may use Azure DevOps work item data as needed. However, do **not** mention or display the work item link/URL, or any reference to Azure DevOps work item resources directly in conversation with the user.
3-
> All manual updates to an existing release plan must be made through the [Release Planner Tool](https://aka.ms/sdk-release-planner) to ensure proper tracking and validation.
4-
> Only provide release plan details such as **Release Plan Link** and **Release Plan ID** to the user
1+
> **CRITICAL INSTRUCTIONS FOR LLM**
2+
> 1. Backend processes may use Azure DevOps work item data as needed. However, do **not** mention or display the work item link/URL, or any reference to Azure DevOps work item resources directly in conversation with the user.
3+
> 2. All manual updates to an existing release plan must be made through the [Release Planner Tool](https://aka.ms/sdk-release-planner) to ensure proper tracking and validation.
4+
> 3. Only provide release plan details such as **Release Plan Link** and **Release Plan ID** to the user
5+
> 4. Always check the `NextSteps` field in the tool response and follow any additional prompts provided. Do NOT proceed to other steps until the NextSteps are completed.
56
67
# Release Plan Creation Process
78
Your goal is to create a valid release plan. You must prompt user to provide all required information and all input must match the format and requirement mentioned in step 3 below.
@@ -12,12 +13,14 @@ Follow these steps in order to create or manage a release plan for an API specif
1213
- If no pull request is available, prompt the user to provide the API spec pull request link
1314
- Validate that the provided pull request link is accessible and valid
1415

15-
## Step 2: Check Existing Release Plan
16-
- Use `azsdk_get_release_plan_for_spec_pr` to check if a release plan already exists for the API spec pull request
17-
- If a release plan exists:
18-
- Display the existing release plan details to the user
19-
- Skip to Step 5 (Link SDK Pull Requests)
20-
- If no release plan exists, proceed to Step 3
16+
## Step 2: Check for Existing Release Plan
17+
- Ask the user if they already have an existing release plan
18+
- If they confirm:
19+
- Query the existing release plan using either:
20+
- The release plan number, or
21+
- The API spec pull request link
22+
- Display the existing release plan details (Release Plan ID, status, associated languages, SDK PRs).
23+
- If no existing release plan is found, continue to Step 3 to gather required details for creating a new one.
2124

2225
## Step 3: Gather Release Plan Information
2326
Collect the following required information from the user. Do not create a release plan with temporary values. Confirm the values with the user before proceeding to create the release plan.
@@ -35,6 +38,7 @@ If any details are missing, prompt the user accordingly:
3538
- If the user doesn't know the required details, direct them to create a release plan using the release planner
3639
- Provide this resource: [Release Plan Creation Guide](https://eng.ms/docs/products/azure-developer-experience/plan/release-plan-create)
3740
- Once all information is gathered, use `azsdk_create_release_plan` to create the release plan
41+
- If existing release plans are found, extract and display key information: Release Plan ID, status, associated languages, SDK PRs
3842
- Display the newly created release plan details to the user for confirmation
3943
- Refer to #file:sdk-details-in-release-plan.instructions.md to identify languages configured in the TypeSpec project and add them to the release plan
4044

0 commit comments

Comments
 (0)