Guides

This section covers broader engineering decisions and production-oriented topics.

Use these pages when you are moving beyond the first demo and want to design a more durable system.

---

Guide map

• Spec-Driven Authoring — write resources in prose, the LLM generates declarative Python; AST-validated and lock-tracked
• Backend setup — choose and configure metadata, resource, blob, and job backends
• Storage — compare storage factories and understand persistence trade-offs
• Performance — understand trade-offs, bottlenecks, and scaling considerations
• From demo to production — move from a local prototype to a deployable service
• Upgrading to 0.11 — spec-driven authoring layer (additive, no breaking changes)
• Upgrading to 0.10
• Upgrading to 0.9 — breaking changes and migration steps from 0.8.5

---

Suggested reading order

1. Backend setup
2. Storage
3. From demo to production
4. Performance