docs: re-include docs in workspaces with hoisted linker

Switch from isolated to hoisted Bun linker via bunfig.toml so Docus
can be built as a workspace member. Bun 1.3.2+ defaults to isolated
linker for new workspaces, which puts Docus's raw .ts server files
under .bun/ symlinks where Nitro's rollup-plugin-inject fails.

Updates ADR-0001 with the resolution and CLAUDE.md gotchas.

Author: amondnet

CLAUDE.md

@@ -42,6 +42,17 @@ Monorepo providing shared code style configurations for PleaseAI projects.
 - Config: `release-please-config.json` + `.release-please-manifest.json`
 - Publishing: GitHub Actions workflow publishes to npm on release
 
+## Docs Site
+
+- Located at `docs/` — Docus (Nuxt) deployed to Cloudflare Pages
+- Bun workspace member; build works because of `bunfig.toml` hoisted linker (see Gotchas)
+- Build: `cd docs && bun run build` → outputs to `docs/dist/`
+- Deploy: `cd docs && bun run deploy` (wrangler)
+- ADR: `docs/adr/0001-choose-documentation-framework.md`
+
 ## Gotchas
 
 - `packages/perttier-config` directory is intentionally(?) misspelled — do not rename without coordinating release-please config, CI workflows, and npm package name
+- `bunfig.toml` sets `linker = "hoisted"` — required for Docus to build. Bun 1.3.2+ defaults to `isolated` linker in workspaces, which puts Docus's raw `.ts` server files under `.bun/` symlinks where Nitro's `rollup-plugin-inject` chokes on them. Hoisted linker (npm-style flat `node_modules`) avoids this.
+- Docs build requires `mcp: { enabled: false }` in `docs/nuxt.config.ts` — `@nuxtjs/mcp-toolkit` imports `agents/mcp` (Cloudflare Workers AI Agents) which breaks the `cloudflare_pages` preset.
+- Docus `cloudflare_pages` preset outputs to `dist/`, not `.output/public/` — `wrangler.jsonc` `pages_build_output_dir` must match.