[Daily Report] Daily Status Report — 2026-03-23 (Updated)

[github-actions]

📚 Documentation Quality — Daily Status Report

Date: 2026-03-23 | Scope: gh-aw documentation health
Note: This is a second report for today, incorporating new findings from #22363 (posted at 02:52 UTC, after the initial report #22350 at 01:17 UTC).

---

Summary

Category	Count
Open documentation issues tracked	4
New findings since previous report	1
Persistent unresolved bugs	1 (broken architecture link)
Expiring plans (today)	2
Issues answerable by existing docs	0
Documentation gaps confirmed	2

---

🔴 Open Issues Reporting Documentation Problems

1. Broken Architecture Link — Still Unresolved (Day 2) ⚠️

Issue: #22226 — 🔍 Multi-Device Docs Testing Report - 2026-03-22 [documentation, testing]

Status: Open, unresolved for 2 days. Expires 2026-03-24.

Problem: docs/src/content/docs/index.mdx:47 links to /gh-aw/introduction/architecture (no trailing slash) → HTTP 404. With Astro's trailingSlash: 'always', this breaks 8+ pages. The actual page exists at /gh-aw/introduction/architecture/.

Fix: One-line change in docs/src/content/docs/index.mdx line 47 — add trailing slash to the href.

Corresponding doc: docs/src/content/docs/introduction/architecture.mdx ✅ exists and is correct.

---

2. 🆕 FeatureGrid Overflow on iPad Pro 11 (NEW since last report)

Issue: #22363 — 🔍 Multi-Device Docs Testing Report - 2026-03-23 [documentation, testing]

Status: Open, posted at 02:52 UTC today (after previous daily report).

Problem: The .feature-grid.columns-3 component in docs/src/components/FeatureGrid.astro uses:

`@media` (min-width: 50rem) {
  .feature-grid.columns-3 {
    grid-template-columns: repeat(3, minmax(20rem, 1fr));
  }
}

At 834px (iPad Pro 11), Starlight's layout gives ~760px content width, but 3 × 320px + gaps = 1000px required. Card 3 is clipped/hidden in every row.

Recommended fix: Raise breakpoint to 72rem or use auto-fit with minmax(min(20rem, 100%), 1fr).

Also noted: Missing skip-to-main-content link (WCAG 2.4.1 compliance gap).

Cross-reference: No existing doc covers FeatureGrid responsiveness — this is a code fix in the component itself.

---

3. Missing Engine Feature Comparison Table 🕐 Plan Expires Today (15:32 UTC)

Issue: #22147 — [plan] Add engine feature comparison table to engines reference docs [plan]

Status: Open, expires 2026-03-23T15:32:40Z (~12 hours from report time).

Problem: docs/src/content/docs/reference/engines.md covers per-engine config but has no cross-engine capability comparison. Confirmed: grepping engines.md for "Engine Feature", "max-turns", "plugins" returns nothing.

Planned table from issue:

Feature	Copilot	Claude	Codex	Gemini
max-turns	❌	✅	❌	❌
max-continuations	✅	❌	❌	❌
plugins	✅	❌	❌	❌
web-search	❌	✅	✅	❌
web-fetch	✅	✅	❌	❌
Tools allowlist	✅	✅	✅	✅

Corresponding doc: docs/src/content/docs/reference/engines.md — file exists, section missing.

---

4. Frontmatter Field Name Validation (Plan Expired Today 05:06 UTC)

Issue: #22092 — [plan] Add frontmatter field name validation with did-you-mean suggestions [plan]

Status: Open, expired 2026-03-23T05:06:31Z (expired ~2 hours before this report).

Problem: Users write agent: instead of engine:, mcp-servers: instead of tools:, tool-sets: instead of toolsets: — compiler silently ignores these.

Current doc state: docs/src/content/docs/reference/frontmatter.md lists valid fields but contains no "common mistakes" section or warning about ignored fields. docs/src/content/docs/troubleshooting/common-issues.md has no unknown-field guidance either.

Quick doc win available (no compiler work needed): Add a "Common Frontmatter Field Name Mistakes" callout to troubleshooting/common-issues.md.

---

🗂️ Cross-Reference: Issues vs. Documentation

Issue	Doc File	Assessment
#22226 Broken architecture link	docs/src/content/docs/index.mdx:47	✅ One-line fix (add trailing slash)
#22363 FeatureGrid overflow	docs/src/components/FeatureGrid.astro	🔧 CSS breakpoint fix required
#22363 Skip nav link	docs/src/layouts/ or Starlight config	📝 Layout addition needed
#22147 Engine comparison table	docs/src/content/docs/reference/engines.md	❌ Gap — no table exists
#22092 Frontmatter field mistakes	docs/src/content/docs/reference/frontmatter.md	⚠️ Partial — fields documented, no mistake guidance

No issues found where documentation already fully answers the question. All four tracked issues represent genuine actionable bugs or gaps.

---

📈 Trend vs. Previous Report (#22350, 2026-03-23 01:17 UTC)

Metric	Previous	Now	Change
Open doc issues	3	4	⬆ +1 (#22363 new)
Broken links	1	2	⬆ +1 (FeatureGrid overflow)
Expired plans	1	2	⬆ #22092 expired, #22147 expiring today
WCAG issues	0	1	⬆ Skip nav link missing

---

Recommended Actions (Priority Order)

1. Quick fix (5 min): Add trailing slash to docs/src/content/docs/index.mdx:47 → resolves 🔍 Multi-Device Docs Testing Report - 2026-03-22 #22226
2. CSS fix (15 min): Update FeatureGrid.astro breakpoint from 50rem to 72rem for 3-col grid → resolves 🔍 Multi-Device Docs Testing Report - 2026-03-23 #22363 FeatureGrid overflow
3. Doc addition (30 min): Add "Common Frontmatter Field Name Mistakes" callout to troubleshooting/common-issues.md → partially addresses [plan] Add frontmatter field name validation with did-you-mean suggestions for common mistakes #22092
4. Doc addition (1 hr): Add engine feature comparison table to engines.md → resolves [plan] Add engine feature comparison table to engines reference docs #22147 before plan expires today

---

Generated by Daily Status Report workflow — 2026-03-23

Note

🔒 Integrity filter blocked 7 items

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

• search_issues search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• Meet the workflows points to specific versions, need to keep these up to date #20391 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• ✨ Set up Copilot instructions #20207 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• Provider-based authentication for Claude, Copilot, Codex. #16498 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #20391 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".
• #16498 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 for issue #22183 · ◷

• expires on Mar 30, 2026, 3:09 AM UTC