openspec-technical-definition

Generates technical definitions for Azure DevOps work items in OpenSpec workflow.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/dvazquezd/openspec-governance --skill openspec-technical-definition
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-technical-definition
Source: https://github.com/dvazquezd/openspec-governance/tree/main/.claude/skills/openspec-technical-definition
Command: npx skills add https://github.com/dvazquezd/openspec-governance --skill openspec-technical-definition

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the creation of detailed technical definitions for Azure DevOps work items, streamlining the process of translating requirements into actionable engineering tasks and ensuring alignment with the OpenSpec workflow.

Core Features & Use Cases

  • Automated Technical Definition Generation: Creates structured technical definitions based on Azure DevOps work item details, including affected components, acceptance criteria, and dependencies.
  • Scope Assessment & Decomposition: Analyzes work items to determine if they are atomic or epics, proposing decomposition into smaller, manageable changes when necessary.
  • OpenSpec Workflow Integration: Connects Azure DevOps tasks to the OpenSpec governance process, suggesting branch names and next steps for change creation.
  • Use Case: When a new Epic is created in Azure DevOps, this Skill can automatically break it down into User Stories, generate technical definitions for each, and suggest an implementation order, all while linking back to the original Epic.

Quick Start

Use the openspec-technical-definition skill to analyze work item 12345.

Frequently Asked Questions about openspec-technical-definition

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

FAQPage Schema
How do I generate technical definitions for Azure DevOps work items?

To generate technical definitions for Azure DevOps work items, you can use an OpenSpec workflow automation skill that reads work item details and project contexts to produce structured outputs. It automates translating requirements into actionable engineering tasks.

What is the best way to break down an epic in Azure DevOps into smaller tasks?

Breaking down an epic in Azure DevOps is best handled by analyzing scope and proposing work division into smaller, manageable changes. This approach decomposes epics into atomic tasks while generating acceptance criteria and identifying dependencies.

Do I need OpenSpec to define technical work items in Azure DevOps?

Yes, defining technical work items through this workflow requires both Azure DevOps and OpenSpec MCP servers. These servers are necessary to read work item details, access project contexts, and generate structured outputs for atomic or epic tasks.

Can I automate branch naming and change creation for Azure DevOps work items?

You can automate branch naming and change creation by connecting Azure DevOps tasks to the OpenSpec governance process. This integration suggests branch names and outlines next steps for change creation directly from the work item details.

How does scope assessment work for Azure DevOps epics and atomic tasks?

Scope assessment for Azure DevOps work items analyzes whether a task is atomic or an epic. When an epic is detected, it proposes a decomposition into smaller user stories, generates technical definitions for each, and suggests an implementation order.

What limitations exist when automating epic decomposition in Azure DevOps?

Limitations include a strict dependency on having both Azure DevOps and OpenSpec MCP servers configured. Without these servers to read project contexts and work item details, the tool cannot generate structured outputs or propose work division.