published Aug 23, 2026, 7:19 PM · updated Aug 25, 2026, 7:24 PM
Summary
Recommended next actions:
- Fix broken relative markdown links in
.github/aw/*.md— most point to real files but are missing parentheses (e.g.[safe-outputs-runtime.md]safe-outputs-runtime.mdinstead of[safe-outputs-runtime.md](safe-outputs-runtime.md)). - Fix the one genuinely broken link:
.github/aw/runbooks/README.mdlinks toworkflow-health.md, but the file lives at.github/aw/runbooks/workflow-health.md(relative path should resolve fine within the same folder — verify link renders correctly relative toREADME.md's own directory). - Add
description:frontmatter to 8 spec files missing it:campaign.md,designer-mappings.md,github-mcp-server-pagination.md,github-mcp-server-tools.md,github-mcp-server.md,instructions.md,serena-tool.md,test-expression.md.
Full Findings
Broken cross-references (malformed [text](file.md) markdown link syntax — missing parens around URL):
[safe-outputs-runtime.md]safe-outputs-runtime.md[syntax-engine.md]syntax-engine.md[configure-agentic-engine.md]configure-agentic-engine.md[jobs.md]jobs.md[reuse.md]reuse.md[skills.md]skills.md[subagents.md]subagents.md(x2 occurrences)[syntax-tools-imports.md]syntax-tools-imports.md[token-optimization.md]token-optimization.md[designer-mappings.md]designer-mappings.md
Note: all of the above target files exist under .github/aw/; the issue is malformed markdown link syntax (concatenated instead of ](), not missing targets.
External links flagged by the naive scan (not actually broken — absolute GitHub URLs, expected to not resolve locally):
.github/workflows/shared/{aider,cursor,goose,kiro,opencode}.md(external repo links)docs/src/content/docs/patterns/data-ops.md(external repo link)githubnext/agentics/blob/main/workflows/repo-assist.md(external repo link)
Genuine link needing verification:
.github/aw/runbooks/README.mdreferencesworkflow-health.md; file exists at.github/aw/runbooks/workflow-health.md(same directory as README.md), so link should be valid — confirm rendering.
Files missing description: frontmatter:
.github/aw/campaign.md.github/aw/designer-mappings.md.github/aw/github-mcp-server-pagination.md.github/aw/github-mcp-server-tools.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/docs gaps (5 most recent, title content withheld due to integrity policy filtering):
Generated by 🧭 Daily Spec Coverage Review · auto · 17.7 AIC · ⌖ 4.62 AIC · ⊞ 6.8K · ◷
- expires on Aug 25, 2026, 11:19 AM UTC-08:00