Comprehensive Technical Documentation

Definitive technical reference for the Molecule AI platform. Based on a full non-invasive scan of the molecule-core repository (formerly molecule-monorepo, renamed during the post-2026-05-06 GitHub-org-suspension recovery).

This reference is split into focused sections:

• Technical Overview — executive summary and product positioning.
• System Architecture & Infrastructure — system architecture, database schema, Docker Compose orchestration, environment variables.
• Workspace Lifecycle & Provisioning — workspace state machine, provisioning and container lifecycle, the workspace runtime.
• Communication, API & A2A — hierarchy communication rules, the platform API surface, the A2A protocol.
• Memory, Tiers & Tools — Hierarchical Memory Architecture, the runtime tier system, tools & capabilities.
• Skills, Bundles, Coordinator & MCP — skills system, bundle system, the coordinator pattern, MCP server integrations.
• Canvas, Codebase & Design Patterns — Canvas UI, codebase structure, key design patterns.
• Operations, Licensing & Roadmap — recent features, known gaps, licensing, OSS growth, technical debt, production deployment, summary statistics, the vision.

For a higher-level orientation, start with Architecture and Concepts.