Plan 16 — Docs site + adapter quickstart

[carlomigueldy]

Plan file: docs/superpowers/plans/2026-05-23-plan-16-docs-site-and-adapter-quickstart.md
Tag at close: v0.0.16-plan-16
Depends on: Plan 02 (adapter SDK)

Goal

Stand up the public docs site (docs.dycode.dev) and ship an end-to-end 'Write your first adapter in 15 minutes' tutorial. The site is the public contract for community contributors — without it, the plugin-first promise of spec §0 doesn't land.

Deliverable

• apps/docs-site package (Astro 5 + Tailwind matching the app's oklch theme).
• Diataxis layout: tutorials + how-to + reference + explanation.
• Auto-generated API reference from @dycode/adapter-sdk + @dycode/contracts via typedoc.
• Vercel deploy on push to main; custom domain wiring.
• F102–F107.

Out of scope (deferred to later plans)

• Localization → out of scope for v1
• Versioned docs → not needed in v1 (single major)
• Marketplace gallery UI → out of scope

Workflow

• Branch from main via superpowers:using-git-worktrees: feat/plan-16-docs-site-and-adapter-quickstart.
• One PR closes this issue — include Closes #<this issue's number> in the PR description.
• Update docs/superpowers/plans/README.md to move this plan from "not started" to "shipped" in the same PR.
• Final step is the close-out commit and git tag v0.0.16-plan-16.
• All 5 quality gates apply (CONTRIBUTING.md).