Documentação

Perfis de contexto

Estratégias de contexto declarativas e versionadas para lean-ctx

Os perfis de contexto permitem configurar como o lean-ctx processa conteúdo para diferentes cenários: exploração, depuração, hotfixes, CI, revisão de código e mais. Pense nisso como "Context as Code" - estratégias versionadas que sua equipe pode compartilhar.

O que são perfis?

Um perfil é um arquivo TOML que controla modos de leitura, configurações de compressão, orçamentos de tokens, camadas do pipeline e comportamento autônomo. Perfis podem herdar de outros perfis e sobrescrever campos específicos.

Perfis integrados

lean-ctx inclui 5 perfis integrados otimizados para fluxos de trabalho comuns:

exploration

Contexto amplo para entender bases de código. Modo mapa, orçamento de 200K tokens, cache preferido.

bugfix

Depuração focada em modo automático. Saída concisa, orçamento de 100K tokens, checkpoints a cada 10 chamadas.

hotfix

Contexto mínimo para correções urgentes. Modo assinaturas, saída ultra compacta, 30K tokens, limite de custo de $1.

ci-debug

Depuração CI/CD com 200 invocações de shell. Saída concisa, orçamento de 150K tokens.

review

Revisão de código com contexto amplo somente leitura. Modo mapa, CRP compacto, orçamento de 150K tokens.

Ativar um perfil

Defina a variável de ambiente LEAN_CTX_PROFILE:

export LEAN_CTX_PROFILE=hotfix

Ou via CLI:

lean-ctx profile set hotfix

Ou alterne em tempo de execução via MCP:

ctx_session action=profile value=hotfix

Criar perfis personalizados

Crie um arquivo TOML de perfil em .lean-ctx/profiles/ (local do projeto) ou ~/.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

Ou crie um perfil via CLI:

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

Herança de perfis

Perfis podem herdar de qualquer outro perfil usando o campo inherits. Valores filhos sobrescrevem valores pais; campos não definidos são herdados do pai.

# .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

Um perfil completo tem estas seções:

  • [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

Referência CLI

  • lean-ctx profile list - Mostrar todos os perfis disponíveis
  • lean-ctx profile show <name> - Exibir detalhes do perfil
  • lean-ctx profile diff <a> <b> - Comparar dois perfis
  • lean-ctx profile create <name> - Criar um novo perfil
  • lean-ctx profile set <name> - Mostrar instruções de ativação

Ordem de resolução

Os perfis são resolvidos nesta ordem:

  1. Variável de ambiente LEAN_CTX_PROFILE
  2. .lean-ctx/profiles/<name>.toml local do projeto
  3. ~/.lean-ctx/profiles/<name>.toml global
  4. Valores padrão integrados