Skip to content

Substrate Definition Artifact

Path:

config/domains/<domain_id>/cortices/<cortex-id>.md

Conceptual note:

  1. This file is the Domain Bundle serialization artifact for one substrate definition.
  2. In current bundle versions that substrate definition is represented using kind: cortex.
Field Type Notes
kind string Must be cortex in the current artifact version.
id string Must match the root reference id.
builder-id string Builder identity for substrate launch and synthesis resolution.
role string Example: comms, memory, internal.
lamina string Leaf lamina identifier, for example SensoryCortexLamina.
description string Human-readable summary.
launch mapping Runtime launcher configuration.

Comms-specific required fields (role: comms):

Field Type Notes
channel string Example: cli.
protocol string Example: request-response.
requires-session-id bool Session requirement flag.
Field Type Notes
launch.launcher string Current MVP value is inprocess.
launch.target.module-path string Python module import path.
launch.target.symbol-name string Callable symbol to invoke.
Field Type Notes
modulation mapping Modulator overrides and request semantics.
metadata mapping Additional runtime or operational metadata.

All markdown keys in this artifact are kebab-case.

  1. Use builder-id, not builder_id.
  2. Use module-path, not module_path.
  3. Use requires-session-id, not requires_session_id.

Value exceptions:

  1. Python import and symbol values are not reformatted.
  2. Free-form downstream payloads inside metadata and modulator config may use snake_case when required by external systems.