Design Documents

The active architecture discussion lives in the repository design set under docs/design/.

Main Entry Points

• Design index on GitHub
• Julia frontend overview
• Core primitives
• TreeTN and chain support
• Quantics layer
• BubbleTeaCI migration boundary
• Extensions and compatibility
• Roadmap

How To Read Them

Start with the overview, then the TreeTN and quantics documents, then the roadmap. The BubbleTeaCI note is important for clarifying what does not belong in Tensor4all.jl.

Two cross-package boundaries are especially important while reviewing the design:

• QuanticsGrids.jl owns grid semantics and coordinate conversion; Tensor4all.jl adopts and re-exports a curated subset.
• BubbleTeaCI owns TTFunction and high-level workflows; it should build on Tensor4all.jl rather than duplicating lower layers.

For the implementation work intentionally staged beyond the initial reset, see Deferred Rework Plan.