Skip to content

[instructions] Sync github-agentic-workflows.md with v0.40.1 #21138

@github-actions

Description

@github-actions

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 missing footer boolean field to the add-comment example. The field exists in AddCommentsConfig (pkg/workflow/add_comment.go) and the JSON schema but was absent from the instructions. When false, omits the visible footer while preserving XML markers for searchability.

  • safe-outputs.failure-issue-repo: Added missing global failure-issue-repo string field. The field exists in SafeOutputsConfig (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

  • 6d9b060 fix(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-aw
Show 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)

Metadata

Metadata

Assignees

No one assigned

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions