ado-pull

A command that brings changes from Azure DevOps, Microsoft's project-management and code-hosting service, into local project documents. It can sync one work item, a project, a feature hierarchy, or all linked documents.

In plain words
What is it for?
Use it to pull updates for an active increment, a project, a feature and its user stories, or every linked specification across projects.
Why use it?
It avoids checking each Azure DevOps item and updating its matching local document by hand. It also keeps local specifications aligned with changes made in Azure DevOps.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/anton-abyzov/specweave/ado-pull
Clone the repo
git clone --depth 1 https://github.com/anton-abyzov/specweave
Per session 23 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 3,355 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00023 $0.03355
Opus 5 $0.00012 $0.01677
Sonnet 5 $0.00005 $0.00671
Haiku 4.5 $0.00002 $0.00335

Measured yesterday against content hash 4d83a39ffead, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

ado-pull scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/specweave/commands/ado-pull.md · 489 lines

How it starts

The opening of the file, as written. The whole thing — 489 lines — stays where its author put it; the contents beside it link to each section on GitHub.

ADO Pull Command

Usage: sw-ado:pull [target] [options]

Purpose: Pull latest changes from Azure DevOps (like git pull)


Quick Start

# Pull for current/active increment (simple mode)
sw-ado:pull

# Pull for specific increment
sw-ado:pull 0005

# Pull ALL changes across ALL projects (living docs sync)
sw-ado:pull --all

# Pull for specific project/board
sw-ado:pull --project clinical-insights

# Pull specific feature hierarchy (Epic → Feature → User Stories)
sw-ado:pull --feature FS-042

Sync Modes

Mode 1: Increment Sync (Default)

sw-ado:pull [increment-id]

Syncs ONE increment ↔ ONE linked work item.

Mode 2: Living Docs Sync (Full)

sw-ado:pull --all [--time-range 1M]

Syncs ALL specs across ALL projects/boards:

  • Discovers all linked specs in .specweave/docs/internal/specs/
  • Fetches changes from ADO for each linked item
  • Updates User Stories, Features, Epics
  • Respects multi-project folder structure

Mode 3: Project-Scoped Sync

sw-ado:pull --project clinical-insights

Syncs all specs within a specific project folder:

specs/clinical-insights/
├── FS-042/us-001.md  ← Synced
├── FS-042/us-002.md  ← Synced
└── FS-043/us-003.md  ← Synced

Mode 4: Feature Hierarchy Sync

sw-ado:pull --feature FS-042

Syncs a specific feature and ALL its children:

ADO Epic #100
  └── Feature #200 (FS-042)  ← Synced
       └── US-001 #201       ← Synced
       └── US-002 #202       ← Synced
       └── US-003 #203       ← Synced

What Gets Pulled

Field Behavior
Status External ALWAYS wins (QA/stakeholder decisions)
Priority External wins (stakeholder prioritization)
Iteration/Sprint Updated if changed in ADO
Comments New team comments imported
Assignee Updated if changed
Parent Links Epic → Feature → Story hierarchy preserved

Multi-Project Routing

When pulling with --all, the system routes changes to correct folders:

Read the full file on GitHub · 489 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 489 lines · 23 tokens per session scan A 4d83a39ffead

Subscribe to this mod's changes

ado-pull is a command published in the GitHub repository anton-abyzov/specweave (159 stars, last pushed 2d ago), licensed MIT. It adds 23 tokens to every session and 3,355 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.