[Daily Report] Documentation Quality Report — April 25, 2026

[github-actions]

Daily status report on documentation quality for the gh-aw project, cross-referenced against open issues.

---

🆕 What Changed Since April 24

One commit since April 24 — 9b767eb — docs: remove duplicate deployment section and redundant lists in agentic-observability-kit (#28391)

• Docs cleanup in agentic-observability-kit pattern page.
• No fixes to any previously reported documentation gaps.

---

🐛 Open Documentation Issues

1. #16498 — Provider-based authentication for Claude, Copilot, Codex (open since Feb 2026)

Labels: documentation, enhancement, security, cli

COPILOT_PROVIDER_* env variables remain completely undocumented — 0 occurrences found across all of docs/. Users wanting Azure/Anthropic/OpenAI custom model providers have no guidance.

Relevant docs to update: reference/auth.mdx, reference/engines.md, reference/environment-variables.md
Status: ❌ Critical gap — BYOK shipped 2+ months ago; still undocumented.

---

2. #20391 — Stale v0.45.5 version links in blog posts (open since March 2026)

Labels: documentation, automation, workflows

115 occurrences of v0.45.5 still present across blog post files in docs/src/content/docs/blog/. No automation exists to keep version links current.

Status: ❌ Ongoing — 115 stale install links, unaddressed 7+ weeks.

---

3. agentic-optimization-kit — No documentation page (gap first noted Apr 23)

The workflow .github/workflows/agentic-optimization-kit.md was added in #28009 with no corresponding page in docs/src/content/docs/patterns/. Comparable workflows (e.g., agentic-observability-kit) each have a dedicated docs page.

Relevant doc location to create: docs/src/content/docs/patterns/agentic-optimization-kit.md
Status: ❌ Gap persists — third consecutive day.

---

✅ Previously Reported Issues — Now Resolved

Issue	Resolution
#27501 Trigger cadence clarifying question	✅ Closed as completed (Apr 21)
#27502 Bash allowlist decision rule	✅ Closed as completed (Apr 21)
#27499 Prompt step density guidance	✅ Closed as not planned (Apr 23)
#27823 Mobile code block overflow	✅ Closed

---

i️ Issues Where Documentation Already Has the Answer

Issue	Status
#22001 WorkQueueOps/BatchOps pages	Both workqueue-ops.md and batch-ops.md exist in docs/src/content/docs/patterns/. Recommend closing — docs were delivered.

---

📊 Summary Table

Issue	Type	Docs Exist?	Action Needed	Age
#16498 BYOK auth vars undocumented	Missing content	❌ 0 occurrences	Add COPILOT_PROVIDER_* to reference/auth.mdx + engines.md	2+ months
#20391 Stale v0.45.5 blog links	Stale content	❌ 115 stale links	Automate version link updates	7+ weeks
(new Apr 23) agentic-optimization-kit	Missing page	❌ No docs page	Create docs/src/content/docs/patterns/agentic-optimization-kit.md	3 days
#22001 WorkQueueOps/BatchOps pages	Already resolved	✅ Pages exist	Close issue — docs delivered	5+ weeks

---

Report generated 2026-04-25

Note

🔒 Integrity filter blocked 10 items

The following items were blocked because they don't meet the GitHub integrity level.

• create_pull_request returns patch file instead of creating PR when multiple PRs exist #28389 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• create-pull-request with target-repo: safe_outputs checkout uses triggering repo's ref instead of target repo's default branch #28158 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• Docs: guidelines for configuring Go module/build cache in a security-conscious way #27886 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #20593 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #10305 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #22939 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #21243 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #27886 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #19611 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #26069 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".

To allow these resources, lower min-integrity in your GitHub frontmatter:

tools:
  github:
    min-integrity: approved  # merged | approved | unapproved | none

Generated by Dev · ● 815.4K · ◷

• expires on May 2, 2026, 9:06 AM UTC