Does this require a Personal Access Token (PAT)?

Yes, you must create an Azure DevOps PAT with Work Item and Comment (Read & Write) permissions and set it as the AZURE_DEVOPS_PAT environment variable.

How do I activate the Azure DevOps sync skill?

The skill provides help and configuration guidance when you ask about ADO integration. For actual execution of sync tasks, use the /sw-ado:sync command directly.

Is the synchronization bidirectional?

Yes, the skill supports bidirectional sync by default, allowing changes in either SpecWeave or Azure DevOps to be synchronized, though full bidirectional support may require webhook configuration.

What Azure DevOps work item types are supported?

The skill supports Epics, Features, and User Stories, which can be mapped to SpecWeave increments in your config.json file.

Can I sync progress automatically when tasks are completed?

Yes, when syncOnTaskComplete is enabled in your configuration, marking a task as done in SpecWeave will automatically update the linked ADO work item with a progress report.

Azure DevOps Sync for SpecWeave

Name: Azure DevOps Sync for SpecWeave
Author: anton-abyzov

byanton-abyzov

•

Collaboration Tools

Synchronizes SpecWeave development increments with Azure DevOps work items for seamless bidirectional project tracking.

About

The ado-sync skill integrates SpecWeave's autonomous development framework with Azure DevOps, enabling real-time synchronization of development tasks, comments, and status updates. It allows developers to automatically create Epics, Features, or User Stories from code increments and ensures that project management boards reflect the actual state of development directly from the terminal. This skill provides the necessary guidance, configuration patterns, and troubleshooting steps to maintain a unified workflow between local AI-driven coding and enterprise-level project tracking.

Key Features

13 GitHub stars
Bidirectional synchronization between SpecWeave increments and ADO work items.
Automated work item closing upon increment finalization.
Support for custom ADO fields, area paths, and iteration paths via JSON configuration.
Automatic creation of Epics, Features, and User Stories from development specs.
Real-time progress updates and comment syncing based on task completion.

Use Cases

Linking code-level increments to high-level Azure DevOps Epics for stakeholder visibility.
Automating project management updates while building software with SpecWeave and Claude.
Maintaining a single source of truth between terminal-based AI development and ADO boards.

About

Key Features

13 GitHub stars
Bidirectional synchronization between SpecWeave increments and ADO work items.
Automated work item closing upon increment finalization.
Support for custom ADO fields, area paths, and iteration paths via JSON configuration.
Automatic creation of Epics, Features, and User Stories from development specs.
Real-time progress updates and comment syncing based on task completion.

Use Cases

Linking code-level increments to high-level Azure DevOps Epics for stakeholder visibility.
Automating project management updates while building software with SpecWeave and Claude.
Maintaining a single source of truth between terminal-based AI development and ADO boards.