Merge branch 'main' into ngangwar/mhsm-sku-name-update

Author: neerjagangwar

.github/.prettierignore

@@ -24,3 +24,6 @@ PULL_REQUEST_TEMPLATE
 
 # synced from external repos
 workflows/post-apiview.yml
+
+# synced GitHub skills
+.github/skills/azsdk-common-*

.github/CODEOWNERS

@@ -13,7 +13,7 @@
 /specification/schemaregistry/ @hmlam @nickghardwick @lmazuel @deyaaeldeen @JoshLove-msft @swathipil @conniey @minhanh-phan
 
 # PRLabel: %Cognitive Services
-/dev/cognitiveservices/data-plane/Language/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @joseharriaga @minhanh-phan
+/dev/cognitiveservices/data-plane/Language/ @assafi @rokulka @ChongTang @heaths @deyaaeldeen @joseharriaga @minhanh-phan
 
 # PRLabel: %Foundry  %Client
 /specification/ai-foundry/data-plane/Foundry @johanste @trrwilson @glecaros @balapv @dargilco
@@ -71,19 +71,19 @@
 /specification/cognitiveservices/data-plane/FormRecognizer/ @bojunehsu @nizi1127 @johanste
 
 # PRLabel: %Cognitive - Language
-/specification/cognitiveservices/data-plane/LanguageAnalyzeConversations/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
+/specification/cognitiveservices/data-plane/LanguageAnalyzeConversations/ @assafi @rokulka @ChongTang @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
 
-/specification/cognitiveservices/data-plane/LanguageAnalyzeConversationsAuthoring/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
+/specification/cognitiveservices/data-plane/LanguageAnalyzeConversationsAuthoring/ @assafi @rokulka @ChongTang @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
 
-/specification/cognitiveservices/data-plane/LanguageAnalyzeDocuments/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
+/specification/cognitiveservices/data-plane/LanguageAnalyzeDocuments/ @assafi @rokulka @ChongTang @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
 
-/specification/cognitiveservices/data-plane/LanguageAnalyzeText/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
+/specification/cognitiveservices/data-plane/LanguageAnalyzeText/ @assafi @rokulka @ChongTang @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
 
-/specification/cognitiveservices/data-plane/LanguageAnalyzeTextAuthoring/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
+/specification/cognitiveservices/data-plane/LanguageAnalyzeTextAuthoring/ @assafi @rokulka @ChongTang @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
 
-/specification/cognitiveservices/data-plane/LanguageQuestionAnswering/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
+/specification/cognitiveservices/data-plane/LanguageQuestionAnswering/ @assafi @rokulka @ChongTang @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
 
-/specification/cognitiveservices/data-plane/LanguageQuestionAnsweringAuthoring/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
+/specification/cognitiveservices/data-plane/LanguageQuestionAnsweringAuthoring/ @assafi @rokulka @ChongTang @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
 
 
 # PRLabel: %Compute
@@ -309,6 +309,9 @@
 /.github/CODEOWNERS @Azure/azure-sdk-eng
 /.github/skills     @Azure/azure-sdk-eng @chunyu3 @lirenhe @ArthurMa1978 @haolingdong-msft
 
+## OpenAI TypeSpec Definitions (@azure-tools/openai-typespec)
+/.github/skills/openai-typespec-update/ @Azure/azure-sdk-eng @baywet @glecaros
+
 ## Copilot
 
 /.github/copilot-instructions.md         @praveenkuttappan @maririos
@@ -319,10 +322,9 @@
 
 ## ARM API Reviewer
 
-/.github/agents/*arm*.md                @raosuhas @ravimeda @laxmankumar12
-/.github/instructions/*arm*.md          @raosuhas @ravimeda @laxmankumar12
-/.github/skills/azure-api-review/       @raosuhas @ravimeda @laxmankumar12
-/documentation/api-reviewer-agent.md    @raosuhas @ravimeda @laxmankumar12
+/.github/**/*arm-*.md                  @raosuhas @ravimeda @laxmankumar12
+/.github/skills/azure-api-review/      @raosuhas @ravimeda @laxmankumar12
+/documentation/api-reviewer-agent.md   @raosuhas @ravimeda @laxmankumar12
 
 ## ARM API Modeling Reviewers
 

.github/agents/README.md

@@ -0,0 +1,29 @@
+# agents
+
+Custom Copilot Chat agents for this repo. Each `*.agent.md` at the top
+level is auto-registered by Visual Studio Code.
+
+## Agents
+
+| File                                                                 | Purpose                                                                          | User-invocable? |
+| -------------------------------------------------------------------- | -------------------------------------------------------------------------------- | --------------- |
+| [`arm-api-reviewer.agent.md`](./arm-api-reviewer.agent.md)           | Reviews Azure REST API spec PRs; findings verified by the Critic before posting. | Yes             |
+| [`arm-api-review-critic.agent.md`](./arm-api-review-critic.agent.md) | Internal subagent invoked by the Reviewer at Step 7 to re-verify findings.       | No              |
+| [`hero-scenarios.agent.md`](./hero-scenarios.agent.md)               | Suggests hero scenarios from TypeSpec to seed SDK samples, docs, and tests.      | Yes             |
+
+## Shared protocols
+
+Multi-agent contracts live in [`protocols/`](./protocols/). The
+subdirectory keeps reference files out of Visual Studio Code's agent scan path.
+
+- [`protocols/arm-api-review-critic.protocol.md`](./protocols/arm-api-review-critic.protocol.md)
+  is the Reviewer-Critic wire contract (inputs, verdicts, sentinels, marker schemas).
+  Source of truth if either agent file disagrees.
+
+## Conventions
+
+- Filename: `<short-name>.agent.md`, lowercase-hyphenated.
+- Internal subagents: set `user-invocable: false` in frontmatter.
+- Extract shared schemas to `protocols/` to prevent drift.
+- Prefer explicit tool allowlists over `github/*` for read-only agents.
+- No emoji or non-ASCII chars except where required by agent output.