macOS Docs Site Builder

Build a single-file HTML documentation site with macOS-inspired design system. Output is a self-contained .html file (no JS libraries, no build step).

WHAT

Purpose và context

• Purpose: dựng một docs site HTML tự chứa (một file, hoặc index + N trang) theo design system macOS liquid-glass — sidebar kính, mind map, sơ đồ SVG động kéo-thả được, theme sáng/tối — ghi vào llmwiki/html/, tự host để xem trước, và chỉ báo "xong" sau khi Playwright audit PASS.
• Trigger (when to use):
  • User muốn docs site, landing page, showcase, portfolio, guide, tutorial site, feature overview hoặc product documentation — nhất là khi nói "clean", "modern", "Apple-like", "macOS style", "glass", "frosted", "animated diagrams", "single HTML file".
  • Yêu cầu "liquid glass", "frosted glass", "translucent UI" cho trang docs/showcase.
  • User có nhiều file markdown và muốn render thành một trang HTML trực quan có section.
  • User nói "6 file" / muốn trang riêng cho từng chủ đề → Multi-File Mode (một HTML cho mỗi file wiki + DDMMYY-index.html), KHÔNG gộp một trang.
• Non-goals: không tự viết lại CSS/JS theme toggle (nguồn duy nhất là skill dark-mode-maker); không chép SVG của sơ đồ do engine archify vẽ ra ngoài (nhúng <iframe>); không kéo CDN/webfont/script ngoài; không ghi file ra ngoài llmwiki/html/; không giữ/commit script hay ảnh chụp audit.

Mental model

nội dung nguồn (markdown · wiki · mô tả) → N section (#sec-{i}, accent i % 6) → Page Architecture (skip-link · nav sidebar · main · hero · mind map · section · footer) → HTML tự chứa llmwiki/html/DDMMYY-<slug>.html → Auto-Host :8765 → Playwright Audit → Output Report draft.