Passer au contenu

Add Your Heading Text Here

VERSION PACKAGE MODULE

Manage Versioned Requirement Packages and Variants Directly Inside Azure DevOps

Version Package lets you group any set of work items into a structured versioned package — keep items live and synced with Azure DevOps or pin them to a specific revision, compare versions, manage variants for different regions or platforms and generate audit-ready reports all without leaving ADO

100% native to Azure DevOps · Live and pinned revisions · Variant management · Server & Services
Release v4.2 · ResultLive
RunSmart ReportReviewVersionCopilot4DevOps
ResultCompareVariants
IDTypeWork itemRevision
VP-401 EPIC Checkout platform Live
VP-388 FEAT Payment gateway Live
VP-356 STORY Tokenized refunds Rev 7
VP-342 TEST Refund validation Live
VP-377 FEAT Audit logging Live
Compare versionsv1 SRR → v2 PDR
Added Deleted Updated Variant
+ ISO 27001 control mapped
EU variant: GDPR consent
Built into — and exports out of — the tools you already use
Azure DevOpsMicrosoft WordSmart Reports · Word / PDF / HTMLServer + Services
THE PROBLEM

No structured way to package and version your requirement sets

ADO backlogs are not packages. Sprints do not capture revisions. Release scope disappears the moment work items change.

NO VERSIONING

No named snapshot when the release ships

When a release goes out your team has no formal record of exactly which work items were included and at which revision. Reconstructing the requirement set for a post-release audit means manually searching revision histories across the entire backlog.

NO STRUCTURE

Work items grouped by sprint not by requirement hierarchy

Sprints organize work by time, not by requirement hierarchy. There is no ADO-native way to group a specific set of work items into a structured, template-driven package that enforces the correct Epic-Feature-Story-Test hierarchy across every delivery.

NO VARIANTS

One requirement set for every region and platform

Teams managing product variants for different regions, platforms or regulatory requirements maintain separate copies of requirement documents with no traceability between them. When the core requirement changes every copy must be updated manually — and none of them stay in sync.

HOW IT WORKS

From work items to a versioned structured package in three steps

No spreadsheets, no Word exports, no manual grouping. Version Package structures, versions and tracks your requirement sets inside Azure DevOps.

STEP 01

Design your package template

Open the Template Designer and define your work item hierarchy — Epic at the root, then Features, User Stories, Test Cases and Tasks. Set default field values, display properties and numbering per node. Mark nodes as Recursive if nesting is needed. Save once and reuse across every package.

STEP 02

Create your package and add work items

Select your template, name the package and source work items by query or search. ADO automatically pulls the full linked hierarchy beneath your selected Epics. Every work item is Live by default — always synced with Azure DevOps. Pin any item to a specific revision when needed.

STEP 03

Version, compare, review and export

Create named version snapshots at any milestone. Compare any two versions side by side with a color-coded diff. Send the package for formal review, generate a Smart Report in Word or PDF, or save directly to Document Management — all from the same toolbar.

WHAT YOU GET

Core capabilities that make Version Package the requirements delivery layer

PACKAGE TEMPLATES

Build templates once and create packages from them

Design your work item hierarchy once in the Template Designer — set Root Work Item Type, default field values, inherited properties and display columns per node. Save to the Meta Templates library. Select any saved template when creating a new package and the full hierarchy is applied instantly.

VARIANT MANAGEMENT

Package variants for different regions or platforms

Create a package variant as an exact copy of the current package in a target project. Modify specific work items in the variant to meet regional or platform-specific requirements while maintaining traceability back to the source. Enable propagation rules to automatically push source changes to all variants.

VERSION AND COMPARE

Create versions and compare packages or variants

Create named version snapshots at any milestone with a label and comment. Use Compare to Version to see a color-coded diff between any two versions of the same package. Use Compare with Package Variant to compare the current package against any of its source or target variants — green for added, red for deleted, yellow for updated.

ASSOCIATED PACKAGES

Sub packages and linked packages in both directions

Nest packages inside each other as Sub Packages, or connect them with directional Linked Packages — Up for upstream and Down for downstream. Create associated packages from scratch or link existing ones. Right-click any work item to scope a new sub or linked package to that specific item.

COPILOT4DEVOPS

Draft and manage work items using AI

Use Copilot4DevOps inside any package to draft new work items and insert them into the VPM. Transform content by summarizing, paraphrasing, translating or converting to Gherkin, Use Case or User Story format — applied directly to work item fields without leaving the package.

HIERARCHY INSERTION

Insert full work item trees in one drag

Open the Insert Work Items pane and source items by query or search. Insert a single item, a multi-item selection or an entire parent-child hierarchy in one drag. A green highlight confirms a valid drop position. Every inserted item connects to ADO in real time and refreshes on Run.

LIVE AND PINNED REVISIONS

Track how each work item connects to others

Open the Links side pane for any selected work item to see all its ADO relationships grouped by type — Child, Parent and Related. Work items already included in the current package are highlighted so you can immediately see what is covered. Add new links between any work items directly from the pane without leaving the package.

SAVE AS

Export to Word, PDF or document library

Click Save As to export any package as a formatted Word document or PDF using your organization's branded dotx templates. Save directly to the Document Management library for team-wide access without downloading. Choose from saved templates or upload a custom template for fully branded output.

GOVERNANCE & CONTROLS

Every control your compliance team needs built into the package

Revision pinning, package locking, version history, variant traceability and formal review integration — all native to Azure DevOps.

REVIEW INTEGRATION

Formal review and approval launched directly from any package

Click Review in the toolbar to send the package for structured review without leaving Version Package. Add Reviewers and Approvers, configure rules and send. All participants receive email notifications. The review appears in Review Management and generates an Approval Audit Report on closure.

PACKAGE LOCKING

Lock a package to prevent any further changes

Click Lock Package to disable all edit actions on the package immediately. A locked package cannot be modified by any team member until an authorized user explicitly clicks Unlock Package. Use this to protect formally reviewed and approved packages from unintended post-approval changes.

SMART REPORTS

Audit-ready output in Word, PDF or HTML

Generate a formatted Smart Report from any package using your organization's branded templates and stylesheets. Export as Word, PDF or HTML, or save directly to the Document Management library. The report captures the full package hierarchy, work item content and field values in one formatted document.

VARIANT TRACEABILITY

Source and target visible across every variant

The Variants tab shows the Source — which package this variant was derived from — and all Target variants created from this package. Navigate directly to any source or target variant by clicking its name. Every variant relationship is two-way and permanently recorded.

REVISION CONTROL

Exact revision of every work item is your choice

Each work item in a package can be Live or pinned to a specific revision independently. Set Version lets you choose from all available ADO revisions with a Version ID and date. Your package reflects precisely what you need — not just the latest state.

VERSION AUDIT TRAIL

Named version history with creator and timestamp

Every version created is logged with a label, version number, creation date, creator and status. Open any historical version in read-only mode to reconstruct the exact package state at any past milestone. The complete version list is always available in the Version Management dialog.

Evidence for the standards your team is audited against
DO-178CDO-254IEC 62304ISO 26262ASPICEEN 50128IEC 61508FDA 21 CFR Part 11GAMP 5SOXMIL-STD-882EFedRAMPNIST SP 800-53HIPAAISO 9001
BUILT FOR EVERY ROLE

Different roles that use Version Package to manage requirements delivery

From product owners packaging sprint scope to compliance managers creating locked audit packages — every role has a specific workflow inside Version Package.

Analyste d’affaires

Requirements package owner

Group a formal requirement set into a Version Package using the requirements query. Use the Insert Work Items pane to add individual items or full parent-child trees. Use Copilot4DevOps to generate User Stories from Features directly inside the package. Create a named version when the requirement set is agreed and send for review from the toolbar.

Systems Engineer

System requirement package owner

Create a Version Package for each system architecture layer — System, Subsystem, Software, Hardware — using a custom template with the correct hierarchy. Pin specific work items to the revision approved at each design review. Compare the PDR version to the CDR version and generate a color-coded difference report as formal scope change evidence.

Release Manager

Release baseline owner

At each release gate create a named version snapshot of the release requirement package with a label matching the release version — for example v4.2-rc1. Lock the package after formal sign-off to prevent post-approval changes. Generate a Smart Report of the locked version as the formal release baseline document for the delivery team and stakeholders.

Gestionnaire de conformité

Compliance package owner

Create Version Packages for each compliance control domain. Pin work items to the revision that was formally reviewed. Lock the package after the review cycle closes. Generate a Smart Report as the formal compliance documentation for the audit package. Use the version history as the tamper-evident record of when each package state was captured.

QA Lead

Test package owner

Create a test package grouping test requirements, test cases and linked user stories using the Tested By link type. Use Set Version to pin test cases to their review-approved revision before each test cycle. After testing compare the pre-test version to the current state to identify any test requirements that changed during execution.

Safety Engineer

Safety package owner

Create a safety requirement package with a custom template structured as Safety Goal → FSR → TSR. Create package variants for different ASIL levels — the variant starts as an exact copy of the source and is modified for the target safety integrity level. Enable propagation rules so that changes to shared source safety requirements flow into all variants automatically.

Configuration Manager

Configuration item package owner

Manage formal configuration items as Version Packages — SRS package, ICD package, STP package. At each configuration baseline event create a named version snapshot with a label matching the milestone — PDR, CDR, TRR. Lock each package immediately after formal review. Use the version history as the immutable configuration baseline record.

Regulatory Affairs Manager

Submission package owner

Create a Version Package of design input requirements and verification records for each regulatory submission. Pin all work items to the revision approved at the design review. Lock the package before submission. Generate a Smart Report as the formatted submission document. If the FDA or Notified Body requests changes unlock, update and create a new named version before re-submitting.

Propriétaire de produit

Release scope owner

Create a Version Package for each sprint using the ADO query as the source. ADO automatically pulls the full Epic-Feature-Story hierarchy beneath selected Epics. Create a named version snapshot before sprint planning. After the sprint compare the current state to the pre-sprint version to see what changed during execution.

Program Manager

Program package owner

Create a top-level program requirement package and use Linked Packages — Down direction — to connect it to each delivery team's project package. When a program-level requirement changes use propagation rules or manually update the linked downstream packages. Navigate between program and delivery packages directly from the Associated Packages pane.

Validation Lead

CSV package owner

Create Version Packages for URS, Functional Specification and Test Protocol work items at each CSV phase. Pin each package to the phase-acceptance revision and lock it after IQ, OQ and PQ sign-off. Generate Smart Reports from each locked version as the formal phase documentation included in the GAMP 5 validation lifecycle evidence package.

Supplier Manager

Cross-project package owner

Use Associated Packages to link the prime contractor's program requirement package to the supplier's ADO project package using a Down directional Linked Package. When the prime requirement changes the linked relationship is visible in both projects. Generate a Smart Report from the linked package and save to Document Management for the supplier to access.

INDUSTRY USE CASES

Version Package workflows across different regulated industries

Each use case below covers a real compliance scenario, the specific VPM capability that solves it and the exact workflow inside Azure DevOps.

AEROSPACE & DEFENSE
ARP4761 / SAE JA1011
Safety assessment engineer

ARP4761 safety assessment sub packages

Create a master safety assessment Version Package and add separate Sub Packages for each system function — one for FHA, one for PSSA and one for SSA. Each sub-package is scoped to its own work item set. Navigate between assessment levels directly from the Associated Packages pane without losing context of the master package.

MEDICAL DEVICES
IEC 60601-1 / Safety
Product systems engineer

Linked packages for device family requirements

Create a base IEC 60601-1 safety requirements package for the device platform and use Down Linked Packages to connect it to each product variant's project. When a platform-level safety requirement changes the linked relationship is visible in all downstream product packages — giving the product family a live traceability chain without maintaining separate documents.

AUTOMOTIVE
AUTOSAR / MISRA C
Software platform architect

AUTOSAR ECU configuration variants

Create a base AUTOSAR software requirements package and create variants for each ECU configuration — gateway, powertrain and ADAS. Enable propagation rules so changes to shared platform requirements flow into all ECU variants automatically. Use Compare with Package Variant to identify configuration-specific deviations between the base and any ECU variant.

RAILWAYS
EU CSM Regulation / ERA
Railway safety assessment coordinator

CSM phase version snapshots

Create named version snapshots of the railway change risk assessment package at each CSM phase — Hazard Identification, Risk Acceptance and Independent Assessment. Lock each version after the Independent Safety Assessor sign-off. Compare CSM phase versions side by side to show the ERA exactly what changed in the risk assessment between phases.

PHARMACEUTICAL
ICH Q10 / Pharmaceutical Quality System
Quality systems manager

ICH Q10 package template enforcement

Create a standardized ICH Q10 package template with process performance monitoring, CAPA and change management nodes as the mandatory hierarchy. Every site quality team creates their quality system packages from this template — enforcing the ICH Q10 structure across all manufacturing sites without relying on individuals to remember the correct work item hierarchy.

BANKING & FINANCE
PCI DSS v4.0 / Card Security
PCI compliance manager

PCI DSS quarterly version comparison

Create a Version Package of PCI DSS control implementation requirements at the start of each quarter. At the end of the quarter compare the current version to the start-of-quarter version using the color-coded Compare tab. Green items show new controls added, yellow shows updated implementations — giving the QSA an instant view of what changed in the cardholder data environment.

GOVERNMENT & DEFENSE
FISMA / NIST SP 800-53A
System authorization engineer

FISMA sub packages per system boundary

Create a master FISMA authorization package and add Sub Packages for each system boundary component — cloud infrastructure, on-premises servers and third-party integrations. Each sub-package contains the NIST controls applicable to that component. The master package gives the Authorizing Official a complete authorization picture while each component team manages only their own sub-package independently.

DEFENSE
MIL-STD-498 / Software Development
Software development manager

AI-generated software requirements in package

Create a Version Package for the MIL-STD-498 Software Requirements Specification work items. Select Feature-level work items and use Copilot4DevOps Transform to convert high-level capability descriptions into structured software requirement statements. Apply the Summarize transformation to condense lengthy inherited system requirements into concise software-level requirement titles — all without leaving the package.

HEALTHCARE IT
HL7 FHIR R4 / Interoperability
Clinical integration architect

FHIR integration template-based packages

Create a reusable FHIR integration requirements package template with Capability Statement, SearchParameter and OperationDefinition nodes as the mandatory hierarchy. Each integration project team creates their package from this template — ensuring every FHIR integration project captures the same compliance-required requirement categories without any manual restructuring or starting from a blank package.

ENERGY & UTILITIES
ISO 55001 / Asset Management
Asset integrity manager

ISO 55001 asset requirement hierarchy insertion

Select the full asset management requirement hierarchy from the ADO backlog — Asset Policy epics down through Strategic Plans, Objectives and Control Plans — and insert the complete parent-child tree into the Version Package in a single drag. The hierarchy lands with the correct structure intact. Run to refresh all items against the latest ADO state at any time.

ENTERPRISE SOFTWARE
CMMI Level 3 / Process Improvement
Process improvement lead

CMMI process area package versioning

Create a Version Package for each CMMI process area — Requirements Management, Project Planning, Verification. Create a named version snapshot at each CMMI appraisal cycle. Compare the current appraisal version to the previous one and generate a color-coded difference report showing the Lead Appraiser exactly which practice implementations changed between appraisal cycles.

TELECOM
ETSI EN 301 489 / EMC
EMC standards compliance engineer

ETSI EMC standard version comparison

Create a Version Package of ETSI EN 301 489 EMC conformance requirements. When the standard is revised create a new named version snapshot reflecting the updated requirement set. Compare the previous standard version to the updated version using the color-coded Compare tab — immediately identifying which EMC requirements changed, were added or were removed in the new standard revision.

WHERE TEAMS USE IT

Built for teams that need structured versioned requirement packages

COMPLIANCE

Versioned packages as formal audit evidence

Named version snapshots with label, creator and timestamp are permanently recorded. Lock a package after sign-off to prevent post-approval changes. Generate a Smart Report from any version in one click. Compliance teams get audit evidence that shows exactly what was in scope at any milestone — without manual reconstruction.

REGULATED

Variants for every regional or platform requirement

Regulated teams managing product variants for different markets create package variants instead of maintaining separate documents. Each variant traces back to its source. Propagation rules push source changes to all variants automatically. Traceability between the base and every variant is visible in the Variants tab at all times.

DELIVERY

Live work items always reflect current ADO state

Every work item in a package defaults to Live — always synced with Azure DevOps. Click Run to refresh the package against the latest data. Insert a full Epic-Feature-Story-Test hierarchy in a single drag. Teams build accurate, structured release packages from the backlog without manual copying or re-entry.

LEADERSHIP

One place to see every release scope and status

Instead of asking teams what is in scope for the next release leadership opens the Version Package and sees the complete structured requirement set directly from Azure DevOps — organized, versioned and always reflecting the latest agreed scope.

THE IMPACT

What changes when requirement packages are versioned inside Azure DevOps

70%
Less time spent preparing and packaging requirements for each release
50%
Less time managing cross-project requirements using variants and reuse
90%
Reduction in version confusion across distributed requirement teams
0
Rework caused by delivering requirements without a formal versioned package
FAQS

Frequently asked questions about Version Package

What is a Version Package and how does it work?
A Version Package is a structured, versioned group of Azure DevOps work items organized using a template-defined hierarchy. Work items can be Live — always synced with ADO — or pinned to a specific historical revision. Packages are used for release scopes, compliance documentation and formal requirement sets.
What is the difference between Live and pinned work items?
A Live work item always reflects the latest revision in Azure DevOps and updates automatically when ADO changes. A pinned work item is locked to a specific historical revision chosen from the work item's full revision history. Both modes can exist in the same package simultaneously.
How does Set Version work at the work item level?
Right-click any work item in the Result tab and select Set Version. A dialog opens showing all available revisions with their Version ID and Version Date. Select the revision you want to pin that item to. To return to live mode select the Live option in the same dialog.
What is a Package Template and how do I use it?
A Package Template defines the work item hierarchy and properties for every package built from it — Root Work Item Type, node hierarchy, default field values, inherited properties and display columns. Templates are saved in the Meta Templates library. Update a template and apply the changes to existing packages using Update Template.
What is the difference between Sub Packages and Linked Packages?
A Sub Package is a Version Package nested inside another — it sits beneath the current package in a parent-child relationship. A Linked Package is connected with a directional link — Up for upstream or parent, and Down for downstream or child. Both types can be created from new packages or from existing ones.
What are Package Variants and when should I use them?
Package Variants are alternative versions of a package for different regions, platforms or regulatory requirements. The variant starts as an exact copy of the source and is modified independently. Use variants when a core requirement set has market-specific or configuration-specific differences that need to be tracked separately but remain traceable to the source.
What does the Compare feature show in Version Package?
The Compare tab shows a color-coded side-by-side diff between any two named versions or between the current package and a variant. Green means added, red with strikethrough means deleted, orange means replaced with a variant, yellow means field-updated and diagonal lines mean the item is absent in the compared version.
How does Version Management work inside a package?
Click the Version button in the toolbar. In the Version Management dialog click Create, enter a Version Label and comment and click OK. The snapshot is saved immediately. Open any version in read-only mode to see the exact package at that point. Delete versions no longer needed — deleted versions cannot be recovered.
Can I use AI to draft and manage work items inside the package?
Yes. Select any work item and click Copilot4DevOps. The Elicit module generates User Stories from Features and Test Cases from User Stories — with full descriptions, acceptance criteria and test steps. The Transform module summarizes, paraphrases, translates and converts content. All generated items are created as real ADO work items linked to the package.
How do I insert a full work item hierarchy into a package?
Open the Insert Work Items pane from column settings. Enable the Select all work item(s) in hierarchy on selecting a node checkbox. Click any top-level item from the query results — all child items are automatically selected. Drag the entire selection into the package. The complete hierarchy is inserted with the correct parent-child structure intact in one action.
Does Lock Package prevent all team members from making changes?
Yes. Once a package is locked all edit actions — adding work items, removing items, editing fields, changing Set Version — are disabled for all team members. The package can only be unlocked by an authorized user clicking Unlock Package. Use this to protect a package after formal sign-off from unintended post-approval modifications.
Does Version Package work with Azure DevOps Server on-premises?
Yes. Version Package is certified for both Azure DevOps Services and Azure DevOps Server. All features — templates, Live and pinned revisions, version management, compare, variants, associated packages, Copilot4DevOps, Smart Reports and Review integration — are available in both environments.
GET STARTED

Package, version and deliver requirements without leaving Azure DevOps

Version Package is part of MR NextGen — built natively inside Azure DevOps. Group any set of work items into a structured versioned package, create named snapshots at every milestone, manage variants for every platform and generate audit-ready reports all in one place.

No migration required · Free trial available · No credit card required · Azure DevOps Server & Services
EXPLORE MR NEXTGEN

Complete your requirements workflow with the full MR NextGen platform

Version Package connects to every other MR NextGen module — launch reviews, create baselines and save reports all without leaving your package.

Smart Docs

Create living requirements documents by inserting work items from your ADO backlog. Save Smart Doc outputs directly to Document Management. Launch a baseline or review from any Smart Doc without navigating to a separate module.

Explore Smart Docs →

Traçabilité

Build intersection and horizontal traceability matrices from live ADO work items. Use a saved query as the source — the same query that drives your Version Package — to visualize coverage across the package work item set.

Explore Traceability →

Référence

Freeze any requirement set as an immutable snapshot at any milestone. Create a baseline directly from a completed Review or from the ADO Backlog without opening the Baseline module separately.

Explore Baseline →

Gestion de la revue

Collect formal approvals on any requirement set inside Azure DevOps. Click the Review button from inside any Version Package to launch a fully pre-loaded review request without navigating away.

Explore Review Management →

Gestion documentaire

Save Smart Reports from Version Package directly to the Document Management library in one click. Every report is versioned, organized and accessible to the whole team without manual downloading.

Explore Document Management →

Copilot4DevOps

The only AI requirements assistant built natively inside Azure DevOps. Use Elicit to generate User Stories and Test Cases inside your package, and Transform to summarize, paraphrase or convert content — without leaving Version Package.

Explore Copilot4DevOps →