diff --git a/.github/aw/github-agentic-workflows.md b/.github/aw/github-agentic-workflows.md index 95afe2d158..3a6b9f61f1 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