# Design

Why Bee Box is built this way — the design rationale behind the engine.

- [durability-and-provenance.md](https://beebox.run/docs/design/durability-and-provenance.md): Committing makes it real; the filesystem is the index; provenance as aspiration.
- [extensibility.md](https://beebox.run/docs/design/extensibility.md): Understanding over plugin architecture: how a box is extended.
- [identity.md](https://beebox.run/docs/design/identity.md): Why a box has one identity and how sharing works today.
- [interaction-model.md](https://beebox.run/docs/design/interaction-model.md): Idle-by-default background engine and also a chatbot; connectors as the external boundary.
- [processing.md](https://beebox.run/docs/design/processing.md): What a wakeup actually does, verified against the code.
- [representation.md](https://beebox.run/docs/design/representation.md): The anchor principle: the representation mirrors the shape of the idea.
- [teaching.md](https://beebox.run/docs/design/teaching.md): How the user teaches the box: rules, guides, corrections.
- [trust.md](https://beebox.run/docs/design/trust.md): Question, then confirmation, then automatic: how an action earns autonomy.