Skip to content

Glossary

Use this page when an EmbrAIon term appears before you need the full engineering model.

In plain English

Most projects can start with knowledge + policy + validation. The rest of this vocabulary matters only when the repository needs more control.

Term Meaning
Project contract The repository-owned EmbrAIon configuration and knowledge that define how AI-assisted engineering should work for this project.
Core Reusable EmbrAIon mechanisms: schemas, generic roles/skills, routing contracts, validation/review mechanics, security mechanics, and host projection behavior.
AI host The AI client that owns the conversation and its native reasoning/tools, such as Codex, GitHub Copilot, or Claude Code.
Host projection Generated host-native files that deliver the project contract to an AI host. A projection is derived output, not a second source of truth.
Knowledge Project facts and source-of-truth documents registered in .embraion/knowledge.yaml.
Project Contract Slot A built-in knowledge role such as architecture, source authority, compatibility, persistence, engineering workflow, or specification.
Policy Project-owned rules for source classes, privacy, review, protected paths, and optional enforcement.
Canonical source/path Content treated as authoritative project truth for its concern.
Protected source/path Content that AI work should not mutate unless the project explicitly permits the required path/process.
Generated source/path Derived output that should normally be regenerated from its owner rather than edited as canonical project truth.
External source/path Content owned outside the project contract, such as vendored or upstream material.
Route class A stable description of work/risk such as ordinary, substantial, or complex. It is not a permanent model tier.
host-default Routing result that leaves actual model selection to the AI host's current default/automatic behavior.
Deployment A reusable project-owned concrete model/provider choice. Think what can be selected.
Routing Rules that decide when a route or role should select a deployment or explicit host option.
Execution binding Project configuration describing how an approved deployment may be invoked through EmbrAIon's optional provider-neutral runtime.
Provider-neutral execution The optional embraion execute path where EmbrAIon owns a bounded external/API attempt loop. Ordinary host-native conversations do not pass through it.
Validation profile A named set of real project commands used to prove that a change works.
Evidence Structured records produced by validation, review, execution, or enforcement so claims can be tied to actual checks.
Review Project rules/evidence for independent or human assessment of a change.
Enforcement Deterministic delivery/merge checks for protected paths, validation, and optionally review. Text guidance alone is not enforcement.
Runtime resolution Resolving the exact EmbrAIon version pinned by a repository, including an isolated cached runtime when needed.

The four advanced words most people mix up

Concept Question
Deployment What concrete choice exists?
Routing When should it be selected?
Execution binding How may it be invoked safely?
Pricing How is provider cost interpreted/refreshed?

For the precise model, see Engineering Model Deep Dive.