[instructions] Sync instruction files with release v0.78.1#36600
Merged
Conversation
Document frontmatter/safe-output changes landed since the last sync (v0.77.5): - max-turns: now a top-level field across all engines; engine.max-turns documented as a deprecated alias (PR #36451) - max-effective-tokens / max-daily-effective-tokens: previously undocumented top-level ET guardrail fields, with K/M short-form support and the default-on daily guardrail (-1 to disable) (PR #36392, #36496) - create-issue deduplicate-by-title option (PR #36527) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
github-actions
Bot
added
automation
documentation
pelikhan
reviewed
Jun 3, 2026
| - **`max-daily-effective-tokens:`** — Per-user 24-hour guardrail. At activation, gh-aw sums the triggering user's ET across their runs of this workflow over the last 24 hours and blocks execution once the total exceeds the threshold. Enabled by default with a system default threshold; set `-1` to disable, or an explicit value to override the default. | ||
|
|
||
| ```yaml | ||
| max-effective-tokens: 100M # per-run cap (short-form string) |
|
|
||
| ```yaml | ||
| max-effective-tokens: 100M # per-run cap (short-form string) | ||
| max-daily-effective-tokens: 500M # per-user 24h cap; -1 disables |
Contributor
There was a problem hiding this comment.
Updated both example values — 100M → 10M and 500M → 50M in the YAML snippet. Unfortunately the push to this branch is blocked by a repository ruleset ("Cannot create ref due to creations being restricted"), so the commit cannot be pushed. The change is ready locally and can be applied manually if needed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Syncs instruction files with release v0.78.1, introducing documentation for three new workflow frontmatter guardrails (
max-turns,max-effective-tokens,max-daily-effective-tokens), deprecating the legacyengine.max-turnsalias, and addingdeduplicate-by-titlesupport (with fuzzy matching) to theissuesafe-output type.What changed and why
New top-level frontmatter guardrails (
.github/aw/syntax-agentic.md)Three new top-level fields are now documented:
max-turnsmax-effective-tokensmax-daily-effective-tokensThe engine-level alias
engine.max-turnsis deprecated in favour of the new top-levelmax-turnsfield. No breaking change — existing workflows using the alias continue to work.Token-optimisation technique 9 (
.github/aw/token-optimization.md)A new "Technique 9" section documents how to use
max-effective-tokensandmax-daily-effective-tokensas cost-control guardrails, including an inline YAML usage example showing correct frontmatter placement.deduplicate-by-titleon issue safe-outputs (.github/aw/safe-outputs-content.md)The
issuesafe-output type now documents adeduplicate-by-titleoption that removes duplicate issues by title. Accepts either a boolean (exact match) or a positive integer (fuzzy match via edit-distance threshold).Impact
Checklist
deduplicate-by-titleclearly specified