Skip to content

[instructions] Sync instruction files with release v0.82.2#43990

Merged
pelikhan merged 1 commit into
mainfrom
instructions-sync-v0822-4e1aa80e57e22465
Jul 7, 2026
Merged

[instructions] Sync instruction files with release v0.82.2#43990
pelikhan merged 1 commit into
mainfrom
instructions-sync-v0822-4e1aa80e57e22465

Conversation

@github-actions

@github-actions github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Summary

Syncs four instruction files under .github/aw/ with release v0.82.2. Changes are documentation-only — no Go code, compiled output, or workflow YAML is modified.

Changed Files

File Change type
.github/aw/create-agentic-workflow.md Editorial consolidation
.github/aw/safe-outputs-runtime.md Wording and formatting fix
.github/aw/syntax-agentic.md Field corrections + new evals: field
.github/aw/update-agentic-workflow.md Editorial consolidation

Change Details

create-agentic-workflow.md — §8 cost-aware triage
  • Collapsed four separate bullets (cheap triage, explicit noop/safe-output, frontier-model reasoning, pull-on-demand context) into a single bullet linking to workflow-patterns.md#high-volume-triage-and-escalation-pattern.
  • Removed workflow-patterns.md from the trailing "See also" list (now linked inline); kept subagents.md and token-optimization.md.
safe-outputs-runtime.md — report-incomplete description
  • Removed extraneous leading blank line and indent from the report-incomplete paragraph.
  • Changed "automatically enabled by default" → "enabled by default".
  • Merged the final tracking sentence into the preceding sentence for concision.
syntax-agentic.md — field corrections and new evals: field
  • github-token: — description changed from "Default GitHub token for workflow" to "GitHub token override"; added note that it is not a top-level field and must be placed under on:, tools.github, or safe-outputs.
  • bots: — renamed to on.bots: to reflect correct frontmatter placement.
  • evals:new field (experimental). Documents BinEval binary (YES/NO) evaluation questions that run after safe-outputs and before the conclusion job. Supports shorthand form and extended form with questions, optional model, and runs-on.
update-agentic-workflow.md — Cost-Oriented Update Checks section
  • Replaced a 7-item bulleted checklist with a single prose paragraph. Content is semantically equivalent; now links directly to workflow-patterns.md#high-volume-triage-and-escalation-pattern, subagents.md, and token-optimization.md.

Agentic Analysis Notes

  • No breaking changes. Field rename bots: to on.bots: and github-token: scope clarification are documentation corrections aligning docs with existing runtime behaviour.
  • New capability documented: evals: is an experimental frontmatter field; its addition here is documentation only.
  • Cross-reference graph updated: workflow-patterns.md is now referenced inline rather than via trailing "See also" links in two files.

Generated by PR Description Updater for #43990 · 49.5 AIC · ⌖ 6.33 AIC · ⊞ 4.7K ·

Accuracy: document the `evals` frontmatter field (only undocumented
top-level schema key); rescope `github-token`/`bots` under `on:` in
syntax-agentic.md. Duplication: collapse the cost-aware triage bullet
sets in the creator and updater prompts to reference the canonical
High-Volume Triage and Escalation Pattern. Cleanup: fix orphaned
report-incomplete paragraph in safe-outputs-runtime.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation instructions labels Jul 7, 2026
@github-actions

This comment has been minimized.

@github-actions

This comment has been minimized.

@github-actions

This comment has been minimized.

@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor Author

Hey @github-actions[bot] 👋 — nice work on this automated janitor pass syncing the .github/aw/ instruction files to v0.82.2! The accuracy audit against pkg/workflow/safe_outputs_config.go and the schema, the duplication collapse in the creator/updater prompts, and the safe-outputs-runtime.md structural cleanup are all well-scoped and clearly documented.

One flag from the automated checklist:

  • No test changes — all four changed files are .md instruction files with no accompanying test updates. For a pure documentation maintenance PR like this, no test coverage is typically expected. If the project has any linting or validation scripts for .github/aw/*.md files, confirming they pass would close this gap cleanly.

If you'd like to address this with an agent:

Check whether the gh-aw repository has any linting, schema validation, or automated checks configured for .github/aw/*.md instruction files (e.g., via Makefile targets, CI scripts, or a dedicated linter). If such checks exist, run them against the four files changed in this PR (syntax-agentic.md, create-agentic-workflow.md, update-agentic-workflow.md, safe-outputs-runtime.md) and report the results.

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • patchdiff.githubusercontent.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "patchdiff.githubusercontent.com"

See Network Configuration for more information.

Generated by ✅ Contribution Check · 352.6 AIC · ⌖ 26.7 AIC · ⊞ 6.2K ·

@pelikhan pelikhan merged commit 19523de into main Jul 7, 2026
@pelikhan pelikhan deleted the instructions-sync-v0822-4e1aa80e57e22465 branch July 7, 2026 14:21
@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor Author

🎉 This pull request is included in a new release.

Release: v0.82.4

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