From c34075e4ba3a4b727cbd5667e527c4bce09843f7 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Sat, 16 May 2026 05:44:41 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20fix=20documentation=20drift=20=E2=80=94?=
 =?UTF-8?q?=20create=5Fissue.rs=20missing=20from=20AGENTS.md,=20noop/missi?=
 =?UTF-8?q?ng-tool=20work-item=20filing=20undocumented=20in=20prompt?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 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: Copilot <223556219+Copilot@users.noreply.github.com>
---
 AGENTS.md                              |  1 +
 prompts/create-ado-agentic-workflow.md | 19 ++++++++++++++++---
 2 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index ff71d36c..4737a532 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -89,6 +89,7 @@ Every compiled pipeline runs as three sequential jobs:
 │   │   ├── comment_on_work_item.rs
 │   │   ├── create_branch.rs
 │   │   ├── create_git_tag.rs
+│   │   ├── create_issue.rs
 │   │   ├── create_pr.rs
 │   │   ├── create_wiki_page.rs
 │   │   ├── create_work_item.rs
diff --git a/prompts/create-ado-agentic-workflow.md b/prompts/create-ado-agentic-workflow.md
index ffa21f45..8be1e6a8 100644
--- a/prompts/create-ado-agentic-workflow.md
+++ b/prompts/create-ado-agentic-workflow.md
@@ -318,9 +318,9 @@ tools:
 | `create-wiki-page` | Create a new ADO wiki page (requires `wiki-name`) | ✅ |
 | `update-wiki-page` | Update an existing ADO wiki page (requires `wiki-name`) | ✅ |
 | **Diagnostics** | | |
-| `noop` | Report no action needed | — |
+| `noop` | Report no action needed; also files an ADO work item (configurable, gracefully skipped without write perms) | — |
 | `missing-data` | Report missing data/information | — |
-| `missing-tool` | Report a missing tool or capability | — |
+| `missing-tool` | Report a missing tool or capability; also files an ADO work item (configurable, gracefully skipped without write perms) | — |
 | `report-incomplete` | Report that a task could not be completed | — |
 
 Example configuration for additional tools:
@@ -339,11 +339,24 @@ safe-outputs:
   queue-build:
     allowed-pipelines: [42, 99]       # Required — pipeline definition IDs that can be triggered
     max: 1
+  # noop and missing-tool auto-file ADO work items (enabled by default, optional customisation):
+  noop:
+    work-item:
+      enabled: true                   # Set to false to disable work-item filing
+      title: "[ado-aw] Agent reported no operation"
+      work-item-type: Task
+      area-path: "MyProject\\MyTeam"  # Optional
+  missing-tool:
+    work-item:
+      enabled: true                   # Set to false to disable work-item filing
+      title: "[ado-aw] Agent encountered missing tool"
+      work-item-type: Task
+      area-path: "MyProject\\MyTeam"  # Optional
 ```
 
 > See `docs/safe-outputs.md` → "Available Safe Output Tools" for full configuration reference of every tool.
 
-Diagnostic tools (`noop`, `missing-data`, `missing-tool`, `report-incomplete`) are always available and require no configuration.
+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.
 
 > **Validation**: The compiler enforces that if write-requiring safe outputs are configured, `permissions.write` must be set.