Documentación

Perfiles de contexto

Estrategias de contexto declarativas y versionadas para lean-ctx

Los perfiles de contexto permiten configurar cómo lean-ctx procesa contenido para diferentes escenarios: exploración, depuración, hotfixes, CI, revisión de código y más. Piénsalo como "Context as Code" - estrategias versionadas que tu equipo puede compartir.

¿Qué son los perfiles?

Un perfil es un archivo TOML que controla los modos de lectura, ajustes de compresión, presupuestos de tokens, capas del pipeline y comportamiento autónomo. Los perfiles pueden heredar de otros perfiles y sobrescribir campos específicos.

Perfiles integrados

lean-ctx incluye 5 perfiles integrados optimizados para flujos de trabajo comunes:

exploration

Contexto amplio para comprender bases de código. Modo mapa, presupuesto de 200K tokens, preferencia de caché.

bugfix

Depuración enfocada en modo auto. Salida concisa, presupuesto de 100K tokens, puntos de control cada 10 llamadas.

hotfix

Contexto mínimo para correcciones urgentes. Modo firmas, salida ultra compacta, 30K tokens, límite de coste de $1.

ci-debug

Depuración CI/CD con 200 invocaciones de shell. Salida concisa, presupuesto de 150K tokens.

review

Revisión de código con contexto amplio de solo lectura. Modo mapa, CRP compacto, presupuesto de 150K tokens.

Activar un perfil

Establece la variable de entorno LEAN_CTX_PROFILE:

export LEAN_CTX_PROFILE=hotfix

O mediante la CLI:

lean-ctx profile set hotfix

O cambia en tiempo de ejecución a través de MCP:

ctx_session action=profile value=hotfix

Crear perfiles personalizados

Crea un archivo TOML de perfil en .lean-ctx/profiles/ (local del proyecto) o ~/.lean-ctx/profiles/ (global):

# .lean-ctx/profiles/my-team.toml
[profile]
name = "my-team"
inherits = "exploration"
description = "Team defaults with lower budget"

[read]
default_mode = "map"
max_tokens_per_file = 40000

[budget]
max_context_tokens = 120000
max_cost_usd = 2.0

O crea un perfil con la CLI:

lean-ctx profile create my-team --from exploration

Herencia de perfiles

Los perfiles pueden heredar de cualquier otro perfil usando el campo inherits. Los valores hijo sobrescriben los valores padre; los campos no definidos se heredan del padre.

# .lean-ctx/profiles/strict-review.toml
[profile]
name = "strict-review"
inherits = "review"

[budget]
max_context_tokens = 80000
max_cost_usd = 1.0

Esquema de perfil

Un perfil completo tiene estas secciones:

  • [profile] - name, inherits, description
  • [read] - default_mode, max_tokens_per_file, prefer_cache
  • [compression] - crp_mode, output_density, entropy_threshold
  • [budget] - max_context_tokens, max_shell_invocations, max_cost_usd
  • [pipeline] - intent, relevance, compression, translation (interruptores booleanos)
  • [autonomy] - auto_dedup, checkpoint_interval

Referencia CLI

  • lean-ctx profile list - Mostrar todos los perfiles disponibles
  • lean-ctx profile show <name> - Mostrar detalles del perfil
  • lean-ctx profile diff <a> <b> - Comparar dos perfiles
  • lean-ctx profile create <name> - Crear un nuevo perfil
  • lean-ctx profile set <name> - Mostrar instrucciones de activación

Orden de resolución

Los perfiles se resuelven en este orden:

  1. Variable de entorno LEAN_CTX_PROFILE
  2. .lean-ctx/profiles/<name>.toml local del proyecto
  3. ~/.lean-ctx/profiles/<name>.toml global
  4. Valores predeterminados integrados