Skip to content

[instructions] Sync instruction files with release v0.74.8#34196

Merged
pelikhan merged 1 commit into
mainfrom
instructions-janitor-sync-v0.74.8-c9e5b099b1421266
May 23, 2026
Merged

[instructions] Sync instruction files with release v0.74.8#34196
pelikhan merged 1 commit into
mainfrom
instructions-janitor-sync-v0.74.8-c9e5b099b1421266

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

@github-actions github-actions Bot commented May 23, 2026

Instructions Update - Synchronized with v0.74.8

This PR adds documentation for two safe-output operations that exist in code and the workflow schema but were missing from .github/aw/safe-outputs.md. Identified by comparing pkg/workflow/compiler_types.go (SafeOutputsConfig struct), pkg/workflow/safe_outputs_config.go (parser dispatch), and pkg/parser/schemas/main_workflow_schema.json against the current instructions.

Files Changed

  • .github/aw/safe-outputs.md: added comment-memory and create-check-run sections.

Operations added

  • comment-memory — Persist and update a managed memory comment on issues/PRs. Materializes memory content to files for agent editing and synchronizes edits back to a single managed comment after execution. Source: pkg/workflow/comment_memory.go, schema at line 4320.
  • create-check-run — Create GitHub Check Runs to surface agent analysis results in the PR Checks UI. Requires checks: write permission. Source: pkg/workflow/create_check_run.go, schema at line 6818.

Audit Notes

  • Only one commit landed since v0.74.8 (5288def, debug logging); no doc changes there to review. The drift this PR fixes pre-dates that commit but had not been reflected in the instruction files.
  • Confirmed the deprecated create-agent-task (schema line 4997) is intentionally not documented — superseded by the already-documented create-agent-session.
  • Confirmed create-code-scanning-alert (singular) is the correct YAML key by inspecting the parser (outputMap["create-code-scanning-alert"] in pkg/workflow/create_code_scanning_alert.go); the plural-suffix YAML struct tag in compiler_types.go is unused dead metadata, not a doc bug.

Size Audit

File Before After Limit Status
github-agentic-workflows.md 196 196 250 (hard) OK
safe-outputs.md 1041 1070 1100 (target) OK
syntax.md 964 964 1000 (target) OK
triggers.md 165 165 200 (target) OK
context.md 196 196 250 (target) OK
cli-commands.md 268 268 400 (target) OK

Validation

  • Followed prompting best practices (imperative mood, minimal examples)
  • Maintained technical tone and brevity
  • Updated the correct sub-file for each change (safe-outputs.md, not the main file)
  • No content duplication introduced between files
  • File sizes within target limits
  • Verified accuracy against current codebase (struct fields, parsers, schema)

Generated by 🧹 Instructions Janitor · ● 16.2M ·

  • expires on May 25, 2026, 9:16 AM UTC

Generated by 👨‍🍳 PR Sous Chef · ● 2.6M ·

Add documentation for two safe-output operations that exist in code
(pkg/workflow/comment_memory.go, pkg/workflow/create_check_run.go) and
in the workflow schema but were missing from .github/aw/safe-outputs.md:

- comment-memory: managed memory comment persistence on issues/PRs
- create-check-run: surface agent analysis results as GitHub Check Runs

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation instructions labels May 23, 2026
@github-actions
Copy link
Copy Markdown
Contributor Author

@copilot summarize the remaining blockers and re-check once CI settles.

pr-sous-chef run: https://github.com/github/gh-aw/actions/runs/26332890079

Generated by 👨‍🍳 PR Sous Chef · ● 5.1M ·

@pelikhan pelikhan merged commit e1b3e05 into main May 23, 2026
@pelikhan pelikhan deleted the instructions-janitor-sync-v0.74.8-c9e5b099b1421266 branch May 23, 2026 12:49
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