[instructions] Sync instruction files with release v0.79.8#39527
Merged
pelikhan merged 1 commit intoJun 16, 2026
Conversation
Align .github/aw/syntax-agentic.md frontmatter reference with the authoritative engine catalog and schema: - engine: add experimental `crush` and `pi` to the string/id lists (engine_definition.go catalog + docs/reference/engines.md list both) - user-rate-limit.ignored-roles: document the full valid value set (admin/maintain/write/triage/read) per main_workflow_schema.json enum, not just the default Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
github-actions
Bot
added
automation
documentation
Contributor
Author
|
Great work from the Instructions Janitor on keeping One minor note:
If you'd like to add automated coverage for instruction file accuracy, you can assign this prompt to your coding agent:
|
pelikhan
approved these changes
Jun 16, 2026
pelikhan
deleted the
instructions-sync-engines-roles-v0.79.8-457cd4e338646c9e
branch
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
1 participant
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
Instructions-janitor pass against release v0.79.8 (latest; commit
8b02ab33). Only one commit landed since the release tag (a91954a, an executive-report chore touching no docs or.github/aw/files), so the work focused on the standing size, duplication, and accuracy audits.Files changed
.github/aw/syntax-agentic.md(499 → 499 lines; in-place edits, no line growth)Accuracy fixes (code is source of truth)
Two concrete drifts found and corrected against
pkg/workflow/andpkg/parser/schemas/main_workflow_schema.json:engine:list incomplete. Docs listed onlycopilot/claude/codex/gemini/opencode. The engine catalog (pkg/workflow/engine_definition.go,engine_catalog_test.go) and the canonicaldocs/reference/engines.mdtable both ship the experimental enginescrushandpias user-selectable. Added them (marked experimental) to both the string-format line and the object-formatid:comment.antigravityis in the catalog but not yet in the official engines reference table, so it was intentionally left out to match user-facing docs.ignored-rolesvalid values undocumented. Docs showed only the default[admin, maintain, write]. The schema enum (main_workflow_schema.json:10674) also allowstriageandread. Documented the full value set.Audits with no changes required
safe-outputs*.mdagainstsafe_outputs_config.goand the schema — defaults (max-patch-size 4096KB, max-patch-files 100, timeout 45m), body limits (20–65000 chars), and field names (state-reason,allow-workflows,max-size) all match. No drift.emoji,models(custom pricing),engine.bareconfirmed documented (syntax-agentic.md / token-optimization.md).default-safe-outputsecosystem: correctly documented insyntax-tools-imports.mdas asafe-outputs.allowed-domainsidentifier; deliberately NOT added tonetwork.md(which scopesnetwork:), since that would be wrong context.wc -l .github/aw/*.md— all files ≤ 500. Largest issyntax-agentic.mdat 499 (at the limit; flagged below).workflow-constraints.md/workflow-editing.md/workflow-patterns.md. Some reinforcement of read-only security posture and recompilation rules recurs across the standalone task prompts, but it is intentional (each prompt is loaded independently) and existing cross-references are present — no consolidation made this pass to avoid degrading standalone usability.Watch item
syntax-agentic.mdsits at exactly 499 lines. Per the size mandate, the next addition of content should extract a focused sub-file rather than push it over 500. This PR added no new lines (edits are in place).🤖 Generated with [Claude Code]((claude.com/redacted)