Context Packages — LeanCTX

Os Context Packages permitem capturar o conhecimento acumulado de um projeto — fatos, estruturas de grafo, descobertas de sessão, armadilhas e padrões — em um bundle portátil e versionado. Exporte pacotes para colegas de equipe, importe conhecimento de domínio de bibliotecas compartilhadas ou carregue automaticamente as convenções do projeto a cada início de sessão.

Camadas do Pacote

Cada pacote pode conter uma ou mais camadas. Inclua apenas o que você precisa — desde fatos de conhecimento específicos até snapshots completos do projeto.

Knowledge

Fatos persistidos, restrições e conhecimento de domínio extraídos do seu projeto.

Graph

Nós e arestas do property graph capturando estrutura do código, dependências e relações de chamada.

Session

Descobertas e decisões de sessão de sessões de desenvolvimento anteriores.

Patterns

Padrões de compressão shell e regras de formatação de saída ajustados para sua stack.

Gotchas

Armadilhas conhecidas, casos extremos e avisos que os agentes devem conhecer.

Comandos CLI

Gerencie context packages inteiramente pela linha de comando. Todas as operações suportam saída JSON para integração CI/CD.

Command	Description
`lean-ctx pack create --name my-pkg --layers knowledge,graph`	Criar um pacote a partir do contexto do projeto atual
`lean-ctx pack list`	Listar todos os pacotes instalados com versão e status de carregamento automático
`lean-ctx pack info my-pkg`	Mostrar metadados, camadas, estatísticas e hash de integridade do pacote
`lean-ctx pack export my-pkg -o my-pkg.lctxpkg`	Exportar um pacote para um arquivo .lctxpkg portátil para compartilhamento
`lean-ctx pack import my-pkg.lctxpkg`	Importar um pacote de um arquivo .lctxpkg para o registro local
`lean-ctx pack install my-pkg`	Instalar e mesclar o contexto do pacote no projeto atual
`lean-ctx pack remove my-pkg`	Remover um pacote do registro local
`lean-ctx pack auto-load my-pkg on`	Ativar ou desativar o carregamento automático no início da sessão

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

Carregamento Automático

Marque pacotes para carregamento automático. Quando ctx_overview é executado no início da sessão, todos os pacotes com carregamento automático ativado são mesclados no contexto ativo do projeto — fatos de conhecimento, dados de grafo e armadilhas ficam imediatamente disponíveis.

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

Integridade & Segurança

Cada pacote inclui um hash de conteúdo SHA-256 calculado a partir da serialização JSON canônica. As operações de importação verificam a integridade antes da mesclagem. Todas as operações de arquivo usam escritas atômicas (tmp + renomeação) para prevenir corrupção.

$ lean-ctx pack info my-pkg

Integração

Fatos de conhecimento importados são mesclados com limitação de confiança. Nós e arestas do grafo são adicionados ao property graph. Gotchas são deduplicados por identificador. Descobertas de sessão enriquecem o histórico. Tudo se integra com o pipeline LeanCTX existente.

Comece a Empacotar Contexto

Instale o LeanCTX e crie seu primeiro context package em menos de um minuto.

Começar →