LCDL handbook UX go-live checklist

Automated (local)

From forge-lcdl:

python3 scripts/audit_docs_site.py --strict
python3 scripts/audit_docs_site.py --ux-warnings
python3 scripts/audit_contract_docs.py --strict --strict-md
python -m compileall -q src tests scripts examples
pytest -q tests/docs tests/reference tests/examples

From forge-lcdl-website (submodule forge-lcdl up to date, or --content-root to sibling checkout):

python3 generator/build-site.py --link-check
python3 scripts/check-generated-site.py --strict-diagrams --verify-rendered-diagrams
python3 scripts/inspect_handbook_html.py website/index.html

Desktop navigation

• [ ] Sticky top bar shows Start, Learn, Build, Reference, Enterprise, Agents, Contribute
• [ ] Run first task and Task catalog CTAs resolve
• [ ] Each dropdown opens on click / keyboard and lists expected links
• [ ] Sidebar shows only the active section (not the full handbook tree)
• [ ] Contract slugs (src-forge_lcdl-contracts-…) do not appear in the desktop sidebar on home

Mobile

• [ ] Hamburger opens offcanvas; primary sections accordion appears above the section rail
• [ ] Offcanvas closes without trapping focus (spot-check with Tab)

Content spots

• [ ] Home reads as product docs (hero + next actions), not package README
• [ ] Task catalog page loads and links to at least one contract HTML page
• [ ] Tutorial 101 / 201 / 301 indexes still reach lesson HTML

Accessibility (spot)

• [ ] Skip link reaches #main
• [ ] Visible focus on dropdown toggles and sidebar accordion buttons

Hosting

• [ ] Firebase project lcdl-542d8 — see Website publishing
• [ ] After deploy, load https://lcdl.forgesdlc.com and repeat desktop + mobile spot checks