# OPB Brain > OPB Brain is the system of record for agent work. Humans and agents write intent, state, knowledge and results into it; the work itself happens on remote machines that claim tasks and write back. Most of what these pages describe is designed, not running. The domain tables, the MCP server and the REST and GraphQL APIs do not exist yet, and every page covering one says so at the top. Read them as design. Any page is available as markdown by appending `.md` to its URL, for example `/docs/concepts/tasks.md`. ## Overview - [Agent Experience](/docs/agent-experience): The eight agent-first rules every surface in OPB Brain must satisfy - [Architecture](/docs/architecture): The applications and packages in this repository, what each one does today, and where the unbuilt agent surfaces are meant to land - [Overview](/docs): OPB Brain is the system of record for agent work - [Structure](/docs/structure): Learn how next-forge apps and packages are structured. - [Concepts](/docs/concepts): Every entity in the domain model, where each one is documented, and the invariants that hold across all of them - [Design and UX](/docs/design): The ordered contract for building an OPB Brain screen. ## Concepts - [Agents and machines](/docs/concepts/agents-and-machines): Workspaces, users, the Agent record, the Machine that hosts a runtime, and how routing reads them - [Approvals and leasing](/docs/concepts/approvals-and-leasing): How a remote agent takes work without two agents taking the same work, and how a human gate stops a destructive action - [Documents and artifacts](/docs/concepts/documents-and-artifacts): The two kinds of thing worth keeping — durable knowledge, and the evidence a particular run produced - [Runs and events](/docs/concepts/runs): How one attempt at a task is recorded, and how status streams back from the machine that did the work - [Tasks](/docs/concepts/tasks): The Task record, the task DAG, and the state machine every status change passes through ## Interfaces - [Browser](/docs/interfaces/browser): The planned browser door — stable selectors, addressable URLs, a markdown view of every entity, and an llms.txt index - [GraphQL API](/docs/interfaces/graphql): The planned context-efficient door — a published schema, Relay connections, typed userErrors and a complexity budget - [MCP Server](/docs/interfaces/mcp): The planned MCP tool surface a remote Claude Code or Codex session uses to claim work and write results back - [REST API](/docs/interfaces/rest): The planned HTTP door — versioned paths, a capability manifest, cursor pagination, idempotency and RFC 9457 errors ## Guides - [Connect a Remote Agent](/docs/guides/connect-a-remote-agent): The intended end-to-end runbook for enrolling a machine, minting a token, claiming a task and writing results back ## Setup - [Environment Variables](/docs/setup/env): Every environment variable the OPB Brain monorepo reads, which are required, and where each file lives - [Prerequisites](/docs/setup/prerequisites): The tools and accounts needed before running the OPB Brain monorepo locally - [Quickstart](/docs/setup/quickstart): Clone the OPB Brain monorepo and get the applications running locally ## Applications - [API](/docs/apps/api): The apps/api application — what it serves today, and where the MCP, REST and GraphQL doors are meant to land - [App](/docs/apps/app): The apps/app application — the authenticated product shell, and the entity views it does not have yet - [Documentation](/docs/apps/docs): The two documentation projects in this repository — the Mintlify one inherited from the template, and the site you are reading - [Email](/docs/apps/email): The apps/email preview server for the React Email templates in @repo/email - [Storybook](/docs/apps/storybook): The apps/storybook workshop for the components in @repo/design-system - [Studio](/docs/apps/studio): The apps/studio Prisma Studio instance for browsing the database - [Web](/docs/apps/web): The apps/web application — the public marketing site, with no database access and no authentication ## Packages - [Authentication](/docs/packages/authentication): We use Clerk to handle authentication, user and organization management. - [Collaboration](/docs/packages/collaboration): Real-time presence and multiplayer features through Liveblocks. - [Cron Jobs](/docs/packages/cron): Run scheduled work on a Cloudflare Cron Trigger. - [Database](/docs/packages/database): How Cloudflare D1 and the Prisma tooling schema are configured - [Transactional Emails](/docs/packages/email) - [Feature Flags](/docs/packages/flags): Control access to features in your application. - [Formatting](/docs/packages/formatting): Code formatting, linting and more. - [Internationalization](/docs/packages/internationalization): How to add multiple languages to your application. - [Notifications](/docs/packages/notifications): In-app notifications for your users. - [Payments](/docs/packages/payments): How payments and billing are handled through Stripe. - [Storage](/docs/packages/storage): How to store files in your application. - [Components](/docs/packages/cms/components): Components that come with the CMS package. - [Metadata](/docs/packages/cms/metadata): How the title, description, and Open Graph images are configured in the CMS. - [Overview](/docs/packages/cms/overview): How the CMS package is configured. - [Colors](/docs/packages/design-system/colors): The current semantic colour contract. - [Components](/docs/packages/design-system/components): Primitive ownership and normative component recipes. - [Dark mode](/docs/packages/design-system/dark-mode): The lamplit counterpart to the default light theme. - [Provider](/docs/packages/design-system/provider): The application boundary that supplies shared design behavior. - [Typography](/docs/packages/design-system/typography): The current type families, scale, measure, and leading. - [Bundle Analysis](/docs/packages/next-config/bundle-analysis): How to analyze and optimize your app's bundle size - [Configuration](/docs/packages/next-config/overview): The next-config package, explained - [Debugging](/docs/packages/observability/debugging): How the VSCode debugger is configured for the applications in the monorepo. - [Error Capture](/docs/packages/observability/error-capture): How error capture works with Cloudflare Workers Observability. - [Logging](/docs/packages/observability/logging): How logging is configured across environments. - [Uptime Monitoring](/docs/packages/observability/uptime): How uptime monitoring is configured on Cloudflare. - [Application Security](/docs/packages/security/application): Security measures taken to protect your applications. - [Dependency Security](/docs/packages/security/dependencies): How dependency updates and secret scanning are handled. - [Security Headers](/docs/packages/security/headers): Security headers used to protect your application. - [IP Geolocation](/docs/packages/security/ip-geolocation): Accessing IP geolocation data in your application. - [Rate Limiting](/docs/packages/security/rate-limiting): Protecting your API routes from abuse with Cloudflare KV. - [JSON-LD](/docs/packages/seo/json-ld): How we've implemented JSON-LD structured data. - [Metadata](/docs/packages/seo/metadata): How to customize the page metadata. - [Sitemap](/docs/packages/seo/sitemap): How we generate the sitemap for the website. - [Inbound Webhooks](/docs/packages/webhooks/inbound): Receive inbound webhooks from other services. - [Outbound Webhooks](/docs/packages/webhooks/outbound): Send webhooks to your users using Svix. - [Product Analytics](/docs/packages/analytics/product): Captures product events and metrics. - [Web Analytics](/docs/packages/analytics/web): Captures pageviews, pageleave and custom events. ## Deployment - [Deploying to Cloudflare](/docs/deployment/cloudflare): The Cloudflare Workers that host OPB Brain, the bindings they carry, and the commands that deploy them ## Design - [Accessibility](/docs/design/accessibility): Contrast, focus, keyboard access, names, themes, and reduced motion. - [Agent-facing rendering](/docs/design/agents): Density, text state, identifiers, stable selectors, and determinism. - [Components](/docs/design/components): Component recipes and the primitive that owns each behavior. - [Layout](/docs/design/layout): Spacing rhythm, page skeleton, measure, and density. - [Motion](/docs/design/motion): Durations, easing, state change, and reduced motion. - [Patterns](/docs/design/patterns): Collections, detail surfaces, forms, overlays, charts, and states. - [Tokens](/docs/design/tokens): Every normative token in DESIGN.md, grouped by its purpose. - [Typography](/docs/design/typography): The type trio, scale, measure, leading, and inversion rule. - [Voice](/docs/design/voice): Copy rules, element rules, and the self-describing error contract.