An open specification for the shared context layer of AI-native teams. Leji (from the word legible, pronounced LEH-jee) defines a versioned, repo-owned context layer of how a team thinks: domain language, constraints, decision records, conventions, agent guardrails, all read by people and AI agents on every task and updated through the same review gate.
Status: 1.2.0. The reference SDKs (
@leji-org/lejion npm and JSR,lejion PyPI, and the Go module) are at 1.2.0; the specification and schemas remain on the v1.0 line. They version together as a coherent v1; see spec/versioning.md for how each evolves from here.
- Intent over instructions. Most AI adoption writes imperative, per-tool instructions. Leji captures durable intent: what things mean, what must hold, why it is so, and lets people and agents derive actions from declared intent plus task context.
- A circle, not a tier. Human-to-human, human-to-AI, and human-to-AI-to-human are first-class flows around one shared context layer. Equal access, not equal authority: everyone with access to a context layer reads all of it, anyone proposes, people approve. Access is the version control system's to grant; restricted context lives in its own permissioned layer.
The name is the thesis: the context layer makes a team's operating context legible to everyone working in it, human or agent.
| Path | Contents |
|---|---|
spec/ |
The normative specification (CC-BY-4.0) |
schemas/ |
JSON Schemas for the machine-readable parts (Apache-2.0) |
templates/ |
Copyable starters: boot profile, core profile, category skeletons |
examples/ |
Reference context layers: monorepo and multi-repo (submodule) |
adoption/ |
Adoption guides: monorepo, multi-repo setup, vendor-adapter wiring |
rationale/ |
Non-normative: why a circle, why intent, why this is not a wiki |
packages/sdk, sdk-py, sdk-go |
The reference SDKs and CLI (npm, PyPI, Go), behaviorally identical and tested against the shared fixtures/: validate, index, changelog, freshness, conformance, init |
packages/site/ |
The spec website (plain Astro; deployable by anyone) |
Code, schemas, templates, and the SDK: Apache-2.0. Specification prose and rationale: CC-BY-4.0. See LICENSE.md.
See GOVERNANCE.md. Leji was created by Vuong Nguyen; Meteor Dreams is the current steward.