OSS-first docs
These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.
Core model
Contracts are the durable system boundary.
ContractSpec uses explicit TypeScript specs to describe behavior before it spreads across APIs, UI, data models, events, and operator flows. The goal is not to hide implementation. The goal is to make the system boundary explicit enough that generation, validation, runtime enforcement, and regeneration can stay coherent.
System promise
one contract → many surfaces
Use the contract layer to keep surface behavior aligned, then let runtimes and generators do the repetitive work without inventing a closed platform.
What the contract layer owns
Behavior: operations, events, presentations, workflows.
Validation: input, output, and schema boundaries.
Governance: policy, auditability, and migration rules.
Surface alignment: generated or served behavior across API, UI, data, and agent-facing interfaces.
Specification types
You can adopt the model one part at a time. Not every system needs every spec type on day one.
Capabilities
Model operations, events, and presentations as explicit system behavior.
Open section
Data views
Describe query, filtering, and presentation behavior from the same source model.
Open section
Workflows
Coordinate multi-step execution, retries, monitoring, and hand-offs.
Open section
Policy
Carry governance and access rules through every generated and runtime-served surface.
Open section
Overlays
Customize generated surfaces safely instead of forking them permanently.
Open section
Safety and migration
Keep change safe with signing, audits, rollbacks, and explicit migration behavior.
Open section
Implemented spec packs
These packs combine multiple contract surfaces into higher-order systems you can use directly today: agent enforcement, AI-native surface runtime, and governed Builder authoring.
Module bundles
Define typed surface bundles that resolve into auditable runtime plans instead of hand-built page logic.
Open pack
ContractSpec Connect
Put coding-agent edits and commands behind local-first context, verification, replay, and review artifacts.
Open pack
Builder control plane
Coordinate multimodal authoring, provider routing, readiness, export, and mobile review on top of OSS and Studio.
Open pack
Troubleshooting
Resolve the common installation, validation, and runtime mistakes you hit during first adoption.
Capabilities
Model commands, queries, presentations, and events as explicit contract surfaces.
Why ContractSpec
Keep educational and comparison content reachable without letting it define the primary OSS learning path.