Diagram
Superbee system context
How humans, agents, Superbee, shared bundles, package distribution, and public publication relate.
Question answered
How do humans, AI agent hosts, Superbee's local product, shared bundles, package distribution, and public publication fit together?
Audience and scope
This system-context view is for prospective users, contributors, and partners who need the product's major boundaries without package-level implementation detail. It does not describe hosted multi-user collaboration, internal package dependencies, or every supported host.
Accessible narrative
A human directs work through an AI agent host. The host invokes a locally installed Superbee CLI. The CLI reads and writes a user-owned bundle containing Markdown documents, relationships, and opaque artifacts. Git and GitHub may share and review that bundle, while npm distributes the CLI. For public human presentation, Superbee captures an exact read-only publication snapshot and Portal turns it into an inspectable site. Publication does not grant the site authority to mutate the source bundle.
Elements and relationships
| From | Relationship | To |
|---|---|---|
| Human | directs work through | AI agent host |
| AI agent host | invokes structured commands | Superbee CLI |
| npm registry | distributes the installed package | Superbee CLI |
| Superbee CLI | reads and writes | user-owned bundle |
| user-owned bundle | may be shared and reviewed through | Git and GitHub |
| user-owned bundle | is captured by | superbee/publication |
superbee/publication | is presented by | Superbee Portal |
| Superbee Portal | publishes | public documentation site |
| Human | reads and inspects | public documentation site |