docs: sync docs and skills updates from backup branch

2026-03-02 16:44:10 -06:00
parent 8ee063c4e5
commit cabd16bc70
60 changed files with 209 additions and 246 deletions
--- a/docs/deploy/database.md
+++ b/docs/deploy/database.md
@@ -3,8 +3,6 @@ title: Database
 summary: Embedded PGlite vs Docker Postgres vs hosted
 ---

-# Database
-
 Paperclip uses PostgreSQL via Drizzle ORM. There are three ways to run the database.

 ## 1. Embedded PostgreSQL (Default)
--- a/docs/deploy/deployment-modes.md
+++ b/docs/deploy/deployment-modes.md
@@ -3,8 +3,6 @@ title: Deployment Modes
 summary: local_trusted vs authenticated (private/public)
 ---

-# Deployment Modes
-
 Paperclip supports two runtime modes with different security profiles.

 ## `local_trusted`
--- a/docs/deploy/docker.md
+++ b/docs/deploy/docker.md
@@ -3,8 +3,6 @@ title: Docker
 summary: Docker Compose quickstart
 ---

-# Docker
-
 Run Paperclip in Docker without installing Node or pnpm locally.

 ## Compose Quickstart (Recommended)
--- a/docs/deploy/environment-variables.md
+++ b/docs/deploy/environment-variables.md
@@ -3,8 +3,6 @@ title: Environment Variables
 summary: Full environment variable reference
 ---

-# Environment Variables
-
 All environment variables that Paperclip uses for server configuration.

 ## Server Configuration
--- a/docs/deploy/local-development.md
+++ b/docs/deploy/local-development.md
@@ -3,8 +3,6 @@ title: Local Development
 summary: Set up Paperclip for local development
 ---

-# Local Development
-
 Run Paperclip locally with zero external dependencies.

 ## Prerequisites
--- a/docs/deploy/overview.md
+++ b/docs/deploy/overview.md
@@ -3,8 +3,6 @@ title: Deployment Overview
 summary: Deployment modes at a glance
 ---

-# Deployment Overview
-
 Paperclip supports three deployment configurations, from zero-friction local to internet-facing production.

 ## Deployment Modes
--- a/docs/deploy/secrets.md
+++ b/docs/deploy/secrets.md
@@ -3,8 +3,6 @@ title: Secrets Management
 summary: Master key, encryption, and strict mode
 ---

-# Secrets Management
-
 Paperclip encrypts secrets at rest using a local master key. Agent environment variables that contain sensitive values (API keys, tokens) are stored as encrypted secret references.

 ## Default Provider: `local_encrypted`
--- a/docs/deploy/storage.md
+++ b/docs/deploy/storage.md
@@ -3,8 +3,6 @@ title: Storage
 summary: Local disk vs S3-compatible storage
 ---

-# Storage
-
 Paperclip stores uploaded files (issue attachments, images) using a configurable storage provider.

 ## Local Disk (Default)