README.md

Internals

This section explains how Loop behaves internally, where major responsibilities live, and how data moves through the system.

Start Here

1. Architecture
2. Runtime Walkthrough
3. OODA and Execution
4. Module Map
5. Python Orchestrator Swap Analysis

Audience

• Contributors debugging deep runtime behavior
• Maintainers reviewing performance/correctness tradeoffs
• Integration authors mapping external surfaces to internal modules

What You Will Not Find Here

• Full feature specs (see docs/spec/)
• Long-form migration rationale (see docs/migration-spec-*.md)
• Session-level work plans (see docs/execution-plan/)

This is the "how it works now" view.