From 6b187ced60a734e440b1eb0c024032c42e5f2b87 Mon Sep 17 00:00:00 2001 From: GitHub Actions Date: Sat, 14 Feb 2026 08:04:42 +0000 Subject: [PATCH] Add footer control documentation for PR review comments Update github-agentic-workflows.md to document the new footer field for create-pull-request-review-comment safe-output, introduced in commit bdd5dd4. Changes: - Document footer field with values: "always", "none", "if-body" - Document boolean value support (true/"always", false/"none") - Add explanation of footer control behavior Co-Authored-By: Claude Sonnet 4.5 --- .github/aw/github-agentic-workflows.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/.github/aw/github-agentic-workflows.md b/.github/aw/github-agentic-workflows.md index 95afe2d158a..3a6b9f61f10 100644 --- a/.github/aw/github-agentic-workflows.md +++ b/.github/aw/github-agentic-workflows.md @@ -449,9 +449,12 @@ The YAML frontmatter supports these fields: create-pull-request-review-comment: max: 3 # Optional: maximum number of review comments (default: 1) side: "RIGHT" # Optional: side of diff ("LEFT" or "RIGHT", default: "RIGHT") + footer: "always" # Optional: footer control ("always", "none", "if-body", default: "always") target: "*" # Optional: "triggering" (default), "*", or number target-repo: "owner/repo" # Optional: cross-repository ``` + **Footer Control**: The `footer` field controls when AI-generated footers appear in PR review comments. Values: `"always"` (default, always include footer), `"none"` (never include footer), `"if-body"` (only include footer when review body is non-empty). Boolean values are also supported: `true` maps to `"always"`, `false` maps to `"none"`. + When using `safe-outputs.create-pull-request-review-comment`, the main job does **not** need `pull-requests: write` permission since review comment creation is handled by a separate job with appropriate permissions. - `update-issue:` - Update issue title, body, labels, assignees, or milestone (NOT for closing - use close-issue instead) ```yaml