README.md

MXC development documentation

Audience: MXC developers

This section covers MXC architecture, implementation, validation, and planned work. Consumer documentation remains under docs/; start with the project README.

See the developer glossary and wording guide for implementation terms, plain-English alternatives, and guidance on naming specific types.

Architecture

• Repository architecture
• Container lifecycle architecture
• Versioning design
• Telemetry architecture
• Telemetry consent design
• IsolationSession one-shot architecture
• IsolationSession state-aware Rust architecture
• IsolationSession state-aware TypeScript architecture

Build and test

• CI validation infrastructure
• Pull request builds
• Schema code generation
• Fuzzing
• WSLC SDK bindings runbook
• Host-dependent backend test suites

Contributor guides

• Authoring a new feature
• Diagnostics
• Adding ProcessContainer OS features

Plans

• Backend support probe API
• Bubblewrap backend feasibility
• Linux and WSL roadmap
• Nanvix integration