[instructions] Sync instruction files with release v0.86.1 - #51991
Conversation
Reviewed .github/aw/ and docs/ commits since v0.86.1 (150 commits, ~15 touching .github/aw content). Two drifts found and fixed: - github-agentic-workflows.md was missing agent-runtime-instructions.md (added in #51427) from its Reference Files index, even though create-agentic-workflow.md, debug-agentic-workflow.md, update-agentic-workflow.md, and syntax-agentic.md all link to it. - designer-mappings.md's Safe Output Mapping table listed the repo-memory safe output as `push-repo-memory` (the internal compiler job name), inconsistent with every other row in that table which maps to the actual frontmatter safe-output key. The schema and memory.md both confirm the key is `repo-memory`. Size audit: all .github/aw/*.md files remain under their target line limits (largest is github-mcp-server.md at 390/400).
|
Great work on the instruction sync! 🎯 This PR looks solid: ✅ Focused & minimal — Two surgical fixes targeting instruction file drifts identified by the Instructions Janitor audit. ✅ Well-documented — The description includes audit methodology and clear traceability to root causes. ✅ Automated & trusted — Generated by the established Instructions Janitor workflow. This is ready for review and merge. Well done maintaining documentation consistency! 📚
|
|
@copilot Quick triage nudge for this PR. The branch has been refreshed for a follow-up pass. Please review the latest state, check for any unresolved review feedback or failing checks, and run the
|
Completed the follow-up triage pass with
No additional code changes were needed in this pass (HEAD remains |
|
🎉 This pull request is included in a new release. Release: |
Summary
Ran the instructions-janitor audit against release
v0.86.1(currentLatest/pre-release tag; HEAD is 150 commits ahead). Found and fixed two drifts in.github/aw/.Documentation commits reviewed
.github/aw/sincev0.86.1(viapath=.github/awon the GitHub commits API, intersected with thev0.86.1...HEADcompare range): ~15 commits. Most wereactions-lock.jsoncontainer-pin bumps (no.mdcontent). Content-bearing commits reviewed in full:Add missing push-repo-memory mapping to the workflow designer(designer-mappings.md)Add Simplified Technical English (STE) output_format variant to daily experiments(experiments.md)Document agent runtime selection and troubleshooting(new file agent-runtime-instructions.md + cross-links)Remove all mentions of bounded-queries from .github/aw instruction files(syntax-agentic.md, create-agentic-workflow.md, designer-mappings.md) — already fully self-consistent, no follow-up neededdocs/commits sincev0.86.1are dominated by newdocs/adr/*.mdentries (append-only decision records); none surfaced schema/behavior changes not already reflected in.github/aw/.Changes
agent-runtime-instructions.mdto theReference Filestable. It was added in Document agent runtime selection and troubleshooting #51427 and is already linked fromcreate-agentic-workflow.md,debug-agentic-workflow.md,update-agentic-workflow.md, andsyntax-agentic.md, but was missing from the compact entry point's own index.repo-memorySafe Output Mapping row, which readpush-repo-memory(the internal compiler-generated job name, permemory.md) instead of the actual frontmatter safe-output keyrepo-memory(confirmed againstpkg/parser/schemas/main_workflow_schema.json). Every other row in that table maps to the real frontmatter key, so this was an inconsistency introduced in Add missing push-repo-memory mapping to the workflow designer #51937.Before/after line counts
Duplication
Checked for duplicate
runtime-install/docker-sbx/gvisor/arc-dindguidance across files touched by #51427:syntax-agentic.mdandsyntax-core.mdcarry only brief schema-level mentions with a cross-link toagent-runtime-instructions.mdfor details — no consolidation needed.Size audit
All
.github/aw/*.mdfiles remain under their target limits. Largest isgithub-mcp-server.mdat 390/400 lines (unchanged by this PR).🤖 Generated with [Claude Code]((claude.com/redacted)
Run: https://github.com/github/gh-aw/actions/runs/31480116219> Generated by 👨🍳 PR Sous Chef · gpt54 · 20.9 AIC · ⌖ 5.08 AIC · ⊞ 8.5K · ◷