[aw-failures] [aw-fix] P1: Documentation Unbloat build fails — missing generated workshop markdown (src/generated/workshop-markd [Content truncated due to length] #46482

Generate the workshop markdown before the docs build (or guard the /workshop route) — the astro build aborts because src/generated/workshop-markdown/00-welcome.md is missing, failing the whole workflow with exit 1.

The Documentation Unbloat workflow's post-agent Build documentation step crashes rendering the /workshop route. This is a build-pipeline ordering/generation defect in the same workshop area as recent commit 29ad28e (#46444, "Restore entry-path card rendering in workshop experience").

Affected workflow and run

Probable root cause

The astro build for /workshop requires generated markdown files in src/generated/workshop-markdown/, but the generation step that populates that directory either did not run or produced no output before npm run build, so the page renderer throws and the build exits 1. A generic auto-failure issue ("[aw] Documentation Unbloat failed") was opened by the workflow, but it carries no root cause.

16:43:08 [ERROR] Error: Missing generated workshop markdown for 00-welcome.md. Expected to find it in src/generated/workshop-markdown/.
16:43:08 [ERROR] [build] Caught error rendering /workshop: Error: Missing generated workshop markdown for 00-welcome.md. Expected to find it in src/generated/workshop-markdown/.
##[error]Process completed with exit code 1.

Proposed remediation

1. Ensure the workshop-markdown generation step runs (and produces src/generated/workshop-markdown/*.md) as a prerequisite of the docs Build documentation step — verify it is wired into the build script / CI ordering after Restore entry-path card rendering in workshop experience #46444.
2. Alternatively, make the /workshop route degrade gracefully (skip/placeholder) when generated markdown is absent, so a missing artifact does not hard-fail the entire site build.
3. Add a fast pre-build check that fails early with a clear message if src/generated/workshop-markdown/ is empty.

Success criteria

• npm run build (Build documentation step) completes successfully with the /workshop route rendered.
• Documentation Unbloat run reaches conclusion: success (or fails only on genuine content issues, not a missing build artifact).

Parent: #46171
Related to #46171

Generated by 🔍 [aw] Failure Investigator (6h) · 250.5 AIC · ⌖ 39.3 AIC · ⊞ 5.2K · ◷

• expires on Jul 25, 2026, 11:24 AM UTC-08:00