The aw-compat audit (#27312) identifies a recurring error: non-gh-aw documentation .md files placed in .github/workflows/ cause the gh-aw compiler to emit "no frontmatter found" for each one. This accounts for a significant portion of the 4/20 failing repos in today's compat audit (#27310). The root cause is that the parser scans all files in .github/workflows/ without filtering by extension or frontmatter presence.
The fix is to add an extension guard in the workflow file discovery logic: only process files matching *.yml / *.yaml (or files that begin with the gh-aw frontmatter block), silently skipping .md and other non-workflow files.
Expected Impact: Removes a false-positive error class from the compat audit, reduces the failing-repo count from 4 to approximately 2, and eliminates a confusing CI error message for repo maintainers.
Suggested Agent: General-purpose coding agent (Go/YAML)
Estimated Effort: Quick (< 1 hour) — a small guard clause in the file discovery code.
Data Source: DeepReport Intelligence Briefing 2026-04-20 (§24673982657); aw-compat issues #27310, #27312.
Generated by DeepReport - Intelligence Gathering Agent · ● 375K · ◷
The
aw-compataudit (#27312) identifies a recurring error: non-gh-aw documentation.mdfiles placed in.github/workflows/cause the gh-aw compiler to emit"no frontmatter found"for each one. This accounts for a significant portion of the 4/20 failing repos in today's compat audit (#27310). The root cause is that the parser scans all files in.github/workflows/without filtering by extension or frontmatter presence.The fix is to add an extension guard in the workflow file discovery logic: only process files matching
*.yml/*.yaml(or files that begin with the gh-aw frontmatter block), silently skipping.mdand other non-workflow files.Expected Impact: Removes a false-positive error class from the compat audit, reduces the failing-repo count from 4 to approximately 2, and eliminates a confusing CI error message for repo maintainers.
Suggested Agent: General-purpose coding agent (Go/YAML)
Estimated Effort: Quick (< 1 hour) — a small guard clause in the file discovery code.
Data Source: DeepReport Intelligence Briefing 2026-04-20 (§24673982657); aw-compat issues #27310, #27312.