ado-claude-code

ado-claude-code

Azure DevOps meets AI — plan, track, and troubleshoot from your terminal.

Claude Code plugin for Azure DevOps integration. Sync workitems to local YAML files, plan workitem breakdowns with AI, manage troubleshooting instructions, and leverage AI-assisted diagnostics.

Features

• Workitem Sync — Bidirectional sync between Azure DevOps and local YAML files, with automatic sync state tracking across all CLI commands
• AI-Assisted Planning — Break down Epics into Features, Features into Stories, Stories into Tasks
• Code Planning — Generate implementation plans from workitems, with automatic state transition, comment posting, and multi-repo support
• Workitem Management — Create, update, and query workitems directly from the CLI
• Instructions Management — Create and manage structured troubleshooting instructions
• AI Troubleshooting — Diagnose issues by matching symptoms to instructions, run diagnostics, suggest resolutions

Installation

Option A: Plugin Marketplace (Recommended)

# 1. Add the marketplace
/plugin marketplace add EldonZhao/ado-claude-code

# 2. Install the plugin
/plugin install ado-claude-code@ado-claude-code

The CLI is pre-built and bundled with all dependencies — no npm install or build step needed after installation.

Option B: Local Plugin (Development / Testing)

git clone https://github.com/EldonZhao/ado-claude-code.git
cd ado-claude-code
npm install && npm run build

# Launch Claude Code with the plugin loaded
claude --plugin-dir ./ado-claude-code

Option C: Manual Copy

git clone https://github.com/EldonZhao/ado-claude-code.git
cd ado-claude-code
npm install && npm run build

# Copy plugin components into your project's .claude/ directory
cp -r commands/ /path/to/your-project/.claude/commands/
cp -r agents/ /path/to/your-project/.claude/agents/
cp -r rules/ /path/to/your-project/.claude/rules/

Note: With manual copy, commands are unnamespaced (e.g., /sync). With marketplace install, they are namespaced (e.g., /ado-claude-code:sync).

Setup

After installation, run the interactive setup in the Claude terminal:

/ado-claude-code:setup

This walks you through configuring your organization URL, project name, and authentication. Alternatively, run each step manually:

1. Initialize configuration

/ado-claude-code:setup init --url="https://dev.azure.com/your-org/YourProject"

Or use the legacy flags:

/ado-claude-code:setup init --organization="https://dev.azure.com/your-org" --project="YourProject"

Supported URL formats:

• https://dev.azure.com/<org>/<project>
• https://<org>.visualstudio.com/<project>

2. Login

/ado-claude-code:setup login

This starts a device-code flow — you'll see a URL and code in the terminal. Open the URL in your browser, enter the code, and sign in with your Azure AD account. The token is cached locally so subsequent commands authenticate automatically.

3. Validate connection

/ado-claude-code:setup validate

Alternative: PAT authentication

If you prefer a Personal Access Token instead of browser login:

export ADO_PAT="your-personal-access-token"

/ado-claude-code:setup init --url="https://dev.azure.com/your-org/YourProject" --authType=pat

Or:

/ado-claude-code:setup init --organization="https://dev.azure.com/your-org" --project="YourProject" --authType=pat

What's Included

Slash Commands (9)

Command	Description
/ado-claude-code:sync	Pull/push/full sync workitems with Azure DevOps
/ado-claude-code:code-plan	Generate a code implementation plan from a workitem (auto-updates state and adds comment)
/ado-claude-code:workitem-plan	AI-assisted workitem hierarchy breakdown
/ado-claude-code:workitem-query	Run WIQL queries or list local items
/ado-claude-code:workitem-create	Create a new workitem in Azure DevOps
/ado-claude-code:clear	Clear all synced workitems from local storage
/ado-claude-code:instructions	Create, manage, and troubleshoot with instructions
/ado-claude-code:setup	Initialize, validate, login/logout, or show configuration
/ado-claude-code:summary	Summarize Azure DevOps progress over a time period (week/month/custom)

Agents (2)

Agent	Description
ado-planner	Specialist for breaking down workitems into structured hierarchies
ado-troubleshooter	Specialist for diagnosing issues using instructions-based troubleshooting

Rules (1)

Rule	Description
ado-conventions	Always-active ADO naming conventions, YAML structure, sync workflow

CLI Reference

All commands are invoked as slash commands in the Claude terminal. With marketplace install, commands are prefixed with ado-claude-code:.

Help