[docs] Update documentation for features from 2026-04-18

[github-actions]

Documentation Updates - April 18, 2026

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

Features Documented

• redirect: frontmatter field for workflow relocation (from Add redirect support for updates with --no-redirect and safe-update approval checks #26903)
• allowed-base-branches for per-run base branch overrides in create-pull-request (from Add policy-gated per-run base branch override for create_pull_request #26916)
• steps-run-secrets-to-env and engine-env-secrets-to-engine-config codemods for gh aw fix (from [aw-compat] Add gh aw fix codemods for strict-mode secret leaks in step run and engine.env #26919)

📝 Detailed Changes & References

Changes Made

• Updated docs/src/content/docs/reference/frontmatter.md to add a redirect: section documenting the new frontmatter field that signals a workflow has moved, how gh aw update follows redirect chains, and the --no-redirect flag behavior.
• Updated docs/src/content/docs/reference/safe-outputs-pull-requests.md to document allowed-base-branches — a policy-gated list of glob patterns that enables the agent to override the target PR base branch at runtime.
• Updated docs/src/content/docs/setup/cli.md to:
  • Add --no-redirect option to the gh aw update command reference.
  • Replace the single-codemod mention in gh aw fix with an explicit list including steps-run-secrets-to-env and engine-env-secrets-to-engine-config.

Merged PRs Referenced

• Add redirect support for updates with --no-redirect and safe-update approval checks #26903 — Add redirect support for updates with --no-redirect and safe-update approval checks
• Add policy-gated per-run base branch override for create_pull_request #26916 — Add policy-gated per-run base branch override for create_pull_request
• [aw-compat] Add gh aw fix codemods for strict-mode secret leaks in step run and engine.env #26919 — Add gh aw fix codemods for strict-mode secret leaks in step run and engine.env

Skipped Issues

• Provider-based authentication for Claude, Copilot, Codex. #16498 (COPILOT_PROVIDER_* BYOK vars) — Active gap confirmed, but requires detailed knowledge of the Copilot CLI BYOK API surface that is not yet stable enough to document accurately. Left for a future PR.
• Meet the workflows points to specific versions, need to keep these up to date #20391 (stale v0.45.5 blog links) — Requires bulk update of 18+ blog files across 58+ link occurrences. Deferred as a dedicated automation task.
• Add Playwright smoke test for editor playground in docs CI #25383 (editor playground CI) — Testing infrastructure gap, not a documentation content gap.

Notes

Team reviewer support (#26915) was already present in safe-outputs-pull-requests.md before this run — no update needed.

Generated by Daily Documentation Updater · ● 511.8K · ◷

• expires on Apr 19, 2026, 10:56 AM UTC