work-item-context

name	work-item-context
description	Deeply gather context from an Azure DevOps work item by following its relations, linked PRs, hyperlinks, and comments. Use whenever a command needs the full picture behind a work item -- planning features, reviewing PRs, triaging, or estimating.

Work Item Context

Given a work item ID, build a rich understanding of the item by fetching the item itself and following its linked artefacts. Return a structured summary that the calling command can use as authoritative context.

Steps

1. Fetch the root work item

Call get_work_item with expand: "relations" to retrieve fields, relations, and linked resources in a single call.

Extract the core fields: title, type, state, description, acceptance criteria, repro steps (if present), assigned-to, iteration, and area path.

2. Follow work-item relations

Extract IDs from the relations array, grouped by link type:

• Parent
• Child
• Related
• Predecessor / Successor

Batch-fetch all linked work items via batch_search_workitems (up to 15 parallel searches in one call). For each, note its ID, title, type, and state.

Limit traversal to one hop -- do not recurse into the linked items' own relations.

3. Follow linked pull requests

Extract pull-request links from the relations array (vstfs:///Git/PullRequestId/...). Fetch each via get_pr_details and note the PR ID, title, status, source branch, and target branch.

4. Follow hyperlinks

Scan the description, acceptance criteria, and repro-steps fields for URLs. Categorise and fetch:

URL pattern	Action
ADO wiki link	Fetch via wiki_get_page_content
Other HTTP(S) URL	Fetch via WebFetch (best-effort; skip on failure)

Skip URLs that clearly point to images, videos, or binary assets.

5. Read comments

Comments are already included in the get_work_item response from step 1 (includeComments defaults to true). Incorporate any decisions, clarifications, or additional context from the comments.

6. Summarise

Produce a structured summary for the calling command:

## Work Item Context: #<ID> -- <Title>

**Type**: <type> | **State**: <state> | **Iteration**: <iteration>

### Goal
<Restated goal from description and acceptance criteria>

### Acceptance Criteria
<Bullet list, verbatim or lightly reformatted>

### Key Decisions (from comments)
<Bullet list of decisions, clarifications, or scope changes>

### Related Work Items
| ID | Title | Type | State | Relation |
|----|-------|------|-------|----------|

### Linked PRs
| ID | Title | Status | Branch |
|----|-------|--------|--------|

### Supplementary Material
<Summaries of fetched hyperlinks and wiki pages>

Omit any section that has no content rather than showing an empty table.