# Porcami AI Dotfiles Azure Devops Workflow

> Azure DevOps Workflow

- Skill: `tomevault-io/porcami-ai-dotfiles-azure-devops-workflow` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/porcami-ai-dotfiles-azure-devops-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/porcami-ai-dotfiles-azure-devops-workflow/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/porcami-ai-dotfiles-azure-devops-workflow

---


# Azure DevOps Workflow

## Work Item Types

| Type                           | Purpose                       |
| ------------------------------ | ----------------------------- |
| **Product Backlog Item (PBI)** | Deliverable feature or change |
| **Spike**                      | Time-boxed investigation      |

Both follow the same workflow states.

## Work Item States

```
New → Ready → In Progress → Awaiting Merge → Merged → Done
                  ↓
              Blocked
```

| State              | Description          | Assignment       |
| ------------------ | -------------------- | ---------------- |
| **New**            | Not yet refined      | Unassigned       |
| **Ready**          | Available to pick up | Unassigned       |
| **In Progress**    | Actively worked on   | Assigned         |
| **Blocked**        | External dependency  | Remains assigned |
| **Awaiting Merge** | PR created           | Remains assigned |
| **Merged**         | PR merged            | Remains assigned |
| **Done**           | Released             | Remains assigned |

## Valid Transitions

**Picking up:** `Ready` → `In Progress` (normal), `New` → `In Progress` (unusual), `Blocked` → `In Progress` (resuming)

**During development:** `In Progress` → `Blocked`, `In Progress` → `Awaiting Merge`

**Cannot pick up:** Items in `Awaiting Merge`, `Merged`, or `Done`

## Branch Naming

Format: `backlog/{workitem_id}-{short-description}`

- Lowercase, hyphen-separated, 3-5 words
- Remove repository hints: `[interest_accrual] Add X` → `backlog/12345-add-x`

### Hotfix Branch Naming

Format: `hotfix/{workitem_id}-{short-description}`

- Same naming rules as backlog branches
- Branch from `main` (not from a feature branch)
- Used only when user explicitly requests a hotfix (e.g., "this is a hotfix", "production emergency")
- Never auto-detected from Azure DevOps fields

## Workflow Types

| Workflow | Coder Agent | Review Mode | Branch Prefix | Default Commit Type |
|----------|-------------|-------------|---------------|---------------------|
| TDD | Coder | Standard | `backlog/` | `feat` |
| One-shot | Coder | Standard | `backlog/` | `feat` |
| Bug-fix | Coder | Regression + minimality | `backlog/` | `fix` |
| Refactoring | Coder | Behaviour preservation | `backlog/` | `refactor` |
| Chore | Coder | Lightweight | `backlog/` | `chore` |
| Hotfix | Coder | Expedited (security + regression) | `hotfix/` | `fix` |

## Repository Hints

Work item titles may include `[repository_name]` prefix. Verify current working directory matches before starting.

## Predecessor Validation

Before picking up, check Predecessor links. Warn if any predecessor is not in `Merged` or `Done`:

```
⚠️ Incomplete predecessors:
| ID | Title | State | Assigned To |
```

## PR Linking

Link using `AB#12345` or full URL. Creates bidirectional link.

## Default Branch

Check for `main` first, fall back to `master`:

```bash
git fetch origin
git rev-parse --verify origin/main >/dev/null 2>&1 && DEFAULT="main" || DEFAULT="master"
git checkout $DEFAULT && git pull origin $DEFAULT
git checkout -b backlog/{id}-{description}
```

## MCP Domains

- `core` — Project/team info
- `work` — Iterations, backlogs
- `work-items` — Work item CRUD
- `repositories` — Git, branches, PRs

Use batch tools for multiple updates.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/porcami) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->