ClipHub is a public registry for sharing and discovering Paperclip
company configurations. Defines template publishing, semantic search,
forking, versioning, moderation, and agent/team sub-packages. Includes
data model sketch, user flows, architecture, and V1 scope.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Remove standalone Company goal field — direction is now defined by
Initiatives. Add budget delegation model (Board → CEO → managers).
Simplify agent auth to connection-string generation. Adopt Better Auth.
Capitalize domain terms consistently (Company, Agent, Board, Adapter).
Clarify cost tracking scope: token/LLM budgets are core, external
revenue tracking is a future plugin.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Clarify that cross-team collaboration rules live in the Paperclip SKILL.
Simplify task hierarchy description. Change cost denomination to both
tokens and dollars. Move HTTP adapter to V1. Minor wording cleanups.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add doc/DATABASE.md documenting the three database modes: embedded
PGlite, local Docker PostgreSQL, and hosted production. Fix markdown
table alignment and minor whitespace in SPEC.md.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace SOUL.md/HEARTBEAT.md prescriptive format with adapter-based
agent configuration. Expand board governance with approval gates,
board powers, and live control surface. Add agent export formats,
communication model, and additional spec detail throughout.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add @electric-sql/pglite so the server can run without an external
Postgres instance. When DATABASE_URL is not set, the server auto-creates
an embedded PGlite database in ./data/pglite with schema push on startup.
- Add createPgliteDb() alongside the existing createDb()
- Make DATABASE_URL optional in server config
- Update drizzle config to glob schema files
- Update migrate script to support both Postgres and PGlite
- Add data/ to .gitignore for local PGlite storage
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
SPEC.md defines the Paperclip control plane specification including
company model, board governance, and agent architecture.
doc/TASKS-mcp.md defines the MCP function contracts for task management.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Architecture for extending Paperclip with plugins: manifest-based
modules with routes, UI pages, database tables, and hook subscriptions.
Also covers company templates, the Company Store, and a phased
implementation plan.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Defines the target data model for hierarchical task tracking:
teams, workflow states, issues, projects, milestones, initiatives,
labels, relations, comments, and sub-issues. Includes entity
relationships and recommended implementation priority.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Dashboard, agents, goals, issues, and projects pages with sidebar
navigation. API client layer, custom hooks, and shared layout
components. Built with Vite and TypeScript.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Express server with CRUD routes for agents, goals, issues, projects,
and activity log. Includes validation middleware, structured error
handling, request logging, and health check endpoint with tests.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Postgres schema via Drizzle ORM for agents, goals, issues, projects,
and activity log tables. Includes migration runner, seed script,
and Drizzle config.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Shared TypeScript types, Zod validators, API contract definitions,
and constants used by both server and UI. Covers agents, goals,
issues, projects, and activity entities.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
GOAL.md defines Paperclip as a control plane for AI agent companies.
PRODUCT.md details core concepts: companies, agents with SOUL.md/HEARTBEAT.md,
hierarchical task management, and agent execution modes.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
pnpm monorepo with shared packages, server, and UI workspaces.
Includes Docker multi-stage build, Postgres compose, and root TypeScript/Vitest config.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
