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.

Start here

A fast onboarding path from install to your first generated contract.

Install the CLI

bun add contractspec -D

Generate repo-local guidance

start-here-onboard

contractspec onboard
# optional focused track
contractspec onboard knowledge --example knowledge-canon

Initialize your project

start-here-init

bunx contractspec init

Author your first contract

start-here-create

contractspec create --type operation

Generate implementation

start-here-build

contractspec generate
contractspec validate

Next: Hello World Troubleshooting Compatibility

OSS docsstartStart with OSS. Adopt Studio when you want the operating layer.

Installation

Install the CLI and core packages, then prepare a workspace for incremental adoption.

Why ContractSpec

Keep educational and comparison content reachable without letting it define the primary OSS learning path.

Manifesto Contract-first API Spec-driven development

Open system docs