[awf-feature-surfacing] Sync checkout multi-mode guidance across frontmatter references #68861

Overview

Runtime repository lists now require literal checkout.multi: true. The checkout guide explains this, but the generated full frontmatter reference still describes the former allowed-repos trigger and says ordinary repository expressions require an allowlist. That can lead authors to write workflows with the wrong checkout behavior.

Key issue and priority

• P1 — Correct the contradictory reference: Regenerate docs/src/content/docs/reference/frontmatter-full.md from the current schema with make generate-schema-docs. Confirm it lists multi and states that allowed-repos alone does not activate list expansion; single-repository expressions need no allowlist or non-root path prefix.
• P2 — Improve the compact syntax entry: Add repo, multi, allowed-repos, max-repos, and allow-private-repos to the checkout field summary in .github/aw/syntax-agentic.md, with a link to the full checkout guide and one short list example.
• P2 — Prevent drift: Add a focused check that the generated frontmatter reference is current when schema descriptions change.

Next action

Update the generated and compact references together, then verify their single-versus-multi examples against the current compiler.

Generated by 🧭 Daily AWF Spec Compiler Surfacing Review · codex · gpt60 · 102.1 AIC · ⌖ 5.92 AIC · ⊞ 14.1K · ◷

• expires on Oct 21, 2026, 2:29 PM UTC-08:00