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

[github-actions]

Documentation Updates — April 24, 2026

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

Features Documented

• --name flag restriction for multiple workflows (from fix: disallow --name flag when adding multiple workflows at once #28195)
• Agentic Optimization Kit new docs page (gap identified in daily report [Daily Report] Documentation Quality Report — April 24, 2026 #28225, [Daily Report] Documentation Quality Report — April 23, 2026 #28015)

📝 Detailed Changes & References

Changes Made

• Updated docs/src/content/docs/setup/cli.md:

  • Added a multi-workflow add example (gh aw add workflow1 workflow2 workflow3)
  • Added a --name single-workflow example
  • Added a > [!NOTE] callout explaining that --name cannot be used when adding multiple workflows at once (returns an error)

• Created docs/src/content/docs/patterns/agentic-optimization-kit.md:

  • New reference page for the weekly Agentic Optimization Kit workflow
  • Documents its three analysis phases (baseline audit, optimization target selection, episode/observability analysis)
  • Describes the five diagnostic charts and their decision questions
  • Covers the report structure, escalation conditions, metrics/scoring, and cost caveats
  • Explains the relationship to the Agentic Observability Kit

• Updated docs/astro.config.mjs:

  • Added Agentic Optimization Kit entry to the Patterns section of the sidebar

Merged PRs Referenced

• fix: disallow --name flag when adding multiple workflows at once #28195 — fix: disallow --name flag when adding multiple workflows at once

Documentation Issues Referenced

• Open gap from daily reports [Daily Report] Documentation Quality Report — April 23, 2026 #28015, [Daily Report] Documentation Quality Report — April 24, 2026 #28225 — agentic-optimization-kit workflow added in feat: add agentic-optimization-kit workflow consolidating token audit, optimizer, and observability kit #28009 had no docs page

Skipped Issues

• Provider-based authentication for Claude, Copilot, Codex. #16498 (COPILOT_PROVIDER_* vars) — Requires knowledge of the full provider configuration schema; out of scope for this automated run without additional investigation.
• Meet the workflows points to specific versions, need to keep these up to date #20391 (Stale v0.45.5 blog links) — Requires automated tooling or a bulk update; appropriate for a dedicated task.
• [plan] Improve prompt step density guidance in create-agentic-workflow.md #27499, [plan] Add trigger cadence clarifying question to create-agentic-workflow.md #27501, [plan] Document bash allowlist decision rule in github-agentic-workflows.md #27502 (Prompt authoring guidance, trigger cadence, bash allowlist) — Internal workflow author documentation; requires deeper domain knowledge of the authoring workflow (.github/aw/create-agentic-workflow.md).
• 🔍 Multi-Device Docs Testing Report - 2026-04-22 #27823 (Mobile code block overflow) — CSS/rendering issue in the Astro/Expressive Code stack; not a content documentation gap.

Notes

None.

Generated by Daily Documentation Updater · ● 522.6K · ◷

• expires on Apr 25, 2026, 11:03 AM UTC

[github-actions]

Hey @github-actions[bot] 👋 — great work on this automated documentation update! The new Agentic Optimization Kit reference page is thorough and well-structured, and the --name flag clarification in the CLI docs is a helpful addition for users.

This PR looks well-aligned with the project's documentation standards and contribution process. It's ready for maintainer review. 🎉

Generated by Contribution Check · ● 1.3M · ◷