Skip to content

Commit a13641c

Browse files
willowdev-codewillowdev-code
committed
Sprints, boards and backlogs
- ado_sprint: dates and working day, progress by state, estimates, remaining work vs capacity left (team and personal days off), attention list (stale, blocked, no estimate, no criteria, unassigned), task progress; an ended sprint is reported as ended - ado_board: columns with WIP limits and cards; moving a card sets the board column and the state mapped for the item's type - ado_backlog: priority order and reordering (above / below) - ado_my_day: mentions, own and followed items changed by others, pull requests waiting for review - CLI: sprint, board, backlog, myday
1 parent 4f431d6 commit a13641c

13 files changed

Lines changed: 877 additions & 13 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,11 @@ First skeleton.
1717
people by name, state only along the transitions, markdown → HTML, soft length notes; updates of more than
1818
`confirmBulkAbove` items are previewed and written with the preview's token), `ado_comment` (`@[name]` mentions),
1919
`ado_link`. Same commands in the CLI (`item`, `query`, `create`, `update`, `comment`, `link`).
20+
- Boards (tool set `boards`): `ado_sprint` (dates and working day, progress by state, estimates, remaining work vs
21+
capacity left with days off, attention list, task progress; ended sprints said plainly), `ado_board` (columns, WIP
22+
limits, cards; moving a card sets the column and the state mapped for its type), `ado_backlog` (priority order,
23+
reordering), `ado_my_day` (mentions, own and followed items changed by others, PRs waiting for review). CLI: `sprint`,
24+
`board`, `backlog`, `myday`.
2025
- Modes `po` / `dev` / `full` choose the tool sets Claude sees; `config --add-toolset`, `--confirm-above`.
2126
- Inherited process names, bugs shown on the requirement backlog, disabled types listed by name.
2227
- The PAT is only ever sent to Azure DevOps hosts. `adolens api <path>` for development.

‎README.md‎

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,8 @@ not thousands. Changes between versions: [CHANGELOG.md](CHANGELOG.md). The road
1212
© 2026 WillowDev. Released under the [MIT License](LICENSE). Not affiliated with or endorsed by Microsoft;
1313
Azure DevOps is a trademark of Microsoft.
1414

15-
> Status: **0.x — in development.** Connections, Claude registration, the local work item structure and the work item
16-
> tools work; boards, wiki, pull requests and pipelines follow the plan.
15+
> Status: **0.x — in development.** Connections, Claude registration, the local work item structure, work items,
16+
> sprints, boards and backlogs work; wiki, pull requests and pipelines follow the plan.
1717
1818
## What it does differently
1919

@@ -105,7 +105,8 @@ never a permission.
105105
|---|---|:-:|:-:|:-:|
106106
| `core` | `ado_status`, `ado_fields` | ✓ | ✓ | ✓ |
107107
| `work` | `ado_work_item`, `ado_query`, `ado_create`, `ado_update`, `ado_comment`, `ado_link` | ✓ | ✓ | ✓ |
108-
| `boards`, `wiki`, `trace`, `test`, `recipes` | planned | ✓ | (wiki, trace, recipes) | ✓ |
108+
| `boards` | `ado_sprint`, `ado_board`, `ado_backlog`, `ado_my_day` | ✓ | – | ✓ |
109+
| `wiki`, `trace`, `test`, `recipes` | planned | ✓ | (wiki, trace, recipes) | ✓ |
109110
| `code`, `pr`, `pipelines` | planned | – | ✓ | ✓ |
110111

111112
## Tool map
@@ -122,6 +123,10 @@ What each MCP tool answers, when Claude should reach for it, and the CLI command
122123
| `ado_update` | changes one or many items (ids or WIQL): fields, state along the transitions, people, tags `+a; -b`, iteration `current`, a comment; many items → preview + `confirm` token | closing, moving to a sprint, mass changes | `adolens update 123 --state Done --comment "…"`, `adolens update --wiql "…" --tags "+reviewed"` |
123124
| `ado_comment` | markdown comment; `@[name]` mentions notify the person | asking, deciding, reporting | `adolens comment 123 "@[Anna] please confirm"` |
124125
| `ado_link` | parent, child, related, predecessor, successor, duplicate, duplicate-of, tested-by, tests; `remove` unlinks | structuring the backlog | `adolens link 123 456 --type child` |
126+
| `ado_sprint` | a team's sprint (`current`, `next`, `previous` or by name): dates and working day, items by state, estimates, remaining work against the capacity left, items needing attention (no change for days, blocked, no estimate, no criteria, unassigned), task progress per item; says plainly when the sprint has ended | stand-up, sprint review, "will we make it" | `adolens sprint`, `adolens sprint next --team "Demo Team" --detail summary` |
127+
| `ado_board` | a team's board: columns with WIP limits (over-limit flagged) and their cards; `move` + `column` moves a card — the state follows the column's mapping for the item's type | "what is in progress", moving cards | `adolens board`, `adolens board --move 123 --column "In Progress"` |
128+
| `ado_backlog` | a team's backlog in priority order (requirement, portfolio, task, or by name); `move` + `above`/`below` reorders | refinement, priorities | `adolens backlog --top 20`, `adolens backlog --move 123 --above 456` |
129+
| `ado_my_day` | since the previous working day (or `since`): where you were mentioned (all projects), your items and followed items changed by others, pull requests waiting for your review | the start of the day | `adolens myday --since 3d` |
125130

126131
### Writing rules built in
127132

@@ -150,7 +155,7 @@ Estimates are characters / 4; Claude's tokenizer differs a little (Polish text r
150155
## CLI
151156

152157
```
153-
adolens item|query|create|update|comment|link|fields …
158+
adolens item|query|create|update|comment|link|fields|sprint|board|backlog|myday …
154159
adolens login|logout|connections|config|status|register|unregister|refresh|stats|api|mcp|version
155160
```
156161

@@ -190,6 +195,7 @@ After `-Deploy`, restart Claude Desktop / start a new Claude Code session — MC
190195
|---|---|
191196
| `SetupTests.cs` | settings, connections and PAT order (Credential Manager first), command line, Claude configuration edits, Credential Manager, HTTP retries and errors, tool definition budget per mode |
192197
| `MetadataTests.cs` | fetching the structure (levels, inherited process name, bugs on the requirement backlog), change history, compact `ado_fields` answers |
198+
| `BoardTests.cs` | sprint progress, capacity left with days off, attention list, picking sprints, ended sprints, board columns and WIP, moving cards with the state mapping, backlog order and reordering, my day |
193199
| `WorkItemTests.cs` | work item answers, required fields and allowed values before writing, transitions, preview and confirm of bulk updates, mentions, links, queries, HTML ⇄ markdown, PAT never sent to other hosts |
194200

195201
Fixtures use neutral names only (`contoso`, `Demo`, `Anna Nowak`). Never put data from real organizations into tests,
@@ -201,6 +207,7 @@ issues or commits.
201207
|---|---|
202208
| a new MCP tool | a `*Tools` class with `[Toolset]` in `McpTools.cs` (or its own file) + the query in `*Queries.cs` + a CLI command in `Cli.cs`/`Program.cs`/`CommandLine.cs` + a test + a line in the instructions |
203209
| work item reads, writes, checks | `WorkItems.cs`, `WorkQueries.cs`; output in `WorkItemFormat.cs` |
210+
| sprints, capacity, boards, backlogs, my day | `Boards.cs` (API in `Boards`, answers in `BoardQueries`) |
204211
| work item structure (types, fields, states) | `MetadataService.cs` (fetch), `MetaStore.cs` (SQLite; raise `SchemaVersion` to refetch), `Metadata.cs` (change detection) |
205212
| rich text | `Html.cs` |
206213
| people | `Identities.cs` |

‎README.pl.md‎

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,8 @@ a nie tysiące. Zmiany między wersjami: [CHANGELOG.md](CHANGELOG.md). Plan rozw
1212
© 2026 WillowDev. Udostępnione na [licencji MIT](LICENSE). Projekt niezależny, niezwiązany z Microsoftem;
1313
Azure DevOps jest znakiem towarowym Microsoftu.
1414

15-
> Stan: **0.x — w budowie.** Działają połączenia, rejestracja w Claude, lokalna struktura work itemów i narzędzia work
16-
> itemów; tablice, wiki, pull requesty i pipeline'y — według planu.
15+
> Stan: **0.x — w budowie.** Działają połączenia, rejestracja w Claude, lokalna struktura work itemów, work itemy,
16+
> sprinty, tablice i backlogi; wiki, pull requesty i pipeline'y — według planu.
1717
1818
## Czym się różni
1919

@@ -105,7 +105,8 @@ Nigdy nie jest uprawnieniem.
105105
|---|---|:-:|:-:|:-:|
106106
| `core` | `ado_status`, `ado_fields` | ✓ | ✓ | ✓ |
107107
| `work` | `ado_work_item`, `ado_query`, `ado_create`, `ado_update`, `ado_comment`, `ado_link` | ✓ | ✓ | ✓ |
108-
| `boards`, `wiki`, `trace`, `test`, `recipes` | w planie | ✓ | (wiki, trace, recipes) | ✓ |
108+
| `boards` | `ado_sprint`, `ado_board`, `ado_backlog`, `ado_my_day` | ✓ | – | ✓ |
109+
| `wiki`, `trace`, `test`, `recipes` | w planie | ✓ | (wiki, trace, recipes) | ✓ |
109110
| `code`, `pr`, `pipelines` | w planie | – | ✓ | ✓ |
110111

111112
## Mapa narzędzi
@@ -122,6 +123,10 @@ Na co odpowiada każde narzędzie MCP, kiedy Claude powinien po nie sięgnąć i
122123
| `ado_update` | zmienia jeden lub wiele elementów (id albo WIQL): pola, stan zgodnie z przejściami, osoby, tagi `+a; -b`, iteracja `current`, komentarz; wiele elementów → podgląd + token `confirm` | zamykanie, przenoszenie do sprintu, zmiany masowe | `adolens update 123 --state Done --comment "…"`, `adolens update --wiql "…" --tags "+reviewed"` |
123124
| `ado_comment` | komentarz w markdownie; `@[imię]` oznacza osobę i wysyła jej powiadomienie | pytania, decyzje, raporty | `adolens comment 123 "@[Anna] potwierdź proszę"` |
124125
| `ado_link` | rodzic, dziecko, powiązany, poprzednik, następnik, duplikat, duplikat-czego, testowany-przez, testuje; `remove` usuwa | porządkowanie backlogu | `adolens link 123 456 --type child` |
126+
| `ado_sprint` | sprint zespołu (`current`, `next`, `previous` albo po nazwie): daty i dzień roboczy, elementy według stanu, szacunki, pozostała praca wobec pozostałej pojemności, elementy do uwagi (bez zmian od kilku dni, zablokowane, bez szacunku, bez kryteriów, bez osoby), postęp zadań per element; mówi wprost, gdy sprint się skończył | daily, przegląd sprintu, „czy zdążymy” | `adolens sprint`, `adolens sprint next --team "Demo Team" --detail summary` |
127+
| `ado_board` | tablica zespołu: kolumny z limitami WIP (przekroczenia oznaczone) i ich karty; `move` + `column` przesuwa kartę — stan wynika z mapowania kolumny dla typu elementu | „co jest w toku”, przesuwanie kart | `adolens board`, `adolens board --move 123 --column "In Progress"` |
128+
| `ado_backlog` | backlog zespołu w kolejności priorytetu (wymagania, portfolio, zadania albo po nazwie); `move` + `above`/`below` zmienia kolejność | refinement, priorytety | `adolens backlog --top 20`, `adolens backlog --move 123 --above 456` |
129+
| `ado_my_day` | od poprzedniego dnia roboczego (albo `since`): gdzie cię oznaczono (wszystkie projekty), twoje i obserwowane elementy zmienione przez innych, pull requesty czekające na twój przegląd | początek dnia | `adolens myday --since 3d` |
125130

126131
### Wbudowane zasady pisania
127132

@@ -150,7 +155,7 @@ Szacunek to znaki / 4; tokenizer Claude'a liczy trochę inaczej (polski tekst wy
150155
## CLI
151156

152157
```
153-
adolens item|query|create|update|comment|link|fields …
158+
adolens item|query|create|update|comment|link|fields|sprint|board|backlog|myday …
154159
adolens login|logout|connections|config|status|register|unregister|refresh|stats|api|mcp|version
155160
```
156161

@@ -190,6 +195,7 @@ Po `-Deploy` zrestartuj Claude Desktop / zacznij nową sesję Claude Code — MC
190195
|---|---|
191196
| `SetupTests.cs` | ustawienia, połączenia i kolejność PAT (najpierw Menedżer poświadczeń), linia poleceń, edycja konfiguracji Claude'a, Menedżer poświadczeń, ponawianie i błędy HTTP, budżet definicji narzędzi na tryb, faktyczna rejestracja narzędzi |
192197
| `MetadataTests.cs` | pobieranie struktury (poziomy, nazwa procesu dziedziczonego, bugi na backlogu wymagań), historia zmian, zwięzłe odpowiedzi `ado_fields` |
198+
| `BoardTests.cs` | postęp sprintu, pozostała pojemność z dniami wolnymi, lista do uwagi, wybór sprintu, zakończone sprinty, kolumny tablicy i WIP, przesuwanie kart z mapowaniem stanów, kolejność backlogu i jej zmiana, mój dzień |
193199
| `WorkItemTests.cs` | odpowiedzi o work itemach, pola wymagane i dozwolone wartości przed zapisem, przejścia stanów, podgląd i potwierdzanie zmian wsadowych, wzmianki, linki, zapytania, HTML ⇄ markdown, PAT nigdy do innych hostów |
194200

195201
Dane testowe mają wyłącznie neutralne nazwy (`contoso`, `Demo`, `Anna Nowak`). Nigdy nie wkładaj danych z prawdziwych
@@ -201,6 +207,7 @@ organizacji do testów, zgłoszeń ani commitów.
201207
|---|---|
202208
| nowe narzędzie MCP | klasa `*Tools` z `[Toolset]` w `McpTools.cs` (albo własnym pliku) + zapytanie w `*Queries.cs` + polecenie CLI w `Cli.cs`/`Program.cs`/`CommandLine.cs` + test + linijka w instrukcjach |
203209
| odczyt, zapis i kontrole work itemów | `WorkItems.cs`, `WorkQueries.cs`; wyjście w `WorkItemFormat.cs` |
210+
| sprinty, pojemność, tablice, backlogi, mój dzień | `Boards.cs` (API w `Boards`, odpowiedzi w `BoardQueries`) |
204211
| struktura work itemów (typy, pola, stany) | `MetadataService.cs` (pobieranie), `MetaStore.cs` (SQLite; podnieś `SchemaVersion`, żeby pobrać od nowa), `Metadata.cs` (wykrywanie zmian) |
205212
| tekst sformatowany | `Html.cs` |
206213
| osoby | `Identities.cs` |

0 commit comments

Comments
 (0)