Skip to content

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

Merged
pelikhan merged 1 commit intomainfrom
main-deb51a02a6b8b631
Feb 18, 2026
Merged

[instructions] Sync github-agentic-workflows.md with v0.40.1#16469
pelikhan merged 1 commit intomainfrom
main-deb51a02a6b8b631

Conversation

@github-actions
Copy link
Contributor

Instructions Update - Synchronized with v0.40.1

This PR updates the github-agentic-workflows.md file based on documentation changes added in commit 3975e57, which introduced the complete documentation site for GitHub Agentic Workflows.

Changes Made

New Safe-Output Types

  • reply-to-pull-request-review-comment: - Reply to existing review comments on PRs (max: 10)
  • resolve-pull-request-review-thread: - Resolve PR review threads after addressing feedback (max: 10)
  • unassign-from-user: - Remove user assignments from issues or PRs (max: 1)

Updated Specifications

  • Temporary ID Format: Changed from aw_ + 12 hex chars to aw_ + 3-8 alphanumeric chars
  • Updated all examples to reflect new format (aw_abc123 instead of aw_abc123def456)

New Frontmatter Fields

  • plugins: - Plugin installation configuration (array or object format)
    • Marked as experimental feature
    • Documents token precedence and installation behavior
  • skip-roles: - Skip workflow execution for users with specific repository roles
  • skip-bots: - Skip workflow execution when triggered by specific GitHub actors
  • status-comment: - Post status comments when workflow starts/completes (breaking change)

Configuration Updates

  • Sandbox: Added deprecation notice for top-level sandbox: false
    • Recommend using sandbox.agent: false instead
    • Note about gh aw fix --write migration tool

Breaking Changes and Deprecations Section

Added new section documenting:

  • Deprecated sandbox: false (use sandbox.agent: false)
  • Deprecated timeout_minutes (use timeout-minutes)
  • Deprecated create-agent-task (use create-agent-session)
  • Breaking change: status comments must be explicitly enabled with status-comment: true
  • Temporary ID format change
  • Migration tool usage (gh aw fix --write)

Documentation Commits Reviewed

  • 3975e57 - Added complete documentation site with comprehensive reference documentation

Validation

  • Followed prompting best practices (imperative mood, minimal examples)
  • Maintained technical tone and brevity
  • Updated only necessary sections
  • Verified accuracy against documentation in docs/src/content/docs/
  • Removed outdated information (old temporary ID format)
  • Added clear breaking change warnings

Impact

This update ensures AI agents have accurate, current information when creating or modifying agentic workflows. The changes are primarily additive, documenting new features that were previously undocumented in the instructions file.

🤖 Generated with Claude Sonnet 4.5

AI generated by Instructions Janitor

  • expires on Feb 20, 2026, 12:01 AM UTC

Update instructions file based on documentation added in commit 3975e57.

Changes Made:
- Added new safe-output types: reply-to-pull-request-review-comment, resolve-pull-request-review-thread, unassign-from-user
- Updated temporary ID format specification from 12 hex chars to 3-8 alphanumeric chars
- Added plugins field documentation with experimental warning
- Added skip-roles and skip-bots trigger configuration
- Added status-comment field documentation with breaking change notice
- Updated sandbox documentation to deprecate top-level sandbox: false
- Added Breaking Changes and Deprecations section covering:
  - Deprecated sandbox: false (use sandbox.agent: false)
  - Deprecated timeout_minutes (use timeout-minutes)
  - Deprecated create-agent-task (use create-agent-session)
  - Breaking change for status-comment configuration
  - Temporary ID format change

Documentation Reviewed:
- docs/src/content/docs/reference/frontmatter.md
- docs/src/content/docs/reference/safe-outputs.md
- docs/src/content/docs/reference/safe-outputs-specification.md

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@github-actions github-actions bot added automation documentation Improvements or additions to documentation instructions labels Feb 18, 2026
@pelikhan pelikhan merged commit e84e65a into main Feb 18, 2026
@pelikhan pelikhan deleted the main-deb51a02a6b8b631 branch February 18, 2026 00:03
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.

2 participants

Comments