# Azure DevOps - Boards

By pulling in work item information like titles, descriptions, types, acceptance criteria, and stakeholder comments, Baz ensures that every change request is grounded in intent. Reviewers no longer need to switch between Azure DevOps Boards and GitHub to understand why a change exists - they get the full context, right where the code is.

Baz uses this context to:

* Enrich AI-generated summaries and topics with business objectives.
* Tailor prompts to reflect the goals and constraints from the Boards ticket.
* Help reviewers focus on what’s important by aligning code changes to the original intent.

<figure><img src="/files/m9AZupzbnUfFN8r5GXP9" alt=""><figcaption><p>Configure Azure DevOps Boards integration</p></figcaption></figure>

#### **Configuring Baz & Azure DevOps Boards**

To enable Azure DevOps Boards support:

1. Go to the **Azure DevOps integration** located in Settings > Integrations.
2. Click **Configure** and follow the authentication flow.
3. Once connected to your Shortcut Workspace, Baz will automatically attach ticket context to linked change requests.

> **Tip:**\
> Baz detects relevant work items when the branch name includes a work item ID (e.g. `AB#12345`), or when the PR description contains a link to an ADO Boards work item.

### **How Baz Uses Azure DevOps Boards Work Item Data**

When connected, Baz pulls:

* **Work item title and description** - used to inform review summaries and reasoning.
* **Work item type** (feature, bug, task) - guides reviewer expectations.
* **Acceptance criteria** - injected directly into prompts for better validation.
* **Comments and discussion threads** - used to provide full context in reviews.

This information flows into all Baz workflows:

* Summaries reflect the purpose and constraints defined in the work item.
* Break down topics based on feature or flow relevance.
* Guide reviewers to evaluate changes through the lens of what the ticket was designed to accomplish.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.baz.co/basics/integrations/azure-devops-boards.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.