Expert Review Routing
This skill maps changed folders to review dimensions, enabling focused expert reviews of vstest PRs.
Folder → Dimension Routing Table
| Folder |
Primary Dimensions |
eng/ |
Build Script & Infrastructure Hygiene, Dependency & Package Integrity, Source Build & Cross-Platform Compliance |
src/Microsoft.TestPlatform.CrossPlatEngine/ |
Parallel Execution & Scheduling Safety, Error Reporting & Diagnostic Clarity, Process Architecture & Host Resolution |
src/vstest.console/ |
RunSettings Validation & Inference, Process Architecture & Host Resolution, Environment Variable & Feature Flag Contracts |
test/Microsoft.TestPlatform.Acceptance.IntegrationTests/ |
Acceptance Test Coverage Design, Cross-TFM & Framework Resolution, Parallel Execution & Scheduling Safety |
src/Microsoft.TestPlatform.Extensions.BlameDataCollector/ |
Crash & Hang Dump Reliability, Error Reporting & Diagnostic Clarity, Environment Variable & Feature Flag Contracts |
src/testhost/ |
Testhost Assembly Loading & Resolution, Cross-TFM & Framework Resolution, Process Architecture & Host Resolution |
src/Microsoft.TestPlatform.CommunicationUtilities/ |
IPC Transport & Protocol Stability, Error Reporting & Diagnostic Clarity, Dependency & Package Integrity |
src/Microsoft.TestPlatform.ObjectModel/ |
Public API Surface Protection, Backward Compatibility & Rollback Safety, Cross-TFM & Framework Resolution |
src/package/ |
Dependency & Package Integrity, Build Script & Infrastructure Hygiene, Cross-TFM & Framework Resolution |
src/Microsoft.TestPlatform.Common/ |
Backward Compatibility & Rollback Safety, Error Reporting & Diagnostic Clarity, Null Safety & Boundary Validation |
src/Microsoft.TestPlatform.VsTestConsole.TranslationLayer/ |
IPC Transport & Protocol Stability, Error Reporting & Diagnostic Clarity, Backward Compatibility & Rollback Safety |
src/Microsoft.TestPlatform.Client/ |
IPC Transport & Protocol Stability, Backward Compatibility & Rollback Safety, Public API Surface Protection |
src/datacollector/ |
Crash & Hang Dump Reliability, Dependency & Package Integrity, Error Reporting & Diagnostic Clarity |
src/Microsoft.TestPlatform.CoreUtilities/ |
Process Architecture & Host Resolution, Environment Variable & Feature Flag Contracts, Error Reporting & Diagnostic Clarity |
src/Microsoft.TestPlatform.TestHostProvider/ |
Process Architecture & Host Resolution, Environment Variable & Feature Flag Contracts, Testhost Assembly Loading & Resolution |
Quick Reference: Dimension Summaries
| Dimension |
Focus |
| Dependency & Package Integrity |
Version conflicts, transitive deps, package content correctness |
| Cross-TFM & Framework Resolution |
Multi-TFM builds, binding redirects, framework-specific behavior |
| Process Architecture & Host Resolution |
x86/x64/ARM64 selection, DOTNET_ROOT propagation, muxer resolution |
| Parallel Execution & Scheduling Safety |
Race conditions, lock scopes, worker slot assignment, cancellation |
| IPC Transport & Protocol Stability |
Wire compatibility, connection timeouts, protocol versioning |
| Crash & Hang Dump Reliability |
Dump capture under compound failures, detach timing, file validity |
| Error Reporting & Diagnostic Clarity |
Actionable messages, trace formatting, exception propagation |
| Environment Variable & Feature Flag Contracts |
Naming conventions, propagation, stable contract semantics |
| RunSettings Validation & Inference |
Defensive XML parsing, defaults, source precedence |
| Backward Compatibility & Rollback Safety |
Disable flags, version-guarded behavior, migration paths |
| Public API Surface Protection |
Unintentional exposure, PublicAPI.txt management, interface evolution |
| Acceptance Test Coverage Design |
Focused matrices, OS coverage, measurement-backed claims |
| Testhost Assembly Loading & Resolution |
deps.json alignment, RID assets, TypeLoadException handling |
| Build Script & Infrastructure Hygiene |
Exit codes, cross-platform scripts, source-build compatibility |
| Null Safety & Boundary Validation |
Boundary checks, nullable annotations, defensive parsing |
| Source Build & Cross-Platform Compliance |
Source-build mode, Linux/macOS paths, shell compatibility |
Common Review Scenarios
PR touches src/Microsoft.TestPlatform.CrossPlatEngine/
→ Activate: Parallel Execution & Scheduling Safety, Error Reporting & Diagnostic Clarity, Process Architecture & Host Resolution
PR modifies eng/ scripts or build infrastructure
→ Activate: Build Script & Infrastructure Hygiene, Dependency & Package Integrity, Source Build & Cross-Platform Compliance
PR changes ObjectModel public API
→ Activate: Public API Surface Protection, Backward Compatibility & Rollback Safety, Cross-TFM & Framework Resolution
PR updates CommunicationUtilities or TranslationLayer
→ Activate: IPC Transport & Protocol Stability, Backward Compatibility & Rollback Safety, Error Reporting & Diagnostic Clarity
PR modifies blame/datacollector components
→ Activate: Crash & Hang Dump Reliability, Environment Variable & Feature Flag Contracts, Error Reporting & Diagnostic Clarity
PR adds or bumps package dependencies
→ Activate: Dependency & Package Integrity, Cross-TFM & Framework Resolution, Backward Compatibility & Rollback Safety
PR touches testhost or TestHostProvider
→ Activate: Testhost Assembly Loading & Resolution, Process Architecture & Host Resolution, Cross-TFM & Framework Resolution
PR modifies RunSettings handling in vstest.console
→ Activate: RunSettings Validation & Inference, Environment Variable & Feature Flag Contracts, Backward Compatibility & Rollback Safety
Integration with @expert-reviewer
This skill provides the routing configuration that tells the expert-reviewer agent which dimensions to activate for a given PR. The agent owns the full CHECK methodology and review logic.
Invocation: Reference @expert-reviewer in a PR comment or use the pr-expert-reviewer workflow.
How routing works:
- Agent identifies changed files/folders in the PR
- This skill's routing table maps folders to applicable dimensions
- Agent activates the matched dimensions and applies their CHECK items
- Agent produces findings limited to activated dimensions only
Scope boundaries:
- This skill: folder-to-dimension mapping, dimension summaries, scenario examples
- The agent: full CHECK items, severity classification, comment formatting, review decisions
vstest-build-test skill: build/test commands (not review logic)trx-analysis skill: test result file parsing (not code review)
1---2name: expert-reviewing3description: Route code changes to relevant review dimensions based on affected files and folders. Use when reviewing PRs, analyzing code quality, or performing targeted reviews of specific vstest subsystems.4---56# Expert Review Routing78This skill maps changed folders to review dimensions, enabling focused expert reviews of vstest PRs.910## Folder → Dimension Routing Table1112| Folder | Primary Dimensions |13|--------|-------------------|14| `eng/` | Build Script & Infrastructure Hygiene, Dependency & Package Integrity, Source Build & Cross-Platform Compliance |15| `src/Microsoft.TestPlatform.CrossPlatEngine/` | Parallel Execution & Scheduling Safety, Error Reporting & Diagnostic Clarity, Process Architecture & Host Resolution |16| `src/vstest.console/` | RunSettings Validation & Inference, Process Architecture & Host Resolution, Environment Variable & Feature Flag Contracts |17| `test/Microsoft.TestPlatform.Acceptance.IntegrationTests/` | Acceptance Test Coverage Design, Cross-TFM & Framework Resolution, Parallel Execution & Scheduling Safety |18| `src/Microsoft.TestPlatform.Extensions.BlameDataCollector/` | Crash & Hang Dump Reliability, Error Reporting & Diagnostic Clarity, Environment Variable & Feature Flag Contracts |19| `src/testhost/` | Testhost Assembly Loading & Resolution, Cross-TFM & Framework Resolution, Process Architecture & Host Resolution |20| `src/Microsoft.TestPlatform.CommunicationUtilities/` | IPC Transport & Protocol Stability, Error Reporting & Diagnostic Clarity, Dependency & Package Integrity |21| `src/Microsoft.TestPlatform.ObjectModel/` | Public API Surface Protection, Backward Compatibility & Rollback Safety, Cross-TFM & Framework Resolution |22| `src/package/` | Dependency & Package Integrity, Build Script & Infrastructure Hygiene, Cross-TFM & Framework Resolution |23| `src/Microsoft.TestPlatform.Common/` | Backward Compatibility & Rollback Safety, Error Reporting & Diagnostic Clarity, Null Safety & Boundary Validation |24| `src/Microsoft.TestPlatform.VsTestConsole.TranslationLayer/` | IPC Transport & Protocol Stability, Error Reporting & Diagnostic Clarity, Backward Compatibility & Rollback Safety |25| `src/Microsoft.TestPlatform.Client/` | IPC Transport & Protocol Stability, Backward Compatibility & Rollback Safety, Public API Surface Protection |26| `src/datacollector/` | Crash & Hang Dump Reliability, Dependency & Package Integrity, Error Reporting & Diagnostic Clarity |27| `src/Microsoft.TestPlatform.CoreUtilities/` | Process Architecture & Host Resolution, Environment Variable & Feature Flag Contracts, Error Reporting & Diagnostic Clarity |28| `src/Microsoft.TestPlatform.TestHostProvider/` | Process Architecture & Host Resolution, Environment Variable & Feature Flag Contracts, Testhost Assembly Loading & Resolution |2930## Quick Reference: Dimension Summaries3132| Dimension | Focus |33|-----------|-------|34| Dependency & Package Integrity | Version conflicts, transitive deps, package content correctness |35| Cross-TFM & Framework Resolution | Multi-TFM builds, binding redirects, framework-specific behavior |36| Process Architecture & Host Resolution | x86/x64/ARM64 selection, DOTNET_ROOT propagation, muxer resolution |37| Parallel Execution & Scheduling Safety | Race conditions, lock scopes, worker slot assignment, cancellation |38| IPC Transport & Protocol Stability | Wire compatibility, connection timeouts, protocol versioning |39| Crash & Hang Dump Reliability | Dump capture under compound failures, detach timing, file validity |40| Error Reporting & Diagnostic Clarity | Actionable messages, trace formatting, exception propagation |41| Environment Variable & Feature Flag Contracts | Naming conventions, propagation, stable contract semantics |42| RunSettings Validation & Inference | Defensive XML parsing, defaults, source precedence |43| Backward Compatibility & Rollback Safety | Disable flags, version-guarded behavior, migration paths |44| Public API Surface Protection | Unintentional exposure, PublicAPI.txt management, interface evolution |45| Acceptance Test Coverage Design | Focused matrices, OS coverage, measurement-backed claims |46| Testhost Assembly Loading & Resolution | deps.json alignment, RID assets, TypeLoadException handling |47| Build Script & Infrastructure Hygiene | Exit codes, cross-platform scripts, source-build compatibility |48| Null Safety & Boundary Validation | Boundary checks, nullable annotations, defensive parsing |49| Source Build & Cross-Platform Compliance | Source-build mode, Linux/macOS paths, shell compatibility |5051## Common Review Scenarios5253**PR touches `src/Microsoft.TestPlatform.CrossPlatEngine/`**54→ Activate: Parallel Execution & Scheduling Safety, Error Reporting & Diagnostic Clarity, Process Architecture & Host Resolution5556**PR modifies `eng/` scripts or build infrastructure**57→ Activate: Build Script & Infrastructure Hygiene, Dependency & Package Integrity, Source Build & Cross-Platform Compliance5859**PR changes `ObjectModel` public API**60→ Activate: Public API Surface Protection, Backward Compatibility & Rollback Safety, Cross-TFM & Framework Resolution6162**PR updates `CommunicationUtilities` or `TranslationLayer`**63→ Activate: IPC Transport & Protocol Stability, Backward Compatibility & Rollback Safety, Error Reporting & Diagnostic Clarity6465**PR modifies blame/datacollector components**66→ Activate: Crash & Hang Dump Reliability, Environment Variable & Feature Flag Contracts, Error Reporting & Diagnostic Clarity6768**PR adds or bumps package dependencies**69→ Activate: Dependency & Package Integrity, Cross-TFM & Framework Resolution, Backward Compatibility & Rollback Safety7071**PR touches testhost or TestHostProvider**72→ Activate: Testhost Assembly Loading & Resolution, Process Architecture & Host Resolution, Cross-TFM & Framework Resolution7374**PR modifies RunSettings handling in vstest.console**75→ Activate: RunSettings Validation & Inference, Environment Variable & Feature Flag Contracts, Backward Compatibility & Rollback Safety7677## Integration with @expert-reviewer7879This skill provides the **routing configuration** that tells the expert-reviewer agent which dimensions to activate for a given PR. The agent owns the full CHECK methodology and review logic.8081**Invocation:** Reference `@expert-reviewer` in a PR comment or use the `pr-expert-reviewer` workflow.8283**How routing works:**841. Agent identifies changed files/folders in the PR852. This skill's routing table maps folders to applicable dimensions863. Agent activates the matched dimensions and applies their CHECK items874. Agent produces findings limited to activated dimensions only8889**Scope boundaries:**90- This skill: folder-to-dimension mapping, dimension summaries, scenario examples91- The agent: full CHECK items, severity classification, comment formatting, review decisions92- `vstest-build-test` skill: build/test commands (not review logic)93- `trx-analysis` skill: test result file parsing (not code review)
Microsoft