Skip to content

Architecture

Architecture docs describe layer boundaries that must remain true as the code evolves.

  • Agent Layer — molexp.agent as a thin wrapper over pydantic-ai
  • pydantic-graph. Documents the four-name public surface, the _pydanticai/ firewall, the "don't reinvent pydantic-ai" rule, and the capability-discovery gate that sits inside PlanMode.
  • Plan Mode — plan mode as workflow authoring and validation, ending in runner handoff.
  • Workflow Layer — molexp.workflow as the single workflow abstraction and the only place that may hide pydantic-graph. Also covers the boundary between workspace storage primitives and the workflow engine that consumes them.