docs: add external documentation site content

Add structured documentation covering quickstart, architecture, core
concepts, API reference, adapter guides, CLI commands, deployment
options, and operator/developer guides.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

docs/deploy/local-development.md

@@ -0,0 +1,92 @@
+---
+title: Local Development
+summary: Set up Paperclip for local development
+---
+
+# Local Development
+
+Run Paperclip locally with zero external dependencies.
+
+## Prerequisites
+
+- Node.js 20+
+- pnpm 9+
+
+## Start Dev Server
+
+```sh
+pnpm install
+pnpm dev
+```
+
+This starts:
+
+- **API server** at `http://localhost:3100`
+- **UI** served by the API server in dev middleware mode (same origin)
+
+No Docker or external database required. Paperclip uses embedded PostgreSQL automatically.
+
+## One-Command Bootstrap
+
+For a first-time install:
+
+```sh
+pnpm paperclip run
+```
+
+This does:
+
+1. Auto-onboards if config is missing
+2. Runs `paperclip doctor` with repair enabled
+3. Starts the server when checks pass
+
+## Tailscale/Private Auth Dev Mode
+
+To run in `authenticated/private` mode for network access:
+
+```sh
+pnpm dev --tailscale-auth
+```
+
+This binds the server to `0.0.0.0` for private-network access.
+
+Allow additional private hostnames:
+
+```sh
+pnpm paperclip allowed-hostname dotta-macbook-pro
+```
+
+## Health Checks
+
+```sh
+curl http://localhost:3100/api/health
+# -> {"status":"ok"}
+
+curl http://localhost:3100/api/companies
+# -> []
+```
+
+## Reset Dev Data
+
+To wipe local data and start fresh:
+
+```sh
+rm -rf ~/.paperclip/instances/default/db
+pnpm dev
+```
+
+## Data Locations
+
+| Data | Path |
+|------|------|
+| Config | `~/.paperclip/instances/default/config.json` |
+| Database | `~/.paperclip/instances/default/db` |
+| Storage | `~/.paperclip/instances/default/data/storage` |
+| Secrets key | `~/.paperclip/instances/default/secrets/master.key` |
+| Logs | `~/.paperclip/instances/default/logs` |
+
+Override with environment variables:
+
+```sh
+PAPERCLIP_HOME=/custom/path PAPERCLIP_INSTANCE_ID=dev pnpm paperclip run
+```