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

[github-actions]

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

---

🆕 What Changed Since April 25

One commit since April 25 — 9da169c — docs: strengthen skip-if-match guidance for scheduled issue-creating workflows (#28545)

• Improved skip-if-match guidance in .github/aw/create-agentic-workflow.md and .github/aw/github-agentic-workflows.md.
• 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 3+ 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 8+ weeks.

---

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

The workflow .github/workflows/agentic-optimization-kit.md exists, but there is no corresponding page in docs/src/content/docs/patterns/. Comparable workflows (agentic-observability-kit, batch-ops, workqueue-ops, etc.) each have a dedicated docs page.

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

---

✅ Previously Reported Issues — Still 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/. Recommendation: close with pointer to the docs pages.

---

📋 Summary

Gap	Severity	Age
COPILOT_PROVIDER_* undocumented (#16498)	🔴 Critical	3+ months
Stale v0.45.5 links in blog posts (#20391)	🟡 Medium	8+ weeks
agentic-optimization-kit missing docs page	🟡 Medium	4 days

New this report: None — no new documentation issues opened; one docs-adjacent commit landed (skip-if-match guidance improvements in workflow templates).

Note

🔒 Integrity filter blocked 19 items

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

• #20593 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".
• #25993 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #26268 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #19080 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #19380 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #26345 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #27935 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #23212 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #27757 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #24259 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #27555 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".
• #27260 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".
• #17352 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• ... and 3 more items

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

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

Generated by Dev · ● 1.1M · ◷

• expires on May 3, 2026, 9:07 AM UTC