Skip to content

[instructions] Sync instruction files with release v0.82.9#45701

Merged
pelikhan merged 1 commit into
mainfrom
instructions-sync-syntax-accuracy-69ac1c6cc8295d00
Jul 15, 2026
Merged

[instructions] Sync instruction files with release v0.82.9#45701
pelikhan merged 1 commit into
mainfrom
instructions-sync-syntax-accuracy-69ac1c6cc8295d00

Conversation

@github-actions

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

Copy link
Copy Markdown
Contributor

Summary

Syncs instruction/syntax documentation files with the v0.82.9 engine registry and toolsets schema.

Changes

.github/aw/syntax-agentic.md

  • Removed crush from the list of supported experimental engine identifiers (both the string-format prose and the inline YAML comment).
  • Supported experimental engines are now: antigravity, opencode, pi.

.github/aw/syntax-tools-imports.md

  • Clarified that toolsets: accepts a single string or an array; a bare string is treated as a one-element array.
  • Previous docs stated "array only", which was incorrect after the schema was relaxed.

Impact

  • Documentation-only change; no runtime behaviour altered.
  • Users who relied on crush as an engine identifier should switch to a supported engine.
  • Users may now write toolsets: issues instead of toolsets: [issues].

Generated by PR Description Updater for #45701 · 23.1 AIC · ⌖ 7.44 AIC · ⊞ 4.7K ·

Fix two accuracy drifts found against source-of-truth code:

- syntax-agentic.md: remove nonexistent "crush" engine from the engine
  string-format and object-format id lists. The engine registry
  (pkg/workflow/*_engine.go) and main_workflow_schema.json list only
  claude/codex/copilot/gemini plus experimental antigravity/opencode/pi.
- syntax-tools-imports.md: correct tools.github.toolsets from "(array
  only)" to note it accepts a single name string or an array (a string
  is shorthand for a one-element array), per the oneOf in
  main_workflow_schema.json.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor Author

Hey @github-actions 👋 — thanks for this Instructions Janitor pass keeping the syntax-agentic.md and syntax-tools-imports.md files accurate against v0.82.9! The accuracy audit is thorough and the two targeted fixes (removing the nonexistent crush engine and correcting the toolsets type note) are well-justified.

One small gap to consider:

  • No test changes — since these are pure documentation/instruction files, automated snapshot or golden-file tests covering the .github/aw/*.md content would help catch future drift automatically. If the project has any doc-linting or schema-validation tests, wiring this content through them could close the loop.

If you'd like a hand automating this, here's a ready-to-use prompt:

Add a test or validation step that checks .github/aw/syntax-agentic.md and .github/aw/syntax-tools-imports.md for accuracy against the engine registry and JSON schema.
Specifically:
1. Verify every engine name listed in the instruction files exists in pkg/workflow/*_engine.go or main_workflow_schema.json.
2. Verify the tools.github.toolsets description matches the oneOf definition in the schema.
Place the check in the appropriate test file or as a linting script so future drift is caught automatically in CI.

Generated by ✅ Contribution Check · 103.4 AIC · ⌖ 9.06 AIC · ⊞ 6.2K ·

@pelikhan
pelikhan merged commit 3afd749 into main Jul 15, 2026
@pelikhan
pelikhan deleted the instructions-sync-syntax-accuracy-69ac1c6cc8295d00 branch July 15, 2026 10:15
@gh-aw-bot

Copy link
Copy Markdown
Collaborator

@copilot please run the pr-finisher skill, address any remaining review feedback, and rerun checks once updates are complete.

Generated by 👨🍳 PR Sous Chef

Generated by 👨‍🍳 PR Sous Chef · 11.2 AIC · ⌖ 5.7 AIC · ⊞ 7.5K ·
Comment /souschef to run again

@github-actions

Copy link
Copy Markdown
Contributor Author

🎉 This pull request is included in a new release.

Release: v0.82.10

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