Guides
Modelling a domain
Define domain boundaries, owned models, and vocabulary before wiring workflows or kernels.
- Guides
- 1 min read
Scope
This guide covers how to declare a Catoids domain with explicit ownership. Prerequisites: Core concepts and Installation.
Establish boundaries
List what the domain owns (entities, policies, decision types) and what it does not (shared platform services, other kernels' mandates). Prefer sharp edges over convenience merges.
Name the vocabulary
Publish the terms operators and developers will use in schemas and APIs. Align UI labels and API fields to that vocabulary so knowledge artefacts stay coherent.
Version the model
Treat domain schemas as versioned artefacts. Breaking field renames belong in release notes for consuming kernels and adapters.
Validate before orchestration
Confirm domain publication and read APIs before attaching workflows. Premature orchestration tends to encode unstable shapes.