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/adapters/claude-local.md

@@ -0,0 +1,59 @@
+---
+title: Claude Local
+summary: Claude Code local adapter setup and configuration
+---
+
+# Claude Local Adapter
+
+The `claude_local` adapter runs Anthropic's Claude Code CLI locally. It supports session persistence, skills injection, and structured output parsing.
+
+## Prerequisites
+
+- Claude Code CLI installed (`claude` command available)
+- `ANTHROPIC_API_KEY` set in the environment or agent config
+
+## Configuration Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `cwd` | string | Yes | Working directory for the agent process |
+| `model` | string | No | Claude model to use (e.g. `claude-opus-4-6`) |
+| `promptTemplate` | string | No | Prompt for resumed sessions |
+| `bootstrapPromptTemplate` | string | No | Prompt for first run (no existing session) |
+| `env` | object | No | Environment variables (supports secret refs) |
+| `timeoutSec` | number | No | Process timeout (0 = no timeout) |
+| `graceSec` | number | No | Grace period before force-kill |
+| `maxTurnsPerRun` | number | No | Max agentic turns per heartbeat |
+| `dangerouslySkipPermissions` | boolean | No | Skip permission prompts (dev only) |
+
+## Prompt Templates
+
+Templates support `{{variable}}` substitution:
+
+| Variable | Value |
+|----------|-------|
+| `{{agentId}}` | Agent's ID |
+| `{{companyId}}` | Company ID |
+| `{{runId}}` | Current run ID |
+| `{{agent.name}}` | Agent's name |
+| `{{company.name}}` | Company name |
+
+## Session Persistence
+
+The adapter persists Claude Code session IDs between heartbeats. On the next wake, it resumes the existing conversation so the agent retains full context.
+
+Session resume is cwd-aware: if the agent's working directory changed since the last run, a fresh session starts instead.
+
+If resume fails with an unknown session error, the adapter automatically retries with a fresh session.
+
+## Skills Injection
+
+The adapter creates a temporary directory with symlinks to Paperclip skills and passes it via `--add-dir`. This makes skills discoverable without polluting the agent's working directory.
+
+## Environment Test
+
+Use the "Test Environment" button in the UI to validate the adapter config. It checks:
+
+- Claude CLI is installed and accessible
+- Working directory exists and is valid
+- API key is configured (warning if missing)