ado-sync

Synchronize SpecWeave increments with Azure DevOps work items bidirectionally.

156|21|Updated Oct 25, 2025
One-click install
npx skills add https://github.com/anton-abyzov/specweave --skill ado-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ado-sync
Source: https://github.com/anton-abyzov/specweave/tree/main/.claude/skills/ado-sync
Command: npx skills add https://github.com/anton-abyzov/specweave --skill ado-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual effort and inconsistencies that arise from updating project management tools (Azure DevOps) and development specifications (SpecWeave) separately, ensuring seamless alignment across your project.

Core Features & Use Cases

  • Bidirectional Sync: Synchronizes ADO Features, User Stories, and Tasks with SpecWeave increments, including status, descriptions, comments, and attachments.
  • Automated Work Item Creation: Automatically creates ADO work items from your SpecWeave feature plans.
  • Area Path & Iteration Mapping: Maps SpecWeave content to specific ADO Area Paths and Iterations for organized project tracking.
  • Use Case: Automatically create Azure DevOps User Stories and Tasks from your SpecWeave feature plans. As your team updates work item statuses in ADO, the corresponding SpecWeave documents are updated, providing a single source of truth.

Quick Start

Sync increment 0002 to Azure DevOps

Frequently Asked Questions about ado-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync Azure DevOps work items with SpecWeave automatically?

Bidirectional sync between Azure DevOps and SpecWeave keeps Features, User Stories, and Tasks aligned automatically. The Skill maps SpecWeave increments to ADO work item types, syncs status, descriptions, comments, and attachments in real-time using Azure DevOps REST API and webhooks.

Can I automatically create Azure DevOps tasks from SpecWeave feature plans?

Yes. The Skill automatically generates ADO work items from your SpecWeave increments, creating Features, User Stories, and Tasks without manual entry. It handles area path and iteration mapping to organize items within your ADO project structure.

What gets synced between SpecWeave and Azure DevOps?

Synced content includes work item status, descriptions, acceptance criteria, comments, and attachments across Epics, Features, User Stories, and Tasks. Area paths and iterations also map between systems, ensuring complete alignment of project metadata.

Does this work if my team uses both Azure DevOps and SpecWeave?

Yes. Bidirectional sync ensures that updates in either system—whether ADO status changes or SpecWeave document edits—propagate to the other in real-time, creating a single source of truth across both platforms.

How do I set up the sync between my Azure DevOps project and SpecWeave?

Configure Azure DevOps REST API credentials and webhook endpoints to establish the connection. Map your SpecWeave increments to ADO area paths and iterations, then initiate sync on specific increments to begin real-time synchronization.

What happens if I update a work item status in Azure DevOps?

Status changes in ADO automatically update the corresponding SpecWeave increment in real-time through webhooks. The sync maintains consistency so your SpecWeave documents reflect current ADO progress without manual intervention.