Add Azure DevOps Integration extension to community catalog by pragya247 · Pull Request #1734 · github/spec-kit

pragya247 · 2026-03-02T19:09:36Z

Add Azure DevOps Integration Extension to Community Catalog

Description

This PR adds the Azure DevOps Integration extension to the Spec Kit community catalog, making it discoverable by users.

Key Changes:

Added to Community Catalog (extensions/catalog.community.json):
- Extension ID: azure-devops
- Version: 1.0.0
- Author: pragya247
- Download URL: https://github.com/pragya247/spec-kit-azure-devops/archive/refs/tags/v1.0.0.zip
- Repository: https://github.com/pragya247/spec-kit-azure-devops
Updated Extensions README (extensions/README.md):
- Added Azure DevOps Integration to the Available Community Extensions table
Reverted Core Integration:
- Previously added ADO scripts and templates to core - these have been reverted
- Azure DevOps functionality now lives in a separate extension repository following extension architecture guidelines

Extension Features

The Azure DevOps Integration extension provides:

Sync user stories from spec.md to Azure DevOps as User Story work items
Sync tasks from tasks.md to Azure DevOps as Task work items
OAuth authentication via Azure CLI (no PAT tokens required)
Interactive configuration for organization, project, and area path
Auto-linking of tasks to parent user stories
Work item mapping for tracking synced items
after_tasks hook for automatic synchronization

Installation

Users can install the extension with:

specify extension add --url https://github.com/pragya247/spec-kit-azure-devops/archive/refs/tags/v1.0.0.zip

Or discover it in the catalog:

specify extension search azure

Testing

Extension installed and tested locally with specify extension add --dev
Command /speckit.adosync works correctly in spec-kit projects
Extension repository published at https://github.com/pragya247/spec-kit-azure-devops
GitHub release v1.0.0 created
Verified catalog entry format follows schema

AI Disclosure

I did not use AI assistance for this contribution
I did use AI assistance (describe below)

AI Assistance:

Extension architecture design following Spec Kit extension system guidelines
Conversion from core integration to standalone extension
Catalog entry creation and validation
Extension manifest (extension.yml) generation
Command file creation with proper frontmatter and script references
Documentation and README generation

Copilot

Pull request overview

Adds Azure DevOps (ADO) work item synchronization support to Spec Kit’s command-template workflow by introducing a new speckit.adosync command template, cross-platform scripts to create/link work items via Azure CLI OAuth, and tests validating the new handoffs frontmatter field integration.

Changes:

Added speckit.adosync command template and ADO work item creation scripts (bash + PowerShell).
Updated existing command templates (specify, plan, tasks) to include handoffs entries that can route to ADO sync.
Added test coverage for handoffs parsing/rendering and AI skills generation compatibility.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 12 comments.

Show a summary per file

File	Description
tests/test_extensions.py	Adds unit tests covering `handoffs` parsing and command rendering/registration behavior.
tests/test_ai_skills.py	Adds tests ensuring skill generation works with templates that include `handoffs` and other complex frontmatter fields.
templates/commands/specify.md	Adds a `handoffs` entry to route from specify → adosync and updates next-step messaging.
templates/commands/plan.md	Adds a `handoffs` entry to route from plan → adosync (task sync).
templates/commands/tasks.md	Adds a `handoffs` entry to route from tasks → adosync.
templates/commands/adosync.md	Introduces the new adosync command template describing the interactive workflow and script execution.
scripts/powershell/create-ado-workitems.ps1	New PowerShell implementation to parse spec/tasks files and create/link ADO work items via `az boards`.
scripts/bash/create-ado-workitems.sh	New bash implementation to parse spec/tasks files and create/link ADO work items via `az boards`.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

scripts/powershell/create-ado-workitems.ps1

templates/commands/adosync.md

templates/commands/tasks.md

scripts/bash/create-ado-workitems.sh

scripts/powershell/create-ado-workitems.ps1

templates/commands/plan.md

scripts/bash/create-ado-workitems.sh

mnriem · 2026-03-03T14:27:17Z

Would love to see this land as an extension. See https://github.com/github/spec-kit/tree/main/extensions If you need more information let us know!

mnriem

See comments

pragya247 · 2026-03-03T18:23:46Z

https://github.com/pragya247/spec-kit-azure-devops

How about this? @mnriem
Shall I add some documentation here too?

mnriem · 2026-03-03T18:30:05Z

@pragya247 Looks great now just change the PR to list it in the extensions README.md and the community catalog :)

…-kit into pragya247-sdosync

t revert --abort Revert "Add Azure DevOps work item synchronization with handoffs system" This reverts commit 39ac7e4.

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

extensions/README.md

pragya247 · 2026-03-05T07:45:31Z

Please review @mnriem, reverted original changes and added required ones.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

extensions/catalog.community.json

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

extensions/catalog.community.json

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

mnriem · 2026-03-05T13:12:10Z

@pragya247 Thank you for the contribution!

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

) * Add Azure DevOps work item synchronization with handoffs system * Resolving the comments * Added details of Azure DevOps extention * t status t revert --abort Revert "Add Azure DevOps work item synchronization with handoffs system" This reverts commit 39ac7e4. * Update extensions/README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update extensions/catalog.community.json Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: pragya247 <pragya@microsoft.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Add Azure DevOps work item synchronization with handoffs system

39ac7e4

pragya247 requested a review from mnriem as a code owner March 2, 2026 19:09

Copilot AI review requested due to automatic review settings March 2, 2026 19:09

Copilot started reviewing on behalf of pragya247 March 2, 2026 19:10 View session

Copilot AI reviewed Mar 2, 2026

View reviewed changes

Resolving the comments

8a82c7b

mnriem requested changes Mar 3, 2026

View reviewed changes

pragya247 added 2 commits March 5, 2026 13:03

Added details of Azure DevOps extention

60d8952

Merge branch 'pragya247-sdosync' of https://github.com/pragya247/spec…

a94cddc

…-kit into pragya247-sdosync

Copilot AI review requested due to automatic review settings March 5, 2026 07:35

Copilot started reviewing on behalf of pragya247 March 5, 2026 07:35 View session

pragya247 and others added 2 commits March 5, 2026 13:09

t status

1b3454a

t revert --abort Revert "Add Azure DevOps work item synchronization with handoffs system" This reverts commit 39ac7e4.

Merge branch 'main' into pragya247-sdosync

3213cf6

Copilot AI reviewed Mar 5, 2026

View reviewed changes

extensions/README.md Outdated Show resolved Hide resolved

Update extensions/README.md

57279cb

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings March 5, 2026 07:46

Copilot started reviewing on behalf of pragya247 March 5, 2026 07:46 View session

Copilot AI reviewed Mar 5, 2026

View reviewed changes

extensions/catalog.community.json Show resolved Hide resolved

extensions/catalog.community.json Outdated Show resolved Hide resolved

Update extensions/catalog.community.json

8b2f5c7

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings March 5, 2026 07:58

Copilot started reviewing on behalf of pragya247 March 5, 2026 07:58 View session

Copilot AI reviewed Mar 5, 2026

View reviewed changes

extensions/catalog.community.json Show resolved Hide resolved

pragya247 changed the title ~~Add Azure DevOps work item synchronization with handoffs system~~ Add Azure DevOps Integration extension to community catalog Mar 5, 2026

pragya247 requested a review from mnriem March 5, 2026 12:58

mnriem approved these changes Mar 5, 2026

View reviewed changes

mnriem requested a review from Copilot March 5, 2026 13:02

Copilot started reviewing on behalf of mnriem March 5, 2026 13:03 View session

Copilot AI reviewed Mar 5, 2026

View reviewed changes

pragya247 closed this Mar 5, 2026

pragya247 reopened this Mar 5, 2026

mnriem requested a review from Copilot March 5, 2026 13:11

mnriem merged commit 8c3982d into github:main Mar 5, 2026
23 of 24 checks passed

Copilot started reviewing on behalf of mnriem March 5, 2026 13:12 View session

Copilot AI reviewed Mar 5, 2026

View reviewed changes

Conversation

pragya247 commented Mar 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Add Azure DevOps Integration Extension to Community Catalog

Description

Key Changes:

Extension Features

Installation

Testing

AI Disclosure

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mnriem commented Mar 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mnriem left a comment

Choose a reason for hiding this comment

Uh oh!

pragya247 commented Mar 3, 2026

Uh oh!

mnriem commented Mar 3, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

pragya247 commented Mar 5, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

mnriem commented Mar 5, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

pragya247 commented Mar 2, 2026 •

edited

Loading

mnriem commented Mar 3, 2026 •

edited

Loading