azure-devops-create-work-item

Azure DevOps — Create Work Item

Goal

Create a properly structured Azure DevOps work item from a Smart SDLC story, with full acceptance criteria, story points, and area path set correctly.

---

Prerequisite Check

Check integrations.azure_devops in _superml/config.yml. If missing: "Run azure-devops-connect first."

---

Step 1: Load Story

Ask: "Which story are you creating a work item for?" (accept S-ID or title)

Load the story file. Extract:

• Title
• Acceptance criteria
• Story points / estimate
• Priority
• Epic link (if any)

---

Step 2: Select Work Item Type

Map story type to ADO work item type:

Story Type	ADO Work Item Type
Feature / user story	User Story
Technical task	Task
Bug	Bug
Spike	Task (with [SPIKE] prefix)

---

Step 3: Create Work Item

az boards work-item create \
  --title "{story_title}" \
  --type "{work_item_type}" \
  --description "{story_description}" \
  --fields \
    "Microsoft.VSTS.Scheduling.StoryPoints={points}" \
    "Microsoft.VSTS.Common.Priority={priority}" \
    "System.AreaPath={area_path}"

---

Step 4: Add Acceptance Criteria

az boards work-item update \
  --id {work_item_id} \
  --fields "Microsoft.VSTS.Common.AcceptanceCriteria={formatted_acs}"

Format ACs as HTML list:

<ul>
  <li>AC-1: ...</li>
  <li>AC-2: ...</li>
</ul>

---

Step 5: Update Story File

Add ADO work item reference to story frontmatter:

ado_id: {work_item_id}
ado_url: "https://dev.azure.com/{org}/{project}/_workitems/edit/{id}"

---

Done

✅ Work item #{work_item_id} created: {url}