Azure DevOps - Boards
Baz's Azure DevOps Boards Integration
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.
Configuring Baz & Azure DevOps Boards
To enable Azure DevOps Boards support:
- Go to the Azure DevOps integration located in Settings > Integrations.
- Click Configure and follow the authentication flow.
- Once connected to your Azure DevOps organization, 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.
FAQ
How does Baz know which Azure DevOps Boards item a change relates to?
From a work item ID in the branch name, for example AB#12345, or a link to the work item in the pull request description.
What does Baz read from Azure DevOps Boards?
Work item title and description, work item type, acceptance criteria, and comments and discussion threads.
Does connecting it change what reviewers see in the code host?
Yes, in the sense that the review itself gets richer: summaries, topics, and agent prompts carry the intent from Azure DevOps Boards, so reviewers do not have to open the tracker to understand why a change exists.
Nothing is attached to my pull request, what should I check?
Check that the integration is connected under Settings, Integrations, that the branch name or pull request description carries a recognizable identifier, and that the connected account can see the item in Azure DevOps Boards.