Conversational Factory
Documentation · Conversational Factory

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

  1. 01

    Product thesis

    Why Conversational Factory exists. The problem, the architectural commitment, and the user outcomes that follow from it.

    read →
  2. 02

    Concepts & glossary

    Every term in plant-floor language. Two to three sentences each. Technical docs link here on first use.

    read →
  3. 03

    System architecture

    How the product composes. The on-box vs off-box seam, components, data flow, segmentation, and trust model.

    read →
  4. 04

    Operator quickstart

    Bring Conversational Factory up on a workstation in about ten minutes — and ask your plant a question.

    read →

B · Build

  1. 05

    Developer quickstart

    Bring the full chain up locally from source — witness, query plane, gateway — and ask Claude Desktop a question against real witness data.

    build →
  2. 06

    Repo map

    How the parent workspace is organized — services, schemas, examples, and the conventions that keep them honest.

    build →
Standards