Academy

Academy pages explain the project's internal grammar. They are not tutorials, they are long-form arguments for why the handler, registry, cache, and OpenSpec layers exist as separate concerns.

Read this chapter when: you want the reasoning behind the implementation, not only the shape of the implementation.

Handler patternThe strategy boundary that keeps model-specific execution localized.Registry patternThe metadata and dispatch spine that makes model discovery coherent.Caching strategyThe runtime trade-off between warm models, memory pressure, and reload cost.

What makes these essays useful

• each article links a code-level pattern to a system-level consequence
• trade-offs are explicit rather than implied
• extension guidance is included, so contributors can act on the design