Skip to content

Commit cb9bb44

Browse files
jamesadevinegithub-actions[bot]Copilot
authored
docs: fix documentation drift — create_issue.rs missing from AGENTS.md, noop/missing-tool work-item filing undocumented in prompt (#565)
- Add src/safeoutputs/create_issue.rs to the AGENTS.md architecture tree (added in v0.29.0 via feat(safeoutputs): add ado-aw-debug.create-issue) - Update prompts/create-ado-agentic-workflow.md to document that noop and missing-tool now auto-file ADO work items (added in v0.29.0 via feat(safeoutputs): add work-item filing to noop and missing-tool) and add example configuration for the work-item: block Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent ffcf3db commit cb9bb44

2 files changed

Lines changed: 17 additions & 3 deletions

File tree

AGENTS.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,6 +89,7 @@ Every compiled pipeline runs as three sequential jobs:
8989
│ │ ├── comment_on_work_item.rs
9090
│ │ ├── create_branch.rs
9191
│ │ ├── create_git_tag.rs
92+
│ │ ├── create_issue.rs
9293
│ │ ├── create_pr.rs
9394
│ │ ├── create_wiki_page.rs
9495
│ │ ├── create_work_item.rs

prompts/create-ado-agentic-workflow.md

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -318,9 +318,9 @@ tools:
318318
| `create-wiki-page` | Create a new ADO wiki page (requires `wiki-name`) | ✅ |
319319
| `update-wiki-page` | Update an existing ADO wiki page (requires `wiki-name`) | ✅ |
320320
| **Diagnostics** | | |
321-
| `noop` | Report no action needed | — |
321+
| `noop` | Report no action needed; also files an ADO work item (configurable, gracefully skipped without write perms) | — |
322322
| `missing-data` | Report missing data/information | — |
323-
| `missing-tool` | Report a missing tool or capability | — |
323+
| `missing-tool` | Report a missing tool or capability; also files an ADO work item (configurable, gracefully skipped without write perms) | — |
324324
| `report-incomplete` | Report that a task could not be completed | — |
325325

326326
Example configuration for additional tools:
@@ -339,11 +339,24 @@ safe-outputs:
339339
queue-build:
340340
allowed-pipelines: [42, 99] # Required — pipeline definition IDs that can be triggered
341341
max: 1
342+
# noop and missing-tool auto-file ADO work items (enabled by default, optional customisation):
343+
noop:
344+
work-item:
345+
enabled: true # Set to false to disable work-item filing
346+
title: "[ado-aw] Agent reported no operation"
347+
work-item-type: Task
348+
area-path: "MyProject\\MyTeam" # Optional
349+
missing-tool:
350+
work-item:
351+
enabled: true # Set to false to disable work-item filing
352+
title: "[ado-aw] Agent encountered missing tool"
353+
work-item-type: Task
354+
area-path: "MyProject\\MyTeam" # Optional
342355
```
343356

344357
> See `docs/safe-outputs.md` → "Available Safe Output Tools" for full configuration reference of every tool.
345358

346-
Diagnostic tools (`noop`, `missing-data`, `missing-tool`, `report-incomplete`) are always available and require no configuration.
359+
Diagnostic tools (`noop`, `missing-data`, `missing-tool`, `report-incomplete`) are always available and require no required configuration. `noop` and `missing-tool` automatically file ADO work items by default — this requires `permissions.write` to actually create work items, but gracefully skips (with a warning) if credentials are unavailable.
347360

348361
> **Validation**: The compiler enforces that if write-requiring safe outputs are configured, `permissions.write` must be set.
349362

0 commit comments

Comments
 (0)