Skip to content

Architecture and internals

How Bernstein works under the hood, for readers extending it or deciding whether its design fits their constraints.

  • System


    Top-level architecture, task lifecycle, model routing, state persistence.

    Architecture

  • Concepts


    The building blocks - fingerprint memoization, lineage trail, spec-as-test.

    Artifact lineage trail

  • Orchestration internals


    Task DAG, run actor, worker coordination, failure taxonomy.

    Task DAG

  • Decisions (ADRs)


    Why the orchestrator is deterministic, file-based, and LLM-free at the core.

    Why deterministic