Skene

   

O Skene lê seu código e produz uma jornada do usuário para o seu produto: os estágios do ciclo de vida pelos quais um usuário passa, os marcos dentro de cada estágio e as evidências de código ou banco de dados que comprovam que cada marco é real.

Início Rápido

Instale e inicie a interface de terminal interativa:

curl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash
skene

O assistente guia você pela seleção do provedor, autenticação e análise — sem necessidade de configuração prévia.

O Que Ele Faz

O Skene transforma um repositório em um único journey.yaml descrevendo o ciclo de vida do usuário do seu produto e o renderiza como um diagrama interativo.

• Análise agêntica — dois agentes paralelos leem seu projeto: um percorre o código, outro percorre seus esquemas SQL. Cada um propõe marcos candidatos, que são então mesclados e classificados em um ciclo de vida canônico de sete estágios.
• Jornada do usuário em sete estágios — todo produto mapeia para os mesmos estágios canônicos (descoberta, integração, ativação, engajamento, retenção, expansão, viralidade) para que as jornadas sejam comparáveis entre produtos. Os nomes dos estágios são especializados para o seu produto quando útil.
• Marcos com respaldo de evidências — cada marco carrega um tracked_event, uma pontuação de confidence e um ou mais chips de evidence apontando de volta para o caminho exato do código, tabela de banco de dados ou arquivo de configuração que o justifica.
• Visualizador de jornada — a TUI abre um aplicativo web local que organiza os estágios em colunas, com cartões de marcos e chips de evidências clicáveis, para que você possa revisar a jornada junto com o código-fonte subjacente.
• Somente código, somente esquema, ou ambos — execute apenas com um código-base, apenas com um diretório de arquivos *.sql, ou ambos para evidências mais ricas.

Suporta OpenAI, Gemini, Claude, LM Studio, Ollama e qualquer endpoint compatível com OpenAI.

Instalação

Interface de Terminal (recomendada)

A TUI é um assistente interativo que guia você por todo o fluxo de trabalho. Sem pré-requisitos — o instalador cuida de tudo.

# Install the TUI
curl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash

# Launch it
skene

CLI Python

Se você preferir a linha de comando, pode executar o Skene diretamente com uvx (sem necessidade de instalação) ou instalá-lo globalmente:

# Install uv (if you don't have it)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Run directly (no install needed)
uvx skene analyse-journey .

# Or install globally
pip install skene
skene analyse-journey .

Flags úteis:

• --schema-dir <dir> — aponte para um diretório de arquivos *.sql exportados para habilitar o agente de esquema
• -o <path> — substitua o arquivo de saída (padrão ./skene-context/journey.yaml)
• --no-specialize — mantenha os nomes canônicos dos estágios em vez de permitir que o LLM os especialize

Para uso completo da CLI, consulte a documentação.

Layout de Saída

Tanto a CLI Python quanto a TUI gravam artefatos em um único diretório de pacote na raiz do seu projeto, criado automaticamente se não existir.

• Padrão: ./skene-context/journey.yaml — a jornada do usuário analisada para o seu produto.
• Substituição: defina output_dir em .skene.config ou passe -o/--output para gravar em outro local.

Estrutura do Monorepo

Diretório	Descrição	Linguagem	Distribuição
src/skene/	CLI + mecanismo de análise	Python	PyPI
tui/	Assistente interativo de interface de terminal	Go	GitHub Releases
cursor-plugin/	Plugin do IDE Cursor	—	—

A TUI (tui/) é um aplicativo Bubble Tea que fornece uma experiência de assistente interativo e orquestra a CLI Python via uvx. Cada pacote tem pipelines de CI/CD independentes.

Contribuindo

Contribuições são bem-vindas. Por favor, abra uma issue ou envie um pull request.

Licença

MIT