[docs] Update documentation for features from 2026-05-24

[github-actions]

Documentation Updates - 2026-05-24

This PR updates the documentation based on user-facing features merged in the last 24 hours.

Features Documented

• Compiler warning for prompts that reference /tmp/ or /tmp/gh-aw/ directly, and the /tmp/gh-aw/agent/ convention for temporary files (from compiler: warn when prompt references /tmp/ or /tmp/gh-aw/ directly #34239)
• Deterministic 5-character model ID prefix (son46, gpt55, opu47, hai45, gem25, ...) in the {effective_tokens_suffix} footer template (from Prefix effective-token footer values with deterministic 5-char model IDs #34291)

📝 Detailed Changes & References

Changes Made

• docs/src/content/docs/reference/markdown.md — Added a Temporary File Paths in Prompts section describing the recommended /tmp/gh-aw/agent/ root for agent temp files, the new compiler warning text, and the reserved sibling namespaces (cache-memory/, repo-memory/, mcp-logs/) that are out of scope for the warning.
• docs/src/content/docs/reference/safe-outputs.md — Updated the {effective_tokens_suffix} variable description in the Custom Messages section to show the new model-ID-prefixed suffix shape (" · ● son46 1.2K") and document the 5-character model identifier convention.
• docs/src/content/docs/reference/footers.md — Updated the matching {effective_tokens_suffix} mention in the Customizing Footer Messages section so both reference pages agree on the new suffix format.

Merged PRs Referenced

• compiler: warn when prompt references /tmp/ or /tmp/gh-aw/ directly #34239 — compiler: warn when prompt references /tmp/ or /tmp/gh-aw/ directly
• Prefix effective-token footer values with deterministic 5-char model IDs #34291 — Prefix effective-token footer values with deterministic 5-char model IDs

Already-Documented PRs (no extra work needed)

• Add opusplan builtin alias to Claude model routing #34263 (opusplan builtin alias) — the merging PR already updated docs/src/content/docs/reference/model-tables.md to list opusplan and clarify that meta-aliases can bake in model parameters.
• Clarify stable vs prerelease upgrade messaging #34245 (stable vs prerelease upgrade messaging) — the merging PR already updated docs/src/content/docs/guides/upgrading.md and docs/src/content/docs/reference/releases.md.

Skipped Issues

The following open documentation issues were reviewed and not addressed in this run — they require larger structural or content edits that are out of scope for a daily incremental update:

• [deep-report] Add Claude/Codex/Gemini engine examples to 7+ Copilot-only reference docs #34053 — [deep-report] Add Claude/Codex/Gemini engine examples to 7+ Copilot-only reference docs. This is a multi-file content addition (7+ reference pages each need Claude/Codex/Gemini-flavored examples added alongside the existing Copilot examples). Better suited to a focused per-page PR than a daily catch-all.
• Docs problem on android Chrome with large user fonts #29545 — Docs problem on android Chrome with large user fonts. CSS/layout issue on the published site; requires investigation of the Astro Starlight theme rather than a docs content edit.
• OWASP Agentic Top 10 compliance evaluation: gap analysis across gh-aw, firewall, and mcpg #28770 — OWASP Agentic Top 10 compliance evaluation. Cross-component compliance audit spanning gh-aw, firewall, and mcpg; far outside a one-shot docs update.
• Add WorkQueueOps and BatchOps doc pages under design patterns #22001 — Add WorkQueueOps and BatchOps doc pages under design patterns. New design-pattern pages, requires authored content rather than mechanical doc sync.
• Meet the workflows points to specific versions, need to keep these up to date #20391 — Meet the workflows points to specific versions, need to keep these up to date. Automation/tooling change to rewrite versioned links; not a manual edit.
• Provider-based authentication for Claude, Copilot, Codex. #16498 — Provider-based authentication for Claude, Copilot, Codex. Auth model decision still being explored; not safe to draft docs ahead of a settled API.

Closed documentation and cookie-labeled issues from the past 7 days were already addressed by prior PRs ([docs] daily updaters, package-spec PRs, dev consolidation runs) — see PRs #34261, #34218, #34216, #34202, #34196, #34074, #34023, #34017, #34013, #33984.

Notes

Most merged PRs in the 24-hour window were internal refactors, CI/lint enforcement, dependency bumps, or workflow-only changes that do not affect user-facing documentation. Notable internal-only items skipped intentionally: #34374 (panicinlibrarycode CI gate), #34373 (named sleep constants), #34338 (npm cooldown for engine installs), #34322 (Avenger CI fixer workflow, internal to this repo), #34318 (Go 1.26 bump), #34307 (Claude Code / Copilot CLI / GitHub MCP Server version bumps), #34297 (pkg/parser refactor), #34225 (workflow temp-path normalization — already covered by the new /tmp/gh-aw/agent/ convention being documented here), #34215 (Copilot BYOK fallback model default — internal lockfile/spec change with no new user-facing surface).

Generated by 📝 Daily Documentation Updater · ● opu47 17.8M · ◷

• expires on May 25, 2026, 11:09 AM UTC