-
Notifications
You must be signed in to change notification settings - Fork 306
Description
Instructions Update - Synchronized with v0.40.1
This PR updates github-agentic-workflows.md based on a code audit against the safe-outputs implementation after the v0.40.1 release.
Changes Made
-
add-comment.footer: Added missingfooterboolean field to theadd-commentexample. The field exists inAddCommentsConfig(pkg/workflow/add_comment.go) and the JSON schema but was absent from the instructions. Whenfalse, omits the visible footer while preserving XML markers for searchability. -
safe-outputs.failure-issue-repo: Added missing globalfailure-issue-repostring field. The field exists inSafeOutputsConfig(pkg/workflow/compiler_types.go) and the JSON schema (with description and pattern) but was not documented. Allows redirecting failure tracking issues to another repository when the current repo has issues disabled.
Documentation Commits Reviewed
6d9b060fix(workflows): normalize report formatting in output templates — workflow-only change, no instructions impact
Validation
- Followed prompting best practices (imperative mood, minimal examples)
- Maintained technical tone and brevity
- Updated only necessary sections
- Verified accuracy against current codebase (
compiler_types.go,add_comment.go,main_workflow_schema.json) - Removed outdated or redundant content (none needed)
Generated by Instructions Janitor · ◷
- expires on Mar 18, 2026, 12:00 AM UTC
Note
This was originally intended as a pull request, but PR creation failed. The changes have been pushed to the branch sync-instructions-v0.40.1-219c7f82c0091989.
Original error: Validation Failed: {"resource":"Label","code":"unprocessable","field":"data","message":"Could not resolve to a node with the global id of 'PR_kwDOPc1QR87KxcDm'."}
To create the pull request manually:
gh pr create --title "[instructions] Sync github-agentic-workflows.md with v0.40.1" --base main --head sync-instructions-v0.40.1-219c7f82c0091989 --repo github/gh-awShow patch preview (44 of 44 lines)
From 0605fe2c26ba3d20e7d56cb6df8cb778fccc682b Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Sun, 15 Mar 2026 23:58:25 +0000
Subject: [PATCH] docs(instructions): sync github-agentic-workflows.md with
v0.40.1
Add two missing safe-outputs fields identified by auditing code against instructions:
- add-comment.footer: boolean flag to omit visible footer while preserving XML markers
- safe-outputs.failure-issue-repo: string field to redirect failure tracking issues to another repo
Both fields exist in SafeOutputsConfig/AddCommentsConfig structs and in the JSON schema but were absent from the instructions file.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
.github/aw/github-agentic-workflows.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/.github/aw/github-agentic-workflows.md b/.github/aw/github-agentic-workflows.md
index d41ffab..d6e5300 100644
--- a/.github/aw/github-agentic-workflows.md
+++ b/.github/aw/github-agentic-workflows.md
@@ -531,6 +531,7 @@ The YAML frontmatter supports these fields:
discussions: true # Optional: set false to exclude discussions:write permission (default: true)
issues: true # Optional: set false to exclude issues:write permission (default: true)
pull-requests: true # Optional: set false to exclude pull-requests:write permission (default: true)
+ footer: true # Optional: when false, omits visible footer but preserves XML markers (default: true)
target-repo: "owner/repo" # Optional: cross-repository
```
@@ -1136,6 +1137,9 @@ The YAML frontmatter supports these fields:
- `report-failure-as-issue:` - Control whether workflow failures are reported as GitHub issues (boolean, default: `true`)
- When `false`, suppresses automatic failure issue creation for this workflow
- Use to silence noisy failure reports for workflows where
... (truncated)