[Daily Report] Daily Status Report — 2026-04-03

[github-actions]

📚 Documentation Quality — Daily Status Report

Date: 2026-04-03 | Scope: gh-aw documentation health
Previous report: #24041 (2026-04-02)

---

Summary

Category	Count
Issues resolved since last report	2 ✅
Carry-over documentation gaps	6 ⚠️
New documentation issues today	0 🆕
Open plan items (noob audit)	8 📋

---

✅ Progress Since Last Report

#23950 — Docs: clarify default AWF memory limit → CLOSED (2026-04-02)

The memory: field in docs/src/content/docs/reference/frontmatter.md now explicitly states the default value is 6g.

#23957 — docs: add audit command reference page → CLOSED (2026-04-02)

docs/src/content/docs/reference/audit.md was created, covering all three audit subcommands (gh aw audit, gh aw audit diff, gh aw audit report), flags, output formats, and JSON schemas.

---

⚠️ Carry-Over Documentation Gaps

toolsets: [all] shorthand — undocumented permission risk

Status: Still unresolved. docs/src/content/docs/reference/github-tools.md does not warn that toolsets: [all] silently includes the dependabot toolset, which requires vulnerability-alerts: read (GitHub App–only). Users who copy examples using [all] get a cryptic permissions failure.

Recommended action: Add a callout to reference/github-tools.md:

⚠️ toolsets: [all] includes the dependabot toolset, which requires vulnerability-alerts: read (GitHub App–only). Prefer listing specific toolsets unless you need Dependabot tools.

---

Issue #19703 — .github/agents/ path does not resolve

Problem: docs/src/content/docs/reference/copilot-custom-agents.md states agent files should live in .github/agents/, but the compiler resolves imports relative to .github/workflows/, causing "file not found" errors.

Classification: ❌ Docs/implementation mismatch — unresolved.

---

Issue #19611 — .github/agents imports on Claude/Codex take fragile path

Problem: docs/src/content/docs/reference/imports.md and copilot-custom-agents.md claim agent imports work cross-engine. In practice, the .github/snippets/ workaround is safer but undocumented.

Classification: ❌ Docs/implementation mismatch — unresolved. Related to #19703.

---

Issue #22939 — AWF agent cannot reach Postgres started via services:

Problem: docs/src/content/docs/reference/frontmatter.md documents services: with a Postgres example but never clarifies that service containers are unreachable from inside the agent sandbox.

Classification: ❌ Documentation gap — unresolved.

---

Issue #23212 — gh aw add rewrites imports with incorrect path

Problem: docs/src/content/docs/guides/packaging-imports.md does not document gh aw add's import-rewriting behavior, the incorrect base path it uses, or how to opt out.

Classification: ❌ Undocumented behavior — unresolved.

---

Issue #23958 — docs: add guide for consuming audit reports with an agent

Status: Open, assigned to Copilot (part of epic #22735).
Problem: No guide exists showing how to feed gh aw audit --json output into agentic workflows for automated analysis.

Target file: docs/src/content/docs/guides/audit-with-agents.md

Classification: ❌ Missing documentation — in progress.

---

📋 Open Plan: Noob Tester Audit (#24115)

Issue #24115 tracks 8 actionable improvements identified from the Documentation Noob Test Report. None are yet resolved:

#	Action Item	Target File
1	Fix sitemap 404 (/gh-aw/sitemap-index.xml)	docs/astro.config.*
2	Clarify COPILOT_GITHUB_TOKEN in Quick Start (vs GITHUB_TOKEN, how to add it)	setup/quick-start.md
3	Define "frontmatter" on first use in Quick Start	setup/quick-start.md
4	Rename "Peli's Agent Factory" nav item to something descriptive	docs/astro.config.*
5	Fix "Examples" nav link (points to /#gallery not a real page)	docs/astro.config.*
6	Move GHES content below beginner content on CLI page	setup/cli.md
7	Move early-access warning higher on homepage	homepage / quick-start
8	Add sample output for gh aw add-wizard in Quick Start	setup/quick-start.md

---

🔎 Issues Answerable by Existing Docs

The documentation survey confirms comprehensive coverage of all major topics. Issues asking "how to configure X" likely already have answers:

Topic	Existing Docs
Authentication / tokens	reference/auth.mdx, reference/tokens.md
MCP server setup	guides/mcps.md, guides/getting-started-mcp.md
Network/permissions	reference/network.md, reference/permissions.md
Troubleshooting / errors	troubleshooting/errors.md, troubleshooting/common-issues.md, troubleshooting/debugging.md
Audit commands	reference/audit.md (newly created)

Issue #23959 (audit cross-references and glossary entries) is still open — adding those entries to reference/glossary.md, troubleshooting/debugging.md, reference/network.md, reference/mcp-gateway.md, and reference/cost-management.md would significantly improve discoverability.

---

📊 Day-over-Day Trend

Metric	2026-04-02	2026-04-03	Change
Open doc-problem issues	9	7	⬇️ -2 closed
Carry-over gaps	5	6	⬆️ +1 (audit guide #23958 still open)
New issues today	4	0	⬇️ —
Issues closed/resolved	3	2 (#23950, #23957)	✅
Missing reference pages	2	1 (audit-with-agents guide)	⬇️ -1
Open plan items	0	8 (#24115)	🆕

---

🎯 Recommended Actions

Priority	Action	Target
High	Complete audit-with-agents guide	#23958
High	Fix compiler or update docs for .github/agents/ path	#19703, #19611
High	Work through #24115 plan items (sitemap, Quick Start fixes, nav)	#24115
Medium	Add sandbox networking note to services: in frontmatter.md	#22939
Medium	Add audit cross-references to glossary, debugging, network, MCP gateway	#23959
Medium	Document gh aw add import rewriting in packaging-imports.md	#23212
Low	Add toolsets: [all] warning callout to github-tools.md	carry-over

---

Generated by Daily Status Report workflow — 2026-04-03 09:05 UTC

Note

🔒 Integrity filter blocked 13 items

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

• #18480 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #22914 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #19703 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #21306 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #21403 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #20508 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #20514 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #21188 search_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".
• #20717 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".
• #18992 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #20207 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 · ● 1M · ◷

• expires on Apr 10, 2026, 9:10 AM UTC