EmbrAIon¶
EmbrAIon is a portable AI-First Engineering System for making AI-assisted software development structured, reusable, reviewable, and trustworthy.
It does not replace your application runtime. It sits around the engineering process: roles, skills, project knowledge, routing, permissions, validation, and host-specific projections.
-
Start in minutes
Install one launcher, initialize a project, and install the host projection you use.
-
One canonical Core
Keep reusable engineering policy upstream while project-specific truth stays with each consuming repository.
-
Multiple AI hosts
Project the same Core into Codex, GitHub Copilot, Claude Code, or a host-neutral Portable bundle.
-
Evidence, not assumptions
Deterministic validation, behavioral evals, security checks, reference E2E, and release gates make changes observable.
The basic idea¶
A software project keeps its normal source code and runtime:
Application / Library / Game
↑
your code
EmbrAIon adds an engineering layer around that repository:
The final application does not need an EmbrAIon runtime dependency. EmbrAIon is used to organize how humans and AI agents engineer the project.
Quick start¶
pipx install embraion
cd MyProject
embraion init
embraion install --host codex --destination .
embraion doctor
embraion status
The project now has a pinned EmbrAIon version plus a generated host projection.
What EmbrAIon owns¶
| Area | Purpose |
|---|---|
| Core | Canonical reusable rules, roles, skills, workflows, routing, and knowledge |
| Project overlay | Project identity, version pin, domain knowledge, local capabilities |
| Adapters | Codex, Copilot, Claude Code, Portable, and provider-specific facts |
| Tools | Validation, security, worktrees, sessions, learning, evals, install/sync |
| Evidence | Unit/integration tests, reference E2E, behavioral evals, release gates |
See it in a real project¶
The repository ships with executable reference projects:
- Minimal — the smallest complete EmbrAIon consumer.
- Python — ordinary application code and tests wrapped by EmbrAIon.
- Unity — a runnable Unity 6 example showing that EmbrAIon lives around the project, not inside the game runtime.
Status¶
EmbrAIon is pre-1.0. Patch releases are intended to remain migration-free; minor releases may evolve public framework contracts while release notes and project pinning preserve intentional upgrades.