From 53af908ebca86c6ca01af97295e3ed22d14c2afa Mon Sep 17 00:00:00 2001
From: Azure SDK Bot <53356347+azure-sdk@users.noreply.github.com>
Date: Wed, 5 Nov 2025 09:28:27 -0800
Subject: [PATCH] Sync eng/common directory with azure-sdk-tools for PR 12476
 (#6816)

* add tool instructions prompt

* minor

* prompt revision

* prompt revision and fallback to core requirements

* rename langs to languages + revise prompt

* edit prompt and make checks concurrent

* fix prompt

* add venvPath argument

* minor prompt and log edit

---------

Co-authored-by: jennypng <63012604+JennyPng@users.noreply.github.com>
---
 .../azsdk-tools/verify-setup.instructions.md  | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 eng/common/instructions/azsdk-tools/verify-setup.instructions.md

diff --git a/eng/common/instructions/azsdk-tools/verify-setup.instructions.md b/eng/common/instructions/azsdk-tools/verify-setup.instructions.md
new file mode 100644
index 000000000..284e38417
--- /dev/null
+++ b/eng/common/instructions/azsdk-tools/verify-setup.instructions.md
@@ -0,0 +1,20 @@
+---
+description: 'Verify Setup'
+---
+
+## Goal
+This tool verifies the developer's environment for SDK development and release tasks. It returns what requirements are missing for the specified languages and repo.
+
+Your goal is to identify the project repo root, and pass in the `packagePath` to the Verify Setup tool. For a language repo, pass in the language of the repo.
+
+## Examples
+- in `azure-sdk-for-js`, run `azsdk_verify_setup` with `(langs=javascript, packagePath=<path>/azure-sdk-for-js)`.
+- in `azure-sdk-for-python`, run `azsdk_verify_setup` with `(langs=python, packagePath=<path>/azure-sdk-for-python, venvPath=<path-to-venv>)`.
+
+## Parameter Requirements
+WHENEVER Python is included in `langs`, BEFORE RUNNING `azsdk_verify_setup`, you MUST ASK THE USER TO SPECIFY WHICH virtual environment they want to check. DO NOT ASSUME THE VENV WITHOUT ASKING THE USER. After obtaining the `venvPath`, you can run the tool.
+
+The user can specify multiple languages to check. If the user wants to check all languages, pass in ALL supported languages and STILL ASK for a `venvPath`. Passing in no languages will only check the core requirements.
+
+## Output
+Display results in a user-friendly and concise format, highlighting any missing dependencies that need to be addressed.