Skip to content

Comments

[instructions] Sync github-agentic-workflows.instructions.md with v0.27.0#2982

Merged
pelikhan merged 1 commit intomainfrom
instructions/sync-fork-security-v0.27.0-8aa1172b073ef4dd
Nov 2, 2025
Merged

[instructions] Sync github-agentic-workflows.instructions.md with v0.27.0#2982
pelikhan merged 1 commit intomainfrom
instructions/sync-fork-security-v0.27.0-8aa1172b073ef4dd

Conversation

@github-actions
Copy link
Contributor

@github-actions github-actions bot commented Nov 2, 2025

Instructions Update - Synchronized with v0.27.0

This PR updates the github-agentic-workflows.instructions.md file based on documentation changes since the last release (v0.27.0, released October 31, 2025).

Changes Made

  • Added forks: field documentation to frontmatter schema section explaining the deny-by-default behavior
  • Added "Fork Security for Pull Requests" section under Trigger Patterns with three clear examples:
    • Default behavior (same-repo only)
    • Allow all forks with ["*"]
    • Allow specific fork patterns with ["org/*", "user/repo"]
  • Added "Fork Security" subsection to Security Considerations highlighting the secure default
  • Updated pull_request trigger example to show forks field usage inline

Documentation Commits Reviewed

This commit introduced a major security feature where pull_request workflows now block all forks by default and only allow PRs from the same repository. Previously, omitting the forks field allowed all forks to trigger workflows.

Key Feature Documentation

Fork Security (New in v0.27.0)

Pull request workflows now use deny-by-default fork behavior:

  • Default: Same-repo PRs only (all forks blocked)
  • Explicit opt-in required: Use forks: ["*"] for all forks or specific patterns like ["trusted-org/*"]
  • Security improvement: Protects against untrusted fork execution by default
  • Generated condition: Uses repository ID comparison for reliable fork detection

Validation

  • Followed prompting best practices (imperative mood, minimal examples)
  • Maintained technical tone and brevity
  • Updated only necessary sections (Frontmatter Schema, Trigger Patterns, Security Considerations)
  • Verified accuracy against current codebase and PR Change default fork behavior for pull_request triggers to deny-by-default #2970
  • Removed no content (additive changes only)
  • Used clear, concrete YAML syntax examples
  • Placed documentation in logical sections for discoverability

Notes

This is a critical security feature that should be well-documented for AI agents writing workflows. The deny-by-default approach significantly reduces the attack surface for repositories using agentic workflows with pull_request triggers.

AI generated by Instructions Janitor

Update instructions file with fork security feature introduced in v0.27.0.

## Changes Made

- Added `forks:` field documentation to frontmatter schema section
- Added "Fork Security for Pull Requests" section under Trigger Patterns with examples
- Added "Fork Security" subsection to Security Considerations
- Updated pull_request trigger example to show forks field usage

## Documentation Commits Reviewed

- 48f19e3 Change default fork behavior for pull_request triggers to deny-by-default (#2970)

## Key Feature

Pull request workflows now block forks by default unless explicitly allowed via `forks` field:
- Default behavior: same-repo PRs only (forks blocked)
- Explicit opt-in: use `forks: ["*"]` for all forks or patterns like `["org/*"]`
- Security improvement: deny-by-default protects against untrusted fork execution

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@github-actions github-actions bot added automation documentation Improvements or additions to documentation instructions labels Nov 2, 2025
@pelikhan pelikhan enabled auto-merge (squash) November 2, 2025 13:15
@pelikhan pelikhan merged commit a4993b3 into main Nov 2, 2025
4 checks passed
@pelikhan pelikhan deleted the instructions/sync-fork-security-v0.27.0-8aa1172b073ef4dd branch November 2, 2025 13:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation instructions

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant