[docs] Update documentation for agentic-optimization-kit from April 23, 2026

[github-actions]

Documentation Updates - April 23, 2026

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

Features Documented

• Agentic Optimization Kit pattern page (from feat: add agentic-optimization-kit workflow consolidating token audit, optimizer, and observability kit #28009)

📝 Detailed Changes & References

Changes Made

• Created docs/src/content/docs/patterns/agentic-optimization-kit.md — new pattern page documenting the weekly consolidated workflow that combines token audit, optimizer, and observability kit into one report with 5 charts and 5 actionable prompt artifacts

Merged PRs Referenced

• feat: add agentic-optimization-kit workflow consolidating token audit, optimizer, and observability kit #28009 — feat: add agentic-optimization-kit workflow consolidating token audit, optimizer, and observability kit

Skipped Issues

• Provider-based authentication for Claude, Copilot, Codex. #16498 — COPILOT_PROVIDER_* env vars undocumented: requires investigating actual source behavior to document accurately; no matching source code found in this run.
• Meet the workflows points to specific versions, need to keep these up to date #20391 — 115 stale v0.45.5 version links in blog posts: requires automated or bulk update across 10+ blog files; out of scope for a single targeted documentation update.
• 🔍 Multi-Device Docs Testing Report - 2026-04-22 #27823 — Mobile code block overflow on landing page: this is a CSS/layout issue, not a documentation content gap.
• Add WorkQueueOps and BatchOps doc pages under design patterns #22001 — WorkQueueOps/BatchOps pages: workqueue-ops.md already has content; BatchOps page also exists. Complex structural content; not triggered by recent code changes.
• [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 density, trigger cadence, bash allowlist guidance: no corresponding code changes triggered these today.

Notes

The daily documentation quality report (#28015) identified the missing agentic-optimization-kit docs page as a new gap introduced by PR #28009. The new page follows the same structure as the existing agentic-observability-kit.md pattern page and documents:

• The 3-layer analysis approach (Baseline → Optimization → Observability)
• All 5 visual charts and their decision framing
• The 5 actionable prompt artifacts
• Relationship to source workflows and shared repo-memory
• When to use vs. when not to use

Generated by Daily Documentation Updater · ● 354.7K · ◷

• expires on Apr 24, 2026, 11:04 AM UTC