Para las personas
Cualquiera del equipo puede leer la misma capa de contexto que se indica a los agentes. leji view abre la capa de contexto compartida, presentada de forma legible en el navegador.
/LEH-jee/◆Especificación y utillaje abiertos
Haga su contexto
legible.
Leji reúne la intención dispersa entre los chats del equipo y las instrucciones de cada herramienta en un único lugar: una capa de contexto compartida que pertenece al equipo y que este revisa. Estandariza la forma y la gobernanza, no el contenido. Personas y agentes ahora pueden leer la misma fuente, y el utillaje de validación hace visible la desviación.
Traducción asistida por agentes de IA. Ante cualquier diferencia, prevalece la página en inglés. Si encuentra algún problema en el texto, abra un issue o envíe un pull request.
$ leji adopt --yes --wire-adapters Wrote 16 files (context root: docs/): .leji/work/onboarding-brief.md AGENTS.md docs/agents/core.md … $ leji validate ok (0 errors, 0 warnings) $ leji conformance ok (0 errors, 0 warnings; claimedLevel: core, verifiedLevel: core, processAttested: 4)
npm install -g @leji-org/lejiLibre y de código abierto · Apache-2.0 · CC-BY-4.0
Adopción, no migración
Empiece por el repositorio que ya tiene.
La CLI genera el andamiaje de una capa de contexto sobre el árbol que ya tiene. Nada se mueve, y un punto de entrada solo cambia cuando usted lo pide con --wire-adapters.
- Primero
Genera el andamiaje alrededor de su árbol
adoptreutiliza su raíz de documentación, siembra los archivos de índice de categoría y copia a la capa de contexto lo que ya dice su punto de entrada de agente. Nada de lo que usted escribió se mueve, y ningún punto de entrada se reescribe hasta que lo pide con--wire-adapters. - Después
Su agente propone el mapeo
El brief de incorporación hace que su agente lea el repositorio y proponga qué documentos corresponden a cada categoría. Usted revisa esa propuesta como cualquier otro cambio.
- En adelante
Y gobierna desde ahí
Los cambios pasan por el proceso de revisión y aprobación de su repositorio. La validación en integración continua detecta la desviación, y los horizontes de vigencia señalan el contexto que ha envejecido.
La leen las personas, la alcanzan los agentes
Una fuente, dos audiencias.
Un registro de cómo piensa su equipo, propiedad del repositorio: lenguaje del dominio, restricciones, decisiones, convenciones y salvaguardas para los agentes. Una sola fuente, modificada a través de un único proceso de revisión y aprobación.
Capa de contexto compartidase cambia mediante revisión
Para los agentes
Los agentes entran por el perfil de arranque, el único archivo que dice qué cargar antes de una tarea; los archivos de punto de entrada (AGENTS.md, CLAUDE.md) redirigen allí en vez de llevar su propia copia. El servidor MCP les entrega la especificación y los esquemas y les permite validarla y puntuar la conformidad de forma nativa.
Conformidad
Declare un nivel y después compruébelo.
Cuatro niveles acumulativos, definidos por los requisitos implantados y no por una madurez autoevaluada. La mayoría de los equipos llegan a governed y se quedan ahí. La CLI comprueba lo que puede comprobar una máquina; de lo demás responde su equipo.
- coreContexto compartido del equipomanifiesto, perfil de arranque, contenido real, una primera decisión y un responsable con nombre.
- indexedLegible para el utillajeun índice generado y un registro de cambios legible por máquinas.
- governedRevisado, con la desviación comprobadarevisión por pull request, perfiles de agente, integración continua y horizontes de vigencia comprobados.
- federatedPráctica de toda la organizaciónun montaje fijado en otros repositorios, con informe de fijaciones desactualizadas. Cómo funciona la federación.
Por qué está construido así
Intención duradera, compartida en círculo, verificada mediante mecanismos.
La intención antes que las instrucciones
La intención duradera corresponde a una única capa de contexto revisada, de la que personas y agentes derivan sus acciones. Los puntos de entrada de proveedor redirigen allí, de modo que el contexto de un equipo nativo de IA sobrevive a cualquier herramienta. Por qué dura la intención.
Un círculo, no un escalafón
Persona-a-persona, persona-a-IA y persona-a-IA-a-persona son flujos de primera clase alrededor de una capa de contexto compartida. Todos leen, cualquiera propone y las personas aprueban mediante pull requests. Por qué funciona el círculo.
Mecanismo antes que buena voluntad
La realidad cambia y el contexto compartido se degrada. La revisión de código, las comprobaciones automáticas de desviación y los horizontes de vigencia sistematizan el mantenimiento; el contexto desactualizado nunca se trata en silencio como si estuviera vigente. Por qué importan los mecanismos.
El punto de entrada para máquinas
Un solo archivo de manifiesto
Su árbol docs/ existente es conforme por mapeo, no por renombrado. Un único leji.json en la raíz del repositorio declara la raíz del contexto, el perfil de arranque, las asignaciones de categoría y la declaración de conformidad.
La capa de contexto más limpia no necesita archivos de proveedor en absoluto: la invocación apunta el host de agente directamente al perfil de arranque, o leji start abre allí un host detectado.
Los archivos de punto de entrada son punteros, no lugares donde guardar el contexto. AGENTS.md es el puntero portable que leen muchos hosts de agente; la guía de adopción cubre el resto.
{
"leji": "1.0",
"name": "acme-billing-context",
"description": "Shared context layer for this repository.",
"rootPath": "docs/",
"bootProfilePath": "docs/boot-profile.md",
"categories": {
"domain": { "indexes": ["docs/context/domain.md"] },
"system": { "indexes": ["docs/context/system.md"] },
"governance": { "indexes": ["docs/context/governance.md"] },
"decisions": { "indexes": ["docs/context/decisions.md"] }
},
"owners": { "primary": { "name": "Acme Platform Team", "contact": "platform@acme.example" } },
"conformance": { "claimedLevel": "core" },
"vendorAdapters": ["AGENTS.md"]
}