docs: sync docs and skills updates from backup branch

docs/adapters/claude-local.md

@@ -3,8 +3,6 @@ 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
@@ -18,8 +16,7 @@ The `claude_local` adapter runs Anthropic's Claude Code CLI locally. It supports
 |-------|------|----------|-------------|
 | `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) |
+| `promptTemplate` | string | No | Prompt used for all runs |
 | `env` | object | No | Environment variables (supports secret refs) |
 | `timeoutSec` | number | No | Process timeout (0 = no timeout) |
 | `graceSec` | number | No | Grace period before force-kill |

docs/adapters/codex-local.md

@@ -3,8 +3,6 @@ title: Codex Local
 summary: OpenAI Codex local adapter setup and configuration
 ---
 
-# Codex Local Adapter
-
 The `codex_local` adapter runs OpenAI's Codex CLI locally. It supports session persistence via `previous_response_id` chaining and skills injection through the global Codex skills directory.
 
 ## Prerequisites
@@ -18,8 +16,7 @@ The `codex_local` adapter runs OpenAI's Codex CLI locally. It supports session p
 |-------|------|----------|-------------|
 | `cwd` | string | Yes | Working directory for the agent process |
 | `model` | string | No | Model to use |
-| `promptTemplate` | string | No | Prompt for resumed sessions |
-| `bootstrapPromptTemplate` | string | No | Prompt for first run |
+| `promptTemplate` | string | No | Prompt used for all runs |
 | `env` | object | No | Environment variables (supports secret refs) |
 | `timeoutSec` | number | No | Process timeout (0 = no timeout) |
 | `graceSec` | number | No | Grace period before force-kill |

docs/adapters/creating-an-adapter.md

@@ -3,8 +3,6 @@ title: Creating an Adapter
 summary: Guide to building a custom adapter
 ---
 
-# Creating an Adapter
-
 Build a custom adapter to connect Paperclip to any agent runtime.
 
 ## Package Structure

docs/adapters/http.md

@@ -3,8 +3,6 @@ title: HTTP Adapter
 summary: HTTP webhook adapter
 ---
 
-# HTTP Adapter
-
 The `http` adapter sends a webhook request to an external agent service. The agent runs externally and Paperclip just triggers it.
 
 ## When to Use

docs/adapters/overview.md

@@ -3,8 +3,6 @@ title: Adapters Overview
 summary: What adapters are and how they connect agents to Paperclip
 ---
 
-# Adapters Overview
-
 Adapters are the bridge between Paperclip's orchestration layer and agent runtimes. Each adapter knows how to invoke a specific type of AI agent and capture its results.
 
 ## How Adapters Work

docs/adapters/process.md

@@ -3,8 +3,6 @@ title: Process Adapter
 summary: Generic shell process adapter
 ---
 
-# Process Adapter
-
 The `process` adapter executes arbitrary shell commands. Use it for simple scripts, one-shot tasks, or agents built on custom frameworks.
 
 ## When to Use

docs/agents-runtime.md

@@ -65,8 +65,7 @@ For local adapters, set:
 
 You can set:
 
-- `bootstrapPromptTemplate`: used for first run/new session
-- `promptTemplate`: used for subsequent resumed runs
+- `promptTemplate`: used for every run (first run and resumed sessions)
 
 Templates support variables like `{{agent.id}}`, `{{agent.name}}`, and run context values.
 

docs/api/activity.md

@@ -3,8 +3,6 @@ title: Activity
 summary: Activity log queries
 ---
 
-# Activity API
-
 Query the audit trail of all mutations across the company.
 
 ## List Activity

docs/api/agents.md

@@ -3,8 +3,6 @@ title: Agents
 summary: Agent lifecycle, configuration, keys, and heartbeat invocation
 ---
 
-# Agents API
-
 Manage AI agents (employees) within a company.
 
 ## List Agents

docs/api/approvals.md

@@ -3,8 +3,6 @@ title: Approvals
 summary: Approval workflow endpoints
 ---
 
-# Approvals API
-
 Approvals gate certain actions (agent hiring, CEO strategy) behind board review.
 
 ## List Approvals

docs/api/authentication.md

@@ -3,8 +3,6 @@ title: Authentication
 summary: API keys, JWTs, and auth modes
 ---
 
-# Authentication
-
 Paperclip supports multiple authentication methods depending on the deployment mode and caller type.
 
 ## Agent Authentication

docs/api/companies.md

@@ -3,8 +3,6 @@ title: Companies
 summary: Company CRUD endpoints
 ---
 
-# Companies API
-
 Manage companies within your Paperclip instance.
 
 ## List Companies

docs/api/costs.md

@@ -3,8 +3,6 @@ title: Costs
 summary: Cost events, summaries, and budget management
 ---
 
-# Costs API
-
 Track token usage and spending across agents, projects, and the company.
 
 ## Report Cost Event

docs/api/dashboard.md

@@ -3,8 +3,6 @@ title: Dashboard
 summary: Dashboard metrics endpoint
 ---
 
-# Dashboard API
-
 Get a health summary for a company in a single call.
 
 ## Get Dashboard

docs/api/goals-and-projects.md

@@ -3,8 +3,6 @@ title: Goals and Projects
 summary: Goal hierarchy and project management
 ---
 
-# Goals and Projects API
-
 Goals define the "why" and projects define the "what" for organizing work.
 
 ## Goals

docs/api/issues.md

@@ -3,8 +3,6 @@ title: Issues
 summary: Issue CRUD, checkout/release, comments, and attachments
 ---
 
-# Issues API
-
 Issues are the unit of work in Paperclip. They support hierarchical relationships, atomic checkout, comments, and file attachments.
 
 ## List Issues

docs/api/overview.md

@@ -3,8 +3,6 @@ title: API Overview
 summary: Authentication, base URL, error codes, and conventions
 ---
 
-# API Overview
-
 Paperclip exposes a RESTful JSON API for all control plane operations.
 
 ## Base URL

docs/api/secrets.md

@@ -3,8 +3,6 @@ title: Secrets
 summary: Secrets CRUD
 ---
 
-# Secrets API
-
 Manage encrypted secrets that agents reference in their environment configuration.
 
 ## List Secrets

docs/cli/control-plane-commands.md

@@ -3,8 +3,6 @@ title: Control-Plane Commands
 summary: Issue, agent, approval, and dashboard commands
 ---
 
-# Control-Plane Commands
-
 Client-side commands for managing issues, agents, approvals, and more.
 
 ## Issue Commands
@@ -37,6 +35,24 @@ pnpm paperclip issue release <issue-id>
 ```sh
 pnpm paperclip company list
 pnpm paperclip company get <company-id>
+
+# Export to portable folder package (writes manifest + markdown files)
+pnpm paperclip company export <company-id> --out ./exports/acme --include company,agents
+
+# Preview import (no writes)
+pnpm paperclip company import \
+  --from https://github.com/<owner>/<repo>/tree/main/<path> \
+  --target existing \
+  --company-id <company-id> \
+  --collision rename \
+  --dry-run
+
+# Apply import
+pnpm paperclip company import \
+  --from ./exports/acme \
+  --target new \
+  --new-company-name "Acme Imported" \
+  --include company,agents
 ```
 
 ## Agent Commands

docs/cli/overview.md

@@ -3,8 +3,6 @@ title: CLI Overview
 summary: CLI installation and setup
 ---
 
-# CLI Overview
-
 The Paperclip CLI handles instance setup, diagnostics, and control-plane operations.
 
 ## Usage

docs/cli/setup-commands.md

@@ -3,8 +3,6 @@ title: Setup Commands
 summary: Onboard, run, doctor, and configure
 ---
 
-# Setup Commands
-
 Instance setup and diagnostics commands.
 
 ## `paperclip run`

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)

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`

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)

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

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

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

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`

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)

docs/docs.json

@@ -15,128 +15,122 @@
       "url": "https://github.com/paperclip-ai/paperclip"
     }
   ],
-  "tabs": [
-    { "tab": "Get Started", "url": "start" },
-    { "tab": "Guides", "url": "guides" },
-    { "tab": "Deploy", "url": "deploy" },
-    { "tab": "Adapters", "url": "adapters" },
-    { "tab": "API Reference", "url": "api" },
-    { "tab": "CLI", "url": "cli" }
-  ],
-  "navigation": [
-    {
-      "tab": "Get Started",
-      "groups": [
-        {
-          "group": "Introduction",
-          "pages": [
-            "start/what-is-paperclip",
-            "start/quickstart",
-            "start/core-concepts",
-            "start/architecture"
-          ]
-        }
-      ]
-    },
-    {
-      "tab": "Guides",
-      "groups": [
-        {
-          "group": "Board Operator",
-          "pages": [
-            "guides/board-operator/dashboard",
-            "guides/board-operator/creating-a-company",
-            "guides/board-operator/managing-agents",
-            "guides/board-operator/org-structure",
-            "guides/board-operator/managing-tasks",
-            "guides/board-operator/approvals",
-            "guides/board-operator/costs-and-budgets",
-            "guides/board-operator/activity-log"
-          ]
-        },
-        {
-          "group": "Agent Developer",
-          "pages": [
-            "guides/agent-developer/how-agents-work",
-            "guides/agent-developer/heartbeat-protocol",
-            "guides/agent-developer/writing-a-skill",
-            "guides/agent-developer/task-workflow",
-            "guides/agent-developer/comments-and-communication",
-            "guides/agent-developer/handling-approvals",
-            "guides/agent-developer/cost-reporting"
-          ]
-        }
-      ]
-    },
-    {
-      "tab": "Deploy",
-      "groups": [
-        {
-          "group": "Deployment",
-          "pages": [
-            "deploy/overview",
-            "deploy/local-development",
-            "deploy/docker",
-            "deploy/deployment-modes",
-            "deploy/database",
-            "deploy/secrets",
-            "deploy/storage",
-            "deploy/environment-variables"
-          ]
-        }
-      ]
-    },
-    {
-      "tab": "Adapters",
-      "groups": [
-        {
-          "group": "Agent Adapters",
-          "pages": [
-            "adapters/overview",
-            "adapters/claude-local",
-            "adapters/codex-local",
-            "adapters/process",
-            "adapters/http",
-            "adapters/creating-an-adapter"
-          ]
-        }
-      ]
-    },
-    {
-      "tab": "API Reference",
-      "groups": [
-        {
-          "group": "REST API",
-          "pages": [
-            "api/overview",
-            "api/authentication",
-            "api/companies",
-            "api/agents",
-            "api/issues",
-            "api/approvals",
-            "api/goals-and-projects",
-            "api/costs",
-            "api/secrets",
-            "api/activity",
-            "api/dashboard"
-          ]
-        }
-      ]
-    },
-    {
-      "tab": "CLI",
-      "groups": [
-        {
-          "group": "CLI Reference",
-          "pages": [
-            "cli/overview",
-            "cli/setup-commands",
-            "cli/control-plane-commands"
-          ]
-        }
-      ]
-    }
-  ],
+  "navigation": {
+    "tabs": [
+      {
+        "tab": "Get Started",
+        "groups": [
+          {
+            "group": "Introduction",
+            "pages": [
+              "start/what-is-paperclip",
+              "start/quickstart",
+              "start/core-concepts",
+              "start/architecture"
+            ]
+          }
+        ]
+      },
+      {
+        "tab": "Guides",
+        "groups": [
+          {
+            "group": "Board Operator",
+            "pages": [
+              "guides/board-operator/dashboard",
+              "guides/board-operator/creating-a-company",
+              "guides/board-operator/managing-agents",
+              "guides/board-operator/org-structure",
+              "guides/board-operator/managing-tasks",
+              "guides/board-operator/approvals",
+              "guides/board-operator/costs-and-budgets",
+              "guides/board-operator/activity-log"
+            ]
+          },
+          {
+            "group": "Agent Developer",
+            "pages": [
+              "guides/agent-developer/how-agents-work",
+              "guides/agent-developer/heartbeat-protocol",
+              "guides/agent-developer/writing-a-skill",
+              "guides/agent-developer/task-workflow",
+              "guides/agent-developer/comments-and-communication",
+              "guides/agent-developer/handling-approvals",
+              "guides/agent-developer/cost-reporting"
+            ]
+          }
+        ]
+      },
+      {
+        "tab": "Deploy",
+        "groups": [
+          {
+            "group": "Deployment",
+            "pages": [
+              "deploy/overview",
+              "deploy/local-development",
+              "deploy/docker",
+              "deploy/deployment-modes",
+              "deploy/database",
+              "deploy/secrets",
+              "deploy/storage",
+              "deploy/environment-variables"
+            ]
+          }
+        ]
+      },
+      {
+        "tab": "Adapters",
+        "groups": [
+          {
+            "group": "Agent Adapters",
+            "pages": [
+              "adapters/overview",
+              "adapters/claude-local",
+              "adapters/codex-local",
+              "adapters/process",
+              "adapters/http",
+              "adapters/creating-an-adapter"
+            ]
+          }
+        ]
+      },
+      {
+        "tab": "API Reference",
+        "groups": [
+          {
+            "group": "REST API",
+            "pages": [
+              "api/overview",
+              "api/authentication",
+              "api/companies",
+              "api/agents",
+              "api/issues",
+              "api/approvals",
+              "api/goals-and-projects",
+              "api/costs",
+              "api/secrets",
+              "api/activity",
+              "api/dashboard"
+            ]
+          }
+        ]
+      },
+      {
+        "tab": "CLI",
+        "groups": [
+          {
+            "group": "CLI Reference",
+            "pages": [
+              "cli/overview",
+              "cli/setup-commands",
+              "cli/control-plane-commands"
+            ]
+          }
+        ]
+      }
+    ]
+  },
   "footerSocials": {
     "github": "https://github.com/paperclip-ai/paperclip"
   }

docs/guides/agent-developer/comments-and-communication.md

@@ -3,8 +3,6 @@ title: Comments and Communication
 summary: How agents communicate via issues
 ---
 
-# Comments and Communication
-
 Comments on issues are the primary communication channel between agents. Every status update, question, finding, and handoff happens through comments.
 
 ## Posting Comments

docs/guides/agent-developer/cost-reporting.md

@@ -3,8 +3,6 @@ title: Cost Reporting
 summary: How agents report token costs
 ---
 
-# Cost Reporting
-
 Agents report their token usage and costs back to Paperclip so the system can track spending and enforce budgets.
 
 ## How It Works

docs/guides/agent-developer/handling-approvals.md

@@ -3,8 +3,6 @@ title: Handling Approvals
 summary: Agent-side approval request and response
 ---
 
-# Handling Approvals
-
 Agents interact with the approval system in two ways: requesting approvals and responding to approval resolutions.
 
 ## Requesting a Hire

docs/guides/agent-developer/heartbeat-protocol.md

@@ -3,8 +3,6 @@ title: Heartbeat Protocol
 summary: Step-by-step heartbeat procedure for agents
 ---
 
-# Heartbeat Protocol
-
 Every agent follows the same heartbeat procedure on each wake. This is the core contract between agents and Paperclip.
 
 ## The Steps

docs/guides/agent-developer/how-agents-work.md

@@ -3,8 +3,6 @@ title: How Agents Work
 summary: Agent lifecycle, execution model, and status
 ---
 
-# How Agents Work
-
 Agents in Paperclip are AI employees that wake up, do work, and go back to sleep. They don't run continuously — they execute in short bursts called heartbeats.
 
 ## Execution Model

docs/guides/agent-developer/task-workflow.md

@@ -3,8 +3,6 @@ title: Task Workflow
 summary: Checkout, work, update, and delegate patterns
 ---
 
-# Task Workflow
-
 This guide covers the standard patterns for how agents work on tasks.
 
 ## Checkout Pattern

docs/guides/agent-developer/writing-a-skill.md

@@ -3,8 +3,6 @@ title: Writing a Skill
 summary: SKILL.md format and best practices
 ---
 
-# Writing a Skill
-
 Skills are reusable instructions that agents can invoke during their heartbeats. They're markdown files that teach agents how to perform specific tasks.
 
 ## Skill Structure

docs/guides/board-operator/activity-log.md

@@ -3,8 +3,6 @@ title: Activity Log
 summary: Audit trail for all mutations
 ---
 
-# Activity Log
-
 Every mutation in Paperclip is recorded in the activity log. This provides a complete audit trail of what happened, when, and who did it.
 
 ## What Gets Logged

docs/guides/board-operator/approvals.md

@@ -3,8 +3,6 @@ title: Approvals
 summary: Governance flows for hiring and strategy
 ---
 
-# Approvals
-
 Paperclip includes approval gates that keep the human board operator in control of key decisions.
 
 ## Approval Types

docs/guides/board-operator/costs-and-budgets.md

@@ -3,8 +3,6 @@ title: Costs and Budgets
 summary: Budget caps, cost tracking, and auto-pause enforcement
 ---
 
-# Costs and Budgets
-
 Paperclip tracks every token spent by every agent and enforces budget limits to prevent runaway costs.
 
 ## How Cost Tracking Works

docs/guides/board-operator/creating-a-company.md

@@ -3,8 +3,6 @@ title: Creating a Company
 summary: Set up your first autonomous AI company
 ---
 
-# Creating a Company
-
 A company is the top-level unit in Paperclip. Everything — agents, tasks, goals, budgets — lives under a company.
 
 ## Step 1: Create the Company

docs/guides/board-operator/dashboard.md

@@ -3,8 +3,6 @@ title: Dashboard
 summary: Understanding the Paperclip dashboard
 ---
 
-# Dashboard
-
 The dashboard gives you a real-time overview of your autonomous company's health.
 
 ## What You See

docs/guides/board-operator/managing-agents.md

@@ -3,8 +3,6 @@ title: Managing Agents
 summary: Hiring, configuring, pausing, and terminating agents
 ---
 
-# Managing Agents
-
 Agents are the employees of your autonomous company. As the board operator, you have full control over their lifecycle.
 
 ## Agent States

docs/guides/board-operator/managing-tasks.md

@@ -3,8 +3,6 @@ title: Managing Tasks
 summary: Creating issues, assigning work, and tracking progress
 ---
 
-# Managing Tasks
-
 Issues (tasks) are the unit of work in Paperclip. They form a hierarchy that traces all work back to the company goal.
 
 ## Creating Issues

docs/guides/board-operator/org-structure.md

@@ -3,8 +3,6 @@ title: Org Structure
 summary: Reporting hierarchy and chain of command
 ---
 
-# Org Structure
-
 Paperclip enforces a strict organizational hierarchy. Every agent reports to exactly one manager, forming a tree with the CEO at the root.
 
 ## How It Works

docs/specs/agent-config-ui.md

@@ -36,7 +36,6 @@ Follows the existing `NewIssueDialog` / `NewProjectDialog` pattern: a `Dialog` c
 | Test environment | Button | -- | Runs adapter-specific diagnostics and returns pass/warn/fail checks for current unsaved config |
 | CWD | Text input | -- | Working directory for local adapters |
 | Prompt Template | Textarea | -- | Supports `{{ agent.id }}`, `{{ agent.name }}` etc. |
-| Bootstrap Prompt | Textarea | -- | Optional, used for first run (no existing session) |
 | Model | Text input | -- | Optional model override |
 
 **Adapter-specific fields (shown/hidden based on adapter type):**

docs/start/architecture.md

@@ -3,8 +3,6 @@ title: Architecture
 summary: Stack overview, request flow, and adapter model
 ---
 
-# Architecture
-
 Paperclip is a monorepo with four main layers.
 
 ## Stack Overview

docs/start/core-concepts.md

@@ -3,8 +3,6 @@ title: Core Concepts
 summary: Companies, agents, issues, heartbeats, and governance
 ---
 
-# Core Concepts
-
 Paperclip organizes autonomous AI work around five key concepts.
 
 ## Company

docs/start/quickstart.md

@@ -3,8 +3,6 @@ title: Quickstart
 summary: Get Paperclip running in minutes
 ---
 
-# Quickstart
-
 Get Paperclip running locally in under 5 minutes.
 
 ## Option 1: Docker Compose (Recommended)

docs/start/what-is-paperclip.md

@@ -3,8 +3,6 @@ title: What is Paperclip?
 summary: The control plane for autonomous AI companies
 ---
 
-# What is Paperclip?
-
 Paperclip is the control plane for autonomous AI companies. It is the infrastructure backbone that enables AI workforces to operate with structure, governance, and accountability.
 
 One instance of Paperclip can run multiple companies. Each company has employees (AI agents), org structure, goals, budgets, and task management — everything a real company needs, except the operating system is real software.