Skip to content
RunContext Docs

context new

The new command scaffolds a new semantic plane — an OSI model with companion governance and rules files — inside your existing project.

Usage

Section titled “Usage”
Terminal window
context new <name>

Arguments

Section titled “Arguments”
ArgumentDescription
nameName for the semantic plane (e.g. sales-analytics, inventory)

Options

Section titled “Options”
OptionDescriptionDefault
--source <name>Bind to a named data source from contextkit.config.yaml—
--context-dir <path>Path to context directorycontext/

Examples

Section titled “Examples”

Scaffold a new semantic plane

Section titled “Scaffold a new semantic plane”
Terminal window
context new sales-analytics

Creates:

context/
├── models/sales-analytics.osi.yaml
├── governance/sales-analytics.governance.yaml
├── governance/sales-analytics.rules.yaml
└── owners/default-team.owner.yaml

Bind to a specific data source

Section titled “Bind to a specific data source”
Terminal window
context new inventory --source warehouse

The scaffolded model includes a data_source: warehouse reference matching your config:

contextkit.config.yaml
data_sources:
  warehouse:
    adapter: postgres
    connection: postgres://localhost:5432/warehouse

Multiple semantic planes

Section titled “Multiple semantic planes”

A single RunContext project can contain multiple semantic planes. Each is an independent model with its own governance, rules, and tier score:

Terminal window
context new sales-analytics --source crm
context new inventory --source warehouse
context new marketing-attribution --source analytics-db

All semantic planes compile together and are served through the same MCP server. Run context tier to see the scorecard for each, or context blueprint to export their AI Blueprints.

Next steps

Section titled “Next steps”