ChooChoo

ChooChoo is not a proprietary silo; it is a Spec-Driven platform built on open standards. For the motivations behind this approach, see Why ChooChoo? and the Architecture Overview.

Open Data Product Standard (ODPS)

Version: 1.0.0
Website: bitol-io.github.io/open-data-product-standard
Usage: Defines the "Product" entity, ownership, and service level objectives (SLOs).
ChooChoo Docs: Products (ODPS) — learn how to define and validate Data Products.
Schema: See Schema Definitions for the required fields and validation rules.

Open Data Contract Standard (ODCS)

Version: 3.1.0
Website: bitol-io.github.io/open-data-contract-standard
Usage: Defines the schema, semantics, and quality rules for data interfaces.
ChooChoo Docs: Contracts (ODCS) — learn how to enforce data quality with contracts.
Extensions: ChooChoo extends ODCS with compliance tags that trigger governance workflows and affect risk scoring.

Arazzo

Version: 1.0.0
Website: spec.openapis.org/arazzo
Usage: Defines deterministic workflows and API orchestrations for agents.
ChooChoo Docs: Workflows (Arazzo) — learn how to orchestrate multi-step operations with governance gates.
Extensions: ChooChoo adds requiresApproval and approvalPolicy fields that integrate with Approval Workflows.

Agent Trace

Version: 0.1.0
Usage: Standardizes the logging of AI agent thought processes and decisions for auditability.
ChooChoo Docs: Agent Trace — learn how to capture and persist AI context alongside code changes.
Integration: Agent Traces feed into the Audit Trail and are used by the risk scoring algorithm for the Agent Confidence factor.

Version Compatibility

ChooChoo pins specific versions of each standard. For the complete compatibility matrix (including OpenAPI, AsyncAPI, and the ChooChoo spec itself), see the Version Compatibility reference.

You can configure which schema versions your project uses in the .choochoorc configuration file under validation.schemas. The validation engine uses these versions when checking artifacts.