# Superbee

> A concise orientation to Superbee and the growing public documentation.

## Get started

- [Start here](https://docs.getsuperbee.com/bundle/learn/start-here.md): A concise orientation to Superbee and the growing public documentation.
- [Install and set up Superbee](https://docs.getsuperbee.com/bundle/get-started/install-and-setup.md): Install the released CLI and let the read-only setup conductor verify one exact AI host.
- [Create your first durable workspace](https://docs.getsuperbee.com/bundle/get-started/first-durable-workspace.md): Create a local bundle, preserve one decision, verify it, and open it for a human.

## Core concepts

- [What Superbee is](https://docs.getsuperbee.com/bundle/concepts/what-superbee-is.md): The product mental model: durable bundles, typed documents, reusable structure, relationships, and human representations.
- [Bundles, documents, and relationships](https://docs.getsuperbee.com/bundle/concepts/bundles-documents-and-relationships.md): How Superbee's portable bundle, document, convention, recipe, link, version, and presentation layers fit together.
- [Understand reusable domain structure](https://docs.getsuperbee.com/bundle/concepts/reusable-domain-structure.md): Choose when documents, relationships, Kinds, recipes, and Views earn their maintenance cost.

## Guides

- [Preserve context between sessions](https://docs.getsuperbee.com/bundle/guides/preserve-context-between-sessions.md): Leave a concise, verifiable handoff that a later agent can discover and continue.
- [Model recurring domain concepts](https://docs.getsuperbee.com/bundle/guides/model-recurring-domain-concepts.md): Turn a proven recurring concept into a bundle-owned Kind and validated instances.
- [Show documents and Views to a human](https://docs.getsuperbee.com/bundle/guides/show-documents-and-views.md): Display authoritative Markdown and safely launch interactive Views through the local browser or an MCP Apps host.

## Troubleshooting

- [Troubleshoot setup and bundle resolution](https://docs.getsuperbee.com/bundle/troubleshooting/setup-and-bundle-resolution.md): Diagnose installation, host setup, workspace selection, and local bundle health from their owning command receipts.

## Reference

- [CLI overview](https://docs.getsuperbee.com/bundle/reference/cli-overview.md): Compact command ownership and output contract for the current stable Superbee release.

## Releases and migrations

- [Superbee 0.1.3](https://docs.getsuperbee.com/bundle/releases/current.md): What Superbee 0.1.3 enabled, who could use it, and the shortest safe setup path.
- [Migrate or upgrade safely](https://docs.getsuperbee.com/bundle/guides/migrate-or-upgrade-safely.md): Upgrade Superbee or move from AgentState while preserving the intended workspace and verifying each compatibility step.

## Architecture and contributing

- [Architecture at a glance](https://docs.getsuperbee.com/bundle/architecture/architecture-at-a-glance.md): How Superbee's private workspace layers become one supported installed package.
- [Superbee system context](https://docs.getsuperbee.com/bundle/architecture/superbee-system-context.md): How humans, agents, Superbee, shared bundles, package distribution, and public publication relate.
- [Document mutation lifecycle](https://docs.getsuperbee.com/bundle/architecture/document-mutation-lifecycle.md): How an optimistic document update becomes durable state and is optionally published through Git.
- [View lifecycle and trust](https://docs.getsuperbee.com/bundle/architecture/view-lifecycle-and-trust.md): How exact View bytes are admitted, authorized, contained, bridged, confirmed, and revoked.
- [Public publication boundary](https://docs.getsuperbee.com/bundle/architecture/public-publication-boundary.md): How a dedicated public bundle becomes a bounded complete publication and curated human presentation.
- [Sharing, synchronization, and freshness](https://docs.getsuperbee.com/bundle/architecture/sharing-synchronization-and-freshness.md): How Superbee classifies bundle channels, refreshes reads, converges shared changes, and preserves conflicting work.

## Optional

- [Documentation operating model](https://docs.getsuperbee.com/bundle/design/docs-operating-model.md): Audience, content, authority, lifecycle, and maintenance contract for Superbee's public documentation.
- [Documentation site experience contract](https://docs.getsuperbee.com/bundle/design/site-experience-contract.md): Stable human experience and bundle-to-Portal boundary for the Superbee documentation site.
- [Documentation coverage and delivery](https://docs.getsuperbee.com/bundle/plans/docs-coverage.md): Ordered page coverage, representative slice, and readiness gates for the public documentation.
- [Superbee 0.1.3 release evidence](https://docs.getsuperbee.com/bundle/sources/current-release.md): Immutable package, source, compatibility, and disposable-journey evidence for the first documentation slice.
- [Superbee codebase source](https://docs.getsuperbee.com/bundle/sources/superbee-codebase-main.md): Pinned implementation evidence for maintained Superbee architecture documentation.
- [Superbee product source](https://docs.getsuperbee.com/bundle/sources/superbee-core.md): Pinned product evidence for the public documentation bundle.
- [Superbee Portal source](https://docs.getsuperbee.com/bundle/sources/superbee-portal.md): Pinned Portal evidence for the public documentation bundle.
- [Superbee 0.1.3 release evidence](https://docs.getsuperbee.com/bundle/sources/superbee-release-0.1.3.md): Immutable package, source, compatibility, and disposable-journey evidence for the first documentation slice.