用途：覆盖本地 Paperclip 实例的日常开发与运维流程，假定在 Paperclip 仓库检出中工作，origin 指向 git@github.com:paperclipai/paperclip.git。
主要能力：启动/停止服务、从 master 拉取更新、构建与测试、worktree 管理、数据库备份与迁移、健康检查、心跳触发、本地安装 agent 技能等。常用命令包括 npx paperclipai run、pnpm dev、pnpm dev:stop、pnpm build、pnpm typecheck、pnpm test、pnpm db:migrate、pnpm db:generate、npx paperclipai db:backup、npx paperclipai doctor --repair、npx paperclipai env、npx paperclipai heartbeat run --agent-id <id>、npx paperclipai agent local-cli <agent> --company-id <id>。
使用方式：执行任何 CLI 命令、构建、测试或管理 worktree 前，必须先阅读仓库内 doc/DEVELOPING.md，不得猜测参数。worktree 将 git worktree 与隔离的 Paperclip 实例结合，各自拥有数据库、端口和环境；创建前须阅读该文档的 Worktree-local Instances 与 Worktree CLI Reference 章节。典型流程为 worktree:make、进入目录并 eval "$(npx paperclipai worktree env)"、npx paperclipai run、完成后 worktree:merge-history、worktree:cleanup。有个人 fork 时优先推送到 fork，再通过 gh pr create --repo paperclipai/paperclip --head <fork-owner>:<branch-name> 创建 PR。
限制与硬性规则：所有 worktree 与数据库操作必须走 npx paperclipai / pnpm paperclipai，禁止直接使用 pg_dump、psql 等原始 postgres 命令，禁止手动设置 DATABASE_URL 指向其他实例数据库，禁止对 .paperclip/、.paperclip-worktrees/、db/ 执行 rm -rf，禁止直接操作嵌入式 postgres 数据目录或按 PID 杀进程。CLI 失败时应报告错误并阻塞任务，不得绕过。创建 PR 前必须阅读 .github/PULL_REQUEST_TEMPLATE.md、CONTRIBUTING.md、.github/workflows/pr.yml，并包含 Thinking Path、What Changed、Verification、Risks、Model Used、Checklist 等章节。需长期运行的开发服务器应使用 tmux 分离会话启动，并在报告前验证端口监听。仓库为公开面向，禁止提交密钥、令牌、私有日志、PII 或客户数据。