From 05d6fdcf91fabd3934cb6f8f4fd5f4af9b3708c4 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 fa55d8edb0ff..0410e46a5d5e 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 db72d8e2e467f3975499edb2691e6209f8f2f9bc 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 0410e46a5d5e..0e4e60c2c110 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 323a77623bdd4ee2f2fbbb59398a0d19f054246e 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 0e4e60c2c110..02a825c9274a 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 2ef2ad23c50a6b379dc805df787566a45a32b219 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 02a825c9274a..5a8e035aad91 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 c2c159a89058beca1d8837391687beb211364013 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 5a8e035aad91..c93c85a91866 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 793abd849dd7f7726cd7ce84c1b3dc87ebe3db5d 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 c93c85a91866..6cf05521925b 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