From c24d68b04b6ccf52b3a3cd861c6eb1620ed2e28f Mon Sep 17 00:00:00 2001 From: Summer Warren Date: Tue, 2 Sep 2025 16:54:51 -0700 Subject: [PATCH 1/6] Update create release plan instructions and return --- .../azsdk-tools/create-release-plan.instructions.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md b/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md index fa55d8edb0..0410e46a5d 100644 --- a/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md +++ b/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md @@ -1,5 +1,10 @@ # Release Plan Creation Process You 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. + +> **Important Note** +> Do **not** ask the user to manually edit the DevOps work item. +> To update a release plan manually, the user must use the [Release Planner Tool](https://apps.powerapps.com/play/e/ed2ffefd-774d-40dd-ab23-7fff01aeec9f/a/821ab569-ae60-420d-8264-d7b5d5ef734c?tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47). + Follow these steps in order to create or manage a release plan for an API specification pull request: ## Step 1: Validate Prerequisites From 8f0557d6a2148e73cdf5d4f8fdebd3230ba3e2bf Mon Sep 17 00:00:00 2001 From: Summer Date: Fri, 5 Sep 2025 10:00:41 -0700 Subject: [PATCH 2/6] Update eng/common/instructions/azsdk-tools/create-release-plan.instructions.md Co-authored-by: Mariana Rios Flores --- .../azsdk-tools/create-release-plan.instructions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md b/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md index 0410e46a5d..0e4e60c2c1 100644 --- a/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md +++ b/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md @@ -3,7 +3,7 @@ You goal is to create a valid release plan. You must prompt user to provide all > **Important Note** > Do **not** ask the user to manually edit the DevOps work item. -> To update a release plan manually, the user must use the [Release Planner Tool](https://apps.powerapps.com/play/e/ed2ffefd-774d-40dd-ab23-7fff01aeec9f/a/821ab569-ae60-420d-8264-d7b5d5ef734c?tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47). +> To update a release plan manually, the user must use the [Release Planner Tool](https://aka.ms/sdk-release-planner). Follow these steps in order to create or manage a release plan for an API specification pull request: From 5789ac50c9d523feed29426651253895260e5f27 Mon Sep 17 00:00:00 2001 From: Summer Warren Date: Fri, 5 Sep 2025 10:50:55 -0700 Subject: [PATCH 3/6] Return Release Plan Details --- .../azsdk-tools/create-release-plan.instructions.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md b/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md index 0e4e60c2c1..02a825c927 100644 --- a/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md +++ b/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md @@ -4,6 +4,9 @@ You goal is to create a valid release plan. You must prompt user to provide all > **Important Note** > Do **not** ask the user to manually edit the DevOps work item. > To update a release plan manually, the user must use the [Release Planner Tool](https://aka.ms/sdk-release-planner). +> When referring to a release plan in conversation with a user: +> - Always include both the **Release Plan Link** and **Release Plan ID** for clarity. +> - If the reference is intended for use by the LLM (e.g., for internal logic), use the **Release Plan Work Item ID** instead. Follow these steps in order to create or manage a release plan for an API specification pull request: From bafc472c82c6c6e48c2fc20fbcfa02fec048baab Mon Sep 17 00:00:00 2001 From: Summer Date: Wed, 10 Sep 2025 11:00:34 -0700 Subject: [PATCH 4/6] Update eng/common/instructions/azsdk-tools/create-release-plan.instructions.md Co-authored-by: Ben Broderick Phillips --- .../azsdk-tools/create-release-plan.instructions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md b/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md index 02a825c927..5a8e035aad 100644 --- a/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md +++ b/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md @@ -1,5 +1,5 @@ # Release Plan Creation Process -You 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. +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. > **Important Note** > Do **not** ask the user to manually edit the DevOps work item. From 0f59f1714849834b50b6e9cf446ba849217305d3 Mon Sep 17 00:00:00 2001 From: Summer Warren Date: Wed, 10 Sep 2025 14:49:20 -0700 Subject: [PATCH 5/6] Add more specific rules for release plan creation --- .../azsdk-tools/create-release-plan.instructions.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md b/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md index 5a8e035aad..c93c85a918 100644 --- a/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md +++ b/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md @@ -4,9 +4,7 @@ Your goal is to create a valid release plan. You must prompt user to provide all > **Important Note** > Do **not** ask the user to manually edit the DevOps work item. > To update a release plan manually, the user must use the [Release Planner Tool](https://aka.ms/sdk-release-planner). -> When referring to a release plan in conversation with a user: -> - Always include both the **Release Plan Link** and **Release Plan ID** for clarity. -> - If the reference is intended for use by the LLM (e.g., for internal logic), use the **Release Plan Work Item ID** instead. +> When summarizing or displaying release plan details, do not mention or display the work item link/URL, or any direct reference to Azure DevOps work item resources. Only provide relevant release plan details like **Release Plan Link** and **Release Plan ID**. Follow these steps in order to create or manage a release plan for an API specification pull request: From 3021031dbb812b2ddbe7d81864aa36a9acd7db4d Mon Sep 17 00:00:00 2001 From: Summer Warren Date: Mon, 15 Sep 2025 10:19:15 -0700 Subject: [PATCH 6/6] Add Better instructions --- .../azsdk-tools/create-release-plan.instructions.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md b/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md index c93c85a918..6cf0552192 100644 --- a/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md +++ b/eng/common/instructions/azsdk-tools/create-release-plan.instructions.md @@ -1,11 +1,10 @@ +> **Important Note for LLM** +> 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. +> 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. +> Only provide release plan details such as **Release Plan Link** and **Release Plan ID** to the user + # Release Plan Creation Process 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. - -> **Important Note** -> Do **not** ask the user to manually edit the DevOps work item. -> To update a release plan manually, the user must use the [Release Planner Tool](https://aka.ms/sdk-release-planner). -> When summarizing or displaying release plan details, do not mention or display the work item link/URL, or any direct reference to Azure DevOps work item resources. Only provide relevant release plan details like **Release Plan Link** and **Release Plan ID**. - Follow these steps in order to create or manage a release plan for an API specification pull request: ## Step 1: Validate Prerequisites