Reference

Contracts

Position the contracts pack as the stable source of truth for workflow-facing integrations.

Contracts

Opora treats contracts as part of the product architecture, not as leftover documentation.

Contracts pack

The repository already contains a contracts pack under /contracts, including:

  • OpenAPI documents
  • workflow schema
  • event schemas
  • API response schemas

Documentation intent

The docs site should explain:

  • which contracts are public
  • how versioning is handled
  • which surfaces are stable versus evolving
  • where developers should start