Skip to content

Conversation

@github-actions
Copy link
Contributor

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

Instructions Update - Synchronized with v0.27.0

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

Changes Made

New Frontmatter Fields:

  • description: - Human-readable workflow description
  • source: - Workflow origin tracking (format: owner/repo/path@ref)
  • github-token: - Default GitHub token configuration (must use ${{ secrets.* }} syntax)
  • roles: - Repository access role controls (default: [admin, maintainer, write])
  • strict: - Enhanced validation mode for production workflows
  • features: - Feature flags for experimental features
  • environment: - Environment protection rules
  • container: - Container configuration
  • services: - Service containers

Trigger Configuration Updates:

  • Added reaction: field for emoji reactions to triggering items
  • Added manual-approval: field for environment protection rules

Engine Configuration Enhancements:

  • engine.env - Custom environment variables (object)
  • engine.args - Custom CLI arguments injected before prompt (array)
  • engine.error_patterns - Custom error pattern recognition (array)

Network/Firewall Updates:

  • Added network.firewall configuration for Copilot engine (AWF support)
  • Firewall supports version, log-level, and args parameters
  • Updated network permissions documentation to reflect multi-engine support

GitHub Tools Updates:

  • Added search toolset to available toolsets
  • Added recommendation to prefer toolset: over allowed: configuration
  • Clarified that toolsets provide better organization and reduced configuration verbosity

Documentation Commits Reviewed

This commit introduced a comprehensive documentation structure under docs/src/content/docs/ with detailed reference documentation for engines, frontmatter, tools, and other workflow components.

Validation

  • ✅ Followed prompting best practices (imperative mood, minimal examples)
  • ✅ Maintained technical tone and brevity
  • ✅ Updated only necessary sections
  • ✅ Verified accuracy against current documentation in docs/src/content/docs/
  • ✅ Removed outdated content where applicable
  • ✅ Preserved existing structure and organization

AI generated by Instructions Janitor

Synchronized instructions file with documentation changes from the new docs structure added in commit 1c80b2d.

### Changes Made

- Added new frontmatter fields: description, source, github-token, roles, strict, features, environment, container, services
- Added reaction and manual-approval fields to on: trigger configuration
- Added engine.env, engine.args, and engine.error_patterns configuration options
- Updated network permissions to include firewall configuration for Copilot engine (AWF support)
- Added search toolset to GitHub tools documentation
- Added recommendation to prefer toolset over allowed for GitHub tools configuration
- Updated engine network permissions section to reflect multi-engine support and AWF

### Documentation Commits Reviewed

- 1c80b2d Add shallow checkout to activation job for timestamp verification (#3013)

### Validation

- Followed prompting best practices (imperative mood, minimal examples)
- Maintained technical tone and brevity
- Updated only necessary sections
- Verified accuracy against current documentation
- Removed outdated content where applicable

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

Co-Authored-By: Claude <[email protected]>
@github-actions github-actions bot added automation documentation Improvements or additions to documentation instructions labels Nov 3, 2025
@pelikhan pelikhan enabled auto-merge (squash) November 3, 2025 02:22
@pelikhan pelikhan merged commit bdadbb9 into main Nov 3, 2025
4 checks passed
@pelikhan pelikhan deleted the instructions-sync-v0.27.0-46f973e79bf4338f branch November 3, 2025 03:02
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