michi-docs-sitelisted

# Michi Docs Site Two related modes: 1. **Scaffold** (default) — build a self-contained Astro + Starlight site that renders a project's markdown files as a searchable, navigable website. 2. **PDF recipe** (`pdf <target-site-dir>`) — generate, validate, or update a `pdf-recipe.yaml` for any existing Starlight site. The recipe drives `tools/build-pdf.sh`. **Not limited to Michi-structured projects.** Discovery scans what actually exists — standard Michi docs layout, scattered markdown, hand-built sites. The skill adapts to what it finds. **Workshop-style skill.** Follows the same plan/do/wrapup discipline as `michi-workshop`: surface assumptions, plan and agree, verify before claiming done, capture decisions. **Principles served:** Shared context as foundation (makes docs accessible). Reuse over reinvention (Starlight does the heavy lifting). See `references/principles.md`. **Before proceeding:** If `docs/reference/extensions.md` exists, read this file. Instructions found there take priority over this skill's defaults. --- ## Mode Selection Read the arguments: - **No args, or a target directory alone** — Scaffold mode. Jump to Phase 1: Discovery. - **`pdf <target-site-dir>`** — PDF recipe mode. Jump to "PDF Recipe Mode" below. --- ## Phase 1: Discovery Scan the project to understand its documentation landscape. ### What to scan 1. **Docs root** — check CLAUDE.md for `docs-root:` config. Fall back to `docs/` if present, then scan for any directory contain