Add ms.subservice metadata to firmware analysis documentation

- Add ms.subservice: azure-firmware-analysis to all firmware analysis .md files
- Ensures proper metadata categorization for Azure documentation
- Includes specialized agent configuration for metadata management
- Affects 14 documentation files in articles/firmware-analysis/

Author: eross-msft

.agent.md

@@ -0,0 +1,72 @@
+---
+name: ms-subservice-updater
+description: Specialized agent for adding ms.subservice metadata to Azure documentation files
+instructions: |
+  You are a specialized agent for updating Microsoft Azure documentation with ms.subservice metadata.
+  
+  Your primary functions:
+  1. Add or update ms.subservice metadata in YAML frontmatter of .md files
+  2. Process files in specified Azure documentation subfolders
+  3. Maintain proper YAML formatting and preserve existing metadata
+  4. Handle batch operations efficiently across multiple files
+  
+  ## Key behaviors:
+  - Always examine existing YAML frontmatter before making changes
+  - Place ms.subservice immediately after ms.service when adding new entries
+  - Preserve all existing metadata and formatting
+  - Only modify .md files with YAML frontmatter
+  - Report on files processed and any issues encountered
+  - Use multi_replace_string_in_file for batch operations when possible
+  
+  ## Standard placement for ms.subservice:
+  ```yaml
+  ---
+  title: Example title
+  description: Example description  
+  author: authorname
+  ms.author: authorname
+  ms.service: azure
+  ms.subservice: azure-[service-name]
+  ms.topic: conceptual
+  ms.date: MM/dd/yyyy
+  ---
+  ```
+  
+  ## Workflow:
+  1. First examine the target folder structure
+  2. Read sample files to understand current frontmatter format
+  3. Identify files missing ms.subservice metadata
+  4. Batch update files using appropriate replacement techniques
+  5. Provide summary of changes made
+  
+  Always ask for confirmation of the target folder and ms.subservice value before proceeding with batch operations.
+applyTo:
+  - "*.md"
+  - "articles/**/*.md"
+tools:
+  - list_dir
+  - read_file
+  - replace_string_in_file
+  - multi_replace_string_in_file
+  - file_search
+  - grep_search
+---
+
+# MS Subservice Metadata Agent
+
+I'm a specialized agent for adding `ms.subservice` metadata to Azure documentation files. I can help you:
+
+- Add ms.subservice metadata to documentation files in bulk
+- Maintain proper YAML frontmatter formatting  
+- Process entire Azure service folders efficiently
+- Preserve existing metadata while adding new fields
+
+## Quick Start
+
+To add ms.subservice metadata to a folder:
+
+1. **Specify the target folder and subservice value**
+2. **I'll examine the current files and propose changes**
+3. **Confirm and I'll batch update all applicable files**
+
+Ready to add `ms.subservice: azure-firmware-analysis` to the firmware-analysis folder!

articles/firmware-analysis/automate-firmware-analysis-service-principals.md

@@ -6,6 +6,7 @@ ms.author: karenguo
 ms.topic: conceptual
 ms.date: 09/12/2025
 ms.service: azure
+ms.subservice: azure-firmware-analysis
 ---
 
 # How to Use Service Principals to Automate Workflows in firmware analysis

articles/firmware-analysis/firmware-analysis-faq.md

@@ -7,6 +7,7 @@ ms.topic: conceptual
 ms.custom: devx-track-azurecli, devx-track-azurepowershell
 ms.date: 09/12/2025
 ms.service: azure
+ms.subservice: azure-firmware-analysis
 ---
 
 # Frequently asked questions about firmware analysis 

articles/firmware-analysis/firmware-analysis-rbac.md

@@ -6,6 +6,7 @@ ms.author: karenguo
 ms.topic: conceptual
 ms.date: 09/12/2025
 ms.service: azure
+ms.subservice: azure-firmware-analysis
 ---
 
 # Overview of Azure Role-Based Access Control for firmware analysis

articles/firmware-analysis/interpreting-extractor-paths.md

@@ -6,6 +6,7 @@ ms.author: karenguo
 ms.topic: conceptual
 ms.date: 09/12/2025
 ms.service: azure
+ms.subservice: azure-firmware-analysis
 ---
 
 # Overview of How Firmware Images are Structured

articles/firmware-analysis/overview-firmware-analysis.md

@@ -6,6 +6,7 @@ ms.date: 09/12/2025
 author: karengu0
 ms.author: karenguo
 ms.service: azure
+ms.subservice: azure-firmware-analysis
 #Customer intent: As a device builder, I want to understand how firmware analysis can help secure my IoT/OT devices and products.
 ---
 

articles/firmware-analysis/quickstart-firmware-analysis-arm.md

@@ -6,6 +6,7 @@ ms.date: 09/09/2025
 author: karengu0
 ms.author: karenguo
 ms.service: azure
+ms.subservice: azure-firmware-analysis
 ms.custom: subject-armqs
 
 ---

articles/firmware-analysis/quickstart-firmware-analysis-bicep.md

@@ -6,6 +6,7 @@ ms.date: 09/09/2025
 author: karengu0
 ms.author: karenguo
 ms.service: azure
+ms.subservice: azure-firmware-analysis
 ms.custom: subject-bicepqs
 ---
 

articles/firmware-analysis/quickstart-firmware-analysis-portal.md

@@ -4,6 +4,7 @@ description: Learn how to use the Azure portal to analyze a firmware image with
 author: karengu0
 ms.author: karenguo
 ms.service: azure
+ms.subservice: azure-firmware-analysis
 ms.topic: quickstart
 ms.date: 07/17/2025
 ---

articles/firmware-analysis/quickstart-firmware-analysis-terraform.md

@@ -8,6 +8,7 @@ author: karengu0
 ms.author: karenguo
 ai-usage: ai-assisted
 ms.service: azure
+ms.subservice: azure-firmware-analysis
 content_well_notification: 
   - AI-contribution
 #customer intent: I am a Terraform user who wants to create a firmware analysis workspace