A reading order, not a maze.
Five hand-written documents that describe the product end to end. Read them in order if you're new. Skip to whichever solves your problem if you're not.
A · Read
- 01
Product thesis
Why Conversational Factory exists. The egress problem, the one-way architectural commitment, and the user outcomes that follow from it.
read → - 02
Concepts & glossary
Every term in plant-floor language. Two to three sentences each. Technical docs link here on first use.
read → - 03
System architecture
How the product composes. The inside/outside one-way seam, components, data flow, segmentation, and trust model.
read → - 04
Role definitions
The canonical roles — ingest data plane (passive/active), inside historian, outside copy, query plane — the one-way seam between them, and how they distribute across single-box and two-box-plus-diode deployments.
read → - 05
Operator quickstart
Bring Conversational Factory up on a workstation in about ten minutes — and ask your plant a question.
read →
B · Build
- 06
Developer quickstart
Bring the full chain up locally from source — data source, query plane, gateway — and ask Claude Desktop a question.
build → - 07
Repo map
How the parent workspace is organized — services, schemas, examples, and the conventions that keep them honest.
build →
- Model Context Protocol ↗
- IIA architectural spec ↗
- Standardized read API — schemas/ in-tree