[spec-coverage] Daily Spec Coverage Report — 31736178205

[github-actions]

Summary

Recommended next actions:

1. Fix the stale relative link [safe-outputs-runtime.md]safe-outputs-runtime.md — likely a markdown formatting typo (missing parens) in syntax-agentic.md.
2. Fix malformed links [reuse.md]reuse.md, [subagents.md]subagents.md, [syntax-tools-imports.md]syntax-tools-imports.md, [token-optimization.md]token-optimization.md — these are false positives from the grep pattern (files exist), but worth spot-checking link syntax consistency.
3. Fix the dead external DataOps link in token-optimization.md (line 382): it points to docs/src/content/docs/patterns/data-ops.md, which does not exist. The closest matching pattern doc is docs/src/content/docs/patterns/deterministic-ops.md or batch-ops.md — verify intended target and update the link.
4. Add description: front matter to 7 spec files missing it: campaign.md, designer-mappings.md, github-mcp-server-pagination.md, github-mcp-server.md, instructions.md, serena-tool.md, test-expression.md.
5. Issue search for "spec"/"docs" gap reports was blocked by integrity policy (results filtered as below-required trust level) — a human should manually review recent issues in github/gh-aw for spec/docs gap reports.

Full Findings

Broken/stale cross-references (from link scan of .github/aw/*.md, excluding imports/):

• .github/aw/syntax-agentic.md: [safe-outputs-runtime.md]safe-outputs-runtime.md — malformed link syntax (missing outer parens), though target file exists.
• .github/aw/token-optimization.md (line 382): https://github.com/github/gh-aw/blob/main/docs/src/content/docs/patterns/data-ops.md — target file does not exist in docs/src/content/docs/patterns/ (only batch-ops.md, central-repo-ops.md, chat-ops.md, deterministic-ops.md, dispatch-ops.md, issue-ops.md, label-ops.md, memory-ops.md, monitor-ops.md, multi-repo-ops.md, orchestration.md, orchestrator-ops.md, project-ops.mdx, research-plan-assign-ops.md, spec-ops.md, workqueue-ops.md exist).
• Other apparent "BROKEN" hits (reuse.md, subagents.md, syntax-tools-imports.md, token-optimization.md, designer-mappings.md, workflow-health.md) were false positives of the naive grep regex (malformed capture of adjacent text) — manual verification confirmed all target files exist (including .github/aw/runbooks/workflow-health.md, referenced correctly from .github/aw/runbooks/README.md).
• External shared-engine links (shared/aider.md, shared/cursor.md, shared/goose.md, shared/kiro.md, shared/opencode.md) in configure-agentic-engine.md all resolve correctly to existing files under .github/workflows/shared/.
• https://github.com/githubnext/agentics/blob/main/workflows/repo-assist.md is an external upstream repo link — not verifiable from this repo checkout; not flagged as broken.

Spec files missing description: front matter:

• .github/aw/campaign.md
• .github/aw/designer-mappings.md
• .github/aw/github-mcp-server-pagination.md
• .github/aw/github-mcp-server.md
• .github/aw/instructions.md
• .github/aw/serena-tool.md
• .github/aw/test-expression.md

Open issues mentioning spec gaps:

Search via search_issues (query: "spec OR docs", github/gh-aw, open, sorted by creation date) returned candidate issues, but all 5 top hits were filtered by integrity policy ("lower integrity than agent requires") and could not be read: #52534, #52524, #52493, #52435, #52347. No titles or content could be safely retrieved. Manual review recommended.

Generated by 🧭 Daily Spec Coverage Review · auto · 24.6 AIC · ⌖ 2.12 AIC · ⊞ 6.3K · ◷

• expires on Aug 15, 2026, 11:35 AM UTC-08:00

[github-actions]

This issue is being closed as outdated. A newer issue has been created: #52780

View newer issue

---

This action was performed automatically by the Daily Spec Coverage Review workflow.