[auto] chore: update agent instructions from PR reviews
- Dominant language
- Go
- Stars
- 569
- Forks
- 364
- Avg merge
- 2d 19h
- Merged PRs (30d)
- 136
Description
> [!TIP]
> **Your pull request is ready to create! 🎉 ✅**
>
> Everything is OK—the changes have been pushed to branch `automated/update-instructions-from-pr-reviews`. Please review the changes, including any protected files, before creating the pull request.
>
> **[Create the pull request](https://github.com/Azure/azure-dev/compare/main...automated/update-instructions-from-pr-reviews?expand=1&title=%5Bauto%5D%20chore%3A%20update%20agent%20instructions%20from%20PR%20reviews)**
>
> The original pull request description is below.
---
Proposed by the [Update Instructions From PR Reviews](.github/workflows/update-instructions-from-pr-reviews.md) workflow.
**Settings**
- Repo: `Azure/azure-dev`
- Range: merged after `2026-08-24T08:51:39Z` (50-PR cap)
- Branch: [`automated/update-instructions-from-pr-reviews` at `a69e1cf`](https://github.com/Azure/azure-dev/tree/automated/update-instructions-from-pr-reviews)
**Stats**
- Signal ratio: 95 kept / 1,064 dropped (1,159 review signals)
- Resolved PRs: 50
**PR comment themes**
- Honor explicit inputs or reject conflicts — [#9559](https://github.com/Azure/azure-dev/pull/9559), [#9805](https://github.com/Azure/azure-dev/pull/9805), [#9808](https://github.com/Azure/azure-dev/pull/9808)
- Redact credentials from URLs in output and artifacts — [#9559](https://github.com/Azure/azure-dev/pull/9559), [#9805](https://github.com/Azure/azure-dev/pull/9805), [#9900](https://github.com/Azure/azure-dev/pull/9900)
- Keep schemas, decoders, mapping, and runtime validation aligned — [#9697](https://github.com/Azure/azure-dev/pull/9697), [#9805](https://github.com/Azure/azure-dev/pull/9805), [#9948](https://github.com/Azure/azure-dev/pull/9948)
- Make multi-step mutations transactional or retryable — [#9559](https://github.com/Azure/azure-dev/pull/9559), [#9719](https://github.com/Azure/azure-dev/pull/9719), [#9805](https://github.com/Azure/azure-dev/pull/9805)
- Keep warnings visible through injected output paths — [#9805](https://github.com/Azure/azure-dev/pull/9805), [#9929](https://github.com/Azure/azure-dev/pull/9929)
- Test real command wiring with deterministic prerequisites — [#9342](https://github.com/Azure/azure-dev/pull/9342), [#9901](https://github.com/Azure/azure-dev/pull/9901)
- Preserve precedence and observability for layered concurrency settings — [#9752](https://github.com/Azure/azure-dev/pull/9752)
- Keep release documentation scoped to shipped behavior — [#9719](https://github.com/Azure/azure-dev/pull/9719), [#9958](https://github.com/Azure/azure-dev/pull/9958)
---
> [!NOTE]
> GitHub Actions is not permitted to create or approve pull requests in this repository.
> The changes have been pushed to branch `automated/update-instructions-from-pr-reviews` and are ready to review.
To fix the permissions issue, go to **Settings** → **Actions** → **General** and enable **Allow GitHub Actions to create and approve pull requests**. See also: [gh-aw FAQ](https://github.github.com/gh-aw/reference/faq/#why-is-my-create-pull-request-workflow-failing-with-github-actions-is-not-permitted-to-create-or-approve-pull-requests)
Show patch preview (32 of 98 lines)
```diff
From a69e1cf65988ad5ba6fa8e05d1537a9eb362a1da Mon Sep 17 00:00:00 2001
X-GH-AW-Base-Commit: 2850298a3f0d9f296a4f5795b593a69115fe5b05
From: "github-actions[bot]"
Date: Mon, 14 Sep 2026 08:55:49 +0000
Subject: [PATCH] chore: update agent instructions from PR reviews
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
.../documentation.instructions.md | 4 +++
.../instructions/extensions.instructions.md | 30 +++++++++++++++++--
.github/instructions/go.instructions.md | 8 +++++
3 files changed, 40 insertions(+), 2 deletions(-)
diff --git a/.github/instructions/documentation.instructions.md b/.github/instructions/documentation.instructions.md
index 2e1bf2c..04ba127 100644
--- a/.github/instructions/documentation.instructions.md
+++ b/.github/instructions/documentation.instructions.md
@@ -45,3 +45,7 @@ docs/
- Keep tables and lists scannable
- Include code examples where they aid understanding
- Verify environment-variable docs against source behavior and generated config shapes. Distinguish values that `azd` reads directly from template substitutions, and document Bicep parameter files using the nested `parameters..value` shape rather than flattened JSON.
+- Keep changelog entries, help text, and pull request descriptions scoped to behavior that actually
+ ships in the change. Do not add entries to a completed release or claim support for a broader
+ feature variant than the implementation exposes.
+ _Source: #9719, #9958_
diff --git a/.github/instructions/extensions.instructions.md b/.github/instructions/extensions.instructions.md
index 74fb817..1754bbc 100644
--- a/.github/instructions/extensions.instructions.md
+++ b/.github/instructions/extensions.instructions.md
@@ -22,9 +22,12 @@ applyTo:
it — for example, `--inspector-port` with `--no-client`, or any agent-creation flag during a
reuse flow, or init-only flags during a standalone-eject run — return a cle
... (truncated)
```
> Generated by [Update Instructions From PR Reviews](https://github.com/Azure/azure-dev/actions/runs/34824574959) · copilot · gpt56 · 176.7 AIC · ⌖ 46.6 AIC · ⊞ 29.1K · [◷](https://github.com/search?q=repo%3AAzure%2Fazure-dev+%22gh-aw-workflow-id%3A+update-instructions-from-pr-reviews%22&type=pullrequests)
Contributor guide
Research direction
Start with .github/workflows/update-instructions-from-pr-reviews.md, then review the generated branch changes in .github/instructions/documentation.instructions.md, extensions.instructions.md, and go.instructions.md. Check that each instruction is supported by the cited pull-request themes and that the resulting guidance is scoped and consistent before creating the pull request.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- github-actions
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100