Documentación

Context Packages — LeanCTX

Empaquetar, compartir y reutilizar contexto entre proyectos y equipos con bundles de contexto portables y versionados.

Context Packages te permiten capturar el conocimiento acumulado de un proyecto — hechos, estructuras de grafos, hallazgos de sesión, trampas y patrones — en un bundle portable y versionado. Exporta paquetes para compañeros de equipo, importa conocimiento de dominio de bibliotecas compartidas o carga automáticamente las convenciones del proyecto en cada inicio de sesión.

Capas del paquete

Cada paquete puede contener una o más capas. Incluye solo lo que necesites — desde hechos de conocimiento específicos hasta instantáneas completas del proyecto.

Conocimiento

Hechos persistidos, restricciones y conocimiento de dominio extraídos de tu proyecto.

Grafo

Nodos y aristas del grafo de propiedades que capturan la estructura del código, dependencias y relaciones de llamada.

Sesión

Hallazgos y decisiones de sesión de sesiones de codificación anteriores.

Patrones

Patrones de compresión de shell y reglas de formato de salida ajustadas para tu stack.

Trampas

Problemas conocidos, casos límite y advertencias que los agentes deben conocer.

Comandos CLI

Gestiona context packages completamente desde la línea de comandos. Todas las operaciones soportan salida JSON para integración CI/CD.

CommandDescription
lean-ctx pack create --name my-pkg --layers knowledge,graph Crear un paquete a partir del contexto del proyecto actual
lean-ctx pack list Listar todos los paquetes instalados con versión y estado de auto-load
lean-ctx pack info my-pkg Mostrar metadatos del paquete, capas, estadísticas y hash de integridad
lean-ctx pack export my-pkg -o my-pkg.lctxpkg Exportar un paquete a un archivo portable .lctxpkg para compartir
lean-ctx pack import my-pkg.lctxpkg Importar un paquete desde un archivo .lctxpkg al registro local
lean-ctx pack install my-pkg Instalar y fusionar el contexto del paquete en el proyecto actual
lean-ctx pack remove my-pkg Eliminar un paquete del registro local
lean-ctx pack auto-load my-pkg on Activar o desactivar la carga automática al inicio de sesión

Quick Start

# Create a package with knowledge and graph layers
lean-ctx pack create --name my-project-ctx --layers knowledge,graph

# Export for sharing
lean-ctx pack export my-project-ctx -o my-project-ctx.lctxpkg

# Teammate imports and installs
lean-ctx pack import my-project-ctx.lctxpkg
lean-ctx pack install my-project-ctx

# Enable auto-load for future sessions
lean-ctx pack auto-load my-project-ctx on

Auto-Load

Marca paquetes para carga automática. Cuando ctx_overview se ejecuta al inicio de sesión, todos los paquetes con auto-load habilitado se fusionan en el contexto activo del proyecto — hechos de conocimiento, datos de grafos y trampas están disponibles inmediatamente.

$ lean-ctx pack auto-load my-pkg on

Integridad y seguridad

Cada paquete incluye un hash de contenido SHA-256 calculado a partir de serialización JSON canónica. Las operaciones de importación verifican la integridad antes de fusionar. Todas las operaciones de archivo usan escrituras atómicas (tmp + rename) para prevenir corrupción.

$ lean-ctx pack info my-pkg

Integración

Los hechos de conocimiento importados se fusionan con limitación de confianza. Los nodos y aristas del grafo se añaden al grafo de propiedades. Las trampas se deduplican por ID. Los hallazgos de sesión enriquecen el historial. Todo se integra con el pipeline existente de LeanCTX.

Comienza a empaquetar contexto

Instala LeanCTX y crea tu primer context package en menos de un minuto.

Comenzar →