docs/ARCHITECTURE.md

# MindsEye Sandbox FlowStudio — Architecture

## Layers

1. **UI Layer (`app_02/`)**
   - Gradio Blocks app
   - Two main tabs:
     - Chat
     - Flow Studio

2. **Engine Layer (`engine_03/`)**
   - `knowledge/` — local MindsEye knowledge base.
   - `flow/` — flow graph models, Mermaid rendering, and simulation.

3. **Data Layer (`flows_04/`)**
   - JSON flow definitions used by the Flow Studio.
   - Later: user-created flows for different MindsEye scenarios.

4. **Config Layer (`config_05/`)**
   - Simple Python settings.
   - Example Space configuration references.

5. **Assets (`assets_07/`)**
   - Thumbnail and logos for the Space and documentation.

The entire system is local-only: no external APIs are called.