ChatMaestro logo

ChatMaestro: Experiment Orchestration Platform

Design & documentation

This page is the portal to the design record for the platform: the architecture, the data model, the behavior walkthroughs, the interactive screen mockups, and the datasheets. Use the reading-order map below for a guided first pass, or the cards beneath it to jump straight to an area.

How to access the documentation

No special software or installation is needed to read the documentation or open the screen mockups — every page is a standard web page (HTML, SVG, and PDF) that opens in any modern browser, whether online or from a local copy. For the full experience, keep JavaScript enabled in your browser: the interactive mockup viewer uses it to frame each screen in its role shell and to navigate between screens.

Suggested reading order
Follow the arrows for a guided first read, or jump straight to any box — each opens in a new tab. The glossary and jargon sit on the reference shelf beside the overview — consult them anytime.
General overview datasheet · general Architecture — narrative architecture doc Architecture — datasheet datasheet · technical Screen mockups mockups/ Use-case scenarios scenarios/ Schema · module map schema-overview Algorithms ALGORITHMS core-identity schema-core-identity core-experiment schema-core-experiment llm-chat schema-llmchat search schema-search Schema source · DBML schema-dbml Schema source · SQL DDL schema.sql Reference shelf · consult anytime GLOSSARY JARGON Legend start end task AND gateway
Download PDF Overview & architecture General datasheet Architecture Technical datasheet Schema Module map core-identity core-experiment llm-chat search DBML Reference Algorithms Glossary Jargon Every box in the map opens the HTML; these are the print-ready PDFs. Scenario & screen PDFs are downloadable per item on the scenario and mockup galleries.
Browse by perspective
Architecture & Algorithms
This specification covers the system stack and how its parts fit together: a browser single-page application on Cloudflare Pages, a persistent Python middle tier on fly.io that holds the provider keys, and Supabase for authentication, Realtime, and Postgres with row-level security. It also documents the algorithms the middle tier runs, from answer scoring and combine methods to self-improvement, retrieval, and natural-language querying.
Technical Architecture Specification PDF Algorithms PDF
Data model & ERDs
The data model comprises 24 tables. It is documented as per-module entity-relationship diagrams (ERDs) for the four core modules, each carrying a narrative that explains its fields, together with the schema source it is all generated from.
Schema index Overview of ERD Modules Module ERDs core-identity core-experiment llm-chat search Source DBML source .dbml DDL .sql
Scenarios
Behavior walkthroughs of the platform's core flows, including composing an experiment, building a cohort, launching and analyzing a run, asking a question, and ingesting a document. Each walkthrough includes sequence and state detail.
Scenario index
Mockup viewer & gallery
The interface is presented as 69 static screen mockups. The viewer is the best way to preview them: it frames each screen in the appropriate role shell (experimenter, enrollee, or admin), keeps navigation consistent across all 69, and lets you follow a task from one screen to the next, with a Show-annotations toggle that reveals the behind-the-scenes design notes and a slide show that steps through every screen in order. The gallery lists every screen individually, each with its own PDF.
Open viewer Screen gallery
Datasheets
Two two-page datasheets summarize the platform: a plain-language overview for decision-makers, and a technical overview for engineers and architects evaluating fit.
General PDF Technical PDF
Copyright © 2026 Agilis Software LLC. All rights reserved.