> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coderabbit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Planning on Azure DevOps

> Generate comprehensive Coding Plans from Azure DevOps Boards work items.

export const ProPlusPlanBadge = ({tip = "This feature is available as part of the Pro+ plan and Enterprise plan. Please refer to our pricing page for more information about our plans and features.", title = "Pro+ Plan", cta = "Read more", href = "https://coderabbit.ai/pricing", disabled = false}) => {
  return <Tooltip tip={tip} cta={cta} href={href}>
        <Badge icon="shield-plus" disabled={disabled || undefined}>
            {title}
        </Badge>
    </Tooltip>;
};

export const AzureBadge = ({tip = "This feature is available on Azure DevOps.", title = "Azure", cta, href, disabled = false}) => {
  return <Tooltip tip={tip} cta={cta} href={href}>
        <Badge icon="microsoft" disabled={disabled || undefined}>
            {title}
        </Badge>
    </Tooltip>;
};

<AzureBadge /> | <ProPlusPlanBadge />

<Info>
  This guide covers work-item-based planning with Azure DevOps Boards. For the full CodeRabbit Plan documentation, see [CodeRabbit Plan](/plan).
</Info>

## Prerequisites

Complete the [Azure DevOps platform setup](/platforms/azure-devops) for the repositories you want CodeRabbit to plan against. The Azure DevOps user or service account configured for CodeRabbit must have read and write access to work items, as well as access to the related repository.

## Initiating Planning

### Manual Planning

<CardGroup cols={1}>
  <Card title="CodeRabbit Command" icon="terminal" horizontal="true">
    Comment `@coderabbitai plan` or `@coderabbit plan` on an Azure DevOps Boards work item to generate a plan.
  </Card>
</CardGroup>

<Info>
  You can also select the CodeRabbit user from the comment editor's @-mention
  picker and type `plan` after the mention.
</Info>

### Auto-Planning

Auto-planning is not yet available for Azure DevOps Boards. Use the plan command to generate plans on demand. Auto-planning rulesets are available for [Jira](/issues/planner/jira) and [Linear](/issues/planner/linear), and label-based auto-planning is available for [GitHub](/issues/planner/github) and [GitLab](/issues/planner/gitlab).

## Repository Resolution

Since Azure DevOps Boards work items aren't always tied to a specific repository, CodeRabbit needs to determine which repository to analyze when generating a plan.

CodeRabbit attempts to resolve the repository in this order:

<Steps>
  <Step title="Check Work Item Description">
    If the work item description contains `repository: <repo-name>` or a link to a repository, CodeRabbit uses that repository.

    ```markdown theme={null}
    repository: my-repo
    OR
    repository: https://dev.azure.com/my-org/my-project/_git/my-repo
    ```
  </Step>

  <Step title="Automatic Detection">
    CodeRabbit leverages its deep understanding of your project to intelligently
    predict which repository is most relevant.
  </Step>

  <Step title="Ask the User">
    If CodeRabbit can't confidently determine the repository, it replies to the work item asking you to specify which repository to use. Reply with the repository name in a follow-up work item comment to continue planning.
  </Step>
</Steps>

## Viewing and Refining Plans

Once a Coding Plan is generated, CodeRabbit replies on the work item with a link to the plan in the CodeRabbit web app. Anyone in your organization can view and work with the plans.

<Info>
  Plans in the web app are organization-specific. If a plan shows a 404 error,
  verify you're viewing the correct organization in the CodeRabbit web app.
</Info>

<Frame caption="View Coding Plans in the CodeRabbit web app">
  <img src="https://mintcdn.com/coderabbit/0_UNDuRPehZvImxS/assets/images/plan-editor.png?fit=max&auto=format&n=0_UNDuRPehZvImxS&q=85&s=675d1c116a50b922932579684cb300c3" alt="View Coding Plans in the CodeRabbit web app" width="2918" height="1596" data-path="assets/images/plan-editor.png" />
</Frame>

### Chatting about Your Plan

Use the chat panel on the right side of the plan viewer in the CodeRabbit web app to:

* Ask questions about the plan or the codebase
* Request changes to specific tasks or phases
* Challenge design choices and provide additional context
* Get clarification on implementation details

### Re-planning

After providing feedback through chat:

1. Review your feedback in the chat history
2. Click the **Redo** button
3. CodeRabbit generates a new plan version incorporating your feedback

### Version History

Each re-plan creates a new version. Use the version selector at the top of the plan viewer to:

* View previous versions
* Compare what changed between versions
* Revert to an earlier version by marking it as active

<Info>You can only chat about the currently active version.</Info>

### Handing Off to a Coding Agent

Click the **Handoff** button at the bottom of the plan viewer to see your options:

#### Copy to Clipboard

Copy the agentic prompts to your clipboard, then paste them into your preferred coding agent (Claude Code, Cursor, GitHub Copilot, etc.).

#### IDE Extension

If you have the CodeRabbit IDE extension installed, the Coding Plan can be sent directly to your coding agent through the extension. The agentic prompts appear in your coding agent's input field, ready to execute.

If you don't have the extension installed, you'll be prompted to install it.