Skene

   

Skene liest deine Codebasis und erstellt eine User Journey für dein Produkt: die Lebenszyklus-Phasen, die ein Nutzer durchläuft, die Meilensteine innerhalb jeder Phase und die Code- oder Datenbank-Belege, die jeden Meilenstein untermauern.

Schnellstart

Installiere und starte die interaktive Terminal-UI:

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

Der Assistent führt dich durch Provider-Auswahl, Authentifizierung und Analyse — keine Konfiguration im Vorfeld nötig.

Was es tut

Skene verwandelt ein Repository in eine einzige journey.yaml, die den Nutzer-Lebenszyklus deines Produkts beschreibt, und rendert sie als interaktives Diagramm.

• Agentische Analyse — zwei parallele Agenten lesen dein Projekt: einer durchläuft die Codebasis, einer deine SQL-Schemata. Sie schlagen jeweils Kandidaten-Meilensteine vor, die dann zusammengeführt und in einen kanonischen Sieben-Phasen-Lebenszyklus klassifiziert werden.
• Sieben-Phasen-User-Journey — jedes Produkt wird auf dieselben kanonischen Phasen abgebildet (Discovery, Onboarding, Aktivierung, Engagement, Bindung, Expansion, Viralität), sodass Journeys über Produkte hinweg vergleichbar sind. Phasennamen werden bei Bedarf an dein Produkt angepasst.
• Beleggestützte Meilensteine — jeder Meilenstein trägt eine tracked_event, einen confidence-Score und einen oder mehrere evidence-Chips, die auf den genauen Codepfad, die Datenbanktabelle oder die Konfigurationsdatei verweisen, die ihn rechtfertigen.
• Journey-Visualizer — die TUI öffnet eine lokale Web-App, die die Phasen als Spalten darstellt, mit Meilenstein-Karten und klickbaren Beleg-Chips, sodass du die Journey neben dem zugrunde liegenden Quellcode überprüfen kannst.
• Nur Code, nur Schema oder beides — ausführen gegen nur eine Codebasis, nur ein Verzeichnis mit *.sql-Dateien oder beides für reichhaltigere Belege.

Unterstützt OpenAI, Gemini, Claude, LM Studio, Ollama und jeden OpenAI-kompatiblen Endpunkt.

Installation

Terminal-UI (empfohlen)

Die TUI ist ein interaktiver Assistent, der dich durch den gesamten Workflow führt. Keine Voraussetzungen — der Installer übernimmt alles.

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

# Launch it
skene

Python-CLI

Wenn du die Kommandozeile bevorzugst, kannst du Skene direkt mit uvx ausführen (keine Installation nötig) oder global installieren:

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

Nützliche Flags:

• --schema-dir <dir> — auf ein Verzeichnis mit exportierten *.sql-Dateien zeigen, um den Schema-Agenten zu aktivieren
• -o <path> — die Ausgabedatei überschreiben (Standard: ./skene-context/journey.yaml)
• --no-specialize — die kanonischen Phasennamen beibehalten, statt sie vom LLM anpassen zu lassen

Für die vollständige CLI-Nutzung siehe die Dokumentation.

Ausgabelayout

Sowohl die Python-CLI als auch die TUI schreiben Artefakte in ein einziges Bündel-Verzeichnis im Projektstamm, das bei Bedarf automatisch erstellt wird.

• Standard: ./skene-context/journey.yaml — die analysierte User Journey für dein Produkt.
• Überschreiben: setze output_dir in .skene.config oder übergib -o/--output, um woanders hinzuschreiben.

Monorepo-Struktur

Verzeichnis	Beschreibung	Sprache	Verteilung
src/skene/	CLI + Analyse-Engine	Python	PyPI
tui/	Interaktive Terminal-UI-Assistent	Go	GitHub Releases
cursor-plugin/	Cursor-IDE-Plugin	—	—

Die TUI (tui/) ist eine Bubble-Tea-App, die ein interaktives Assistenten-Erlebnis bietet und die Python-CLI über uvx orchestriert. Jedes Paket hat unabhängige CI/CD-Pipelines.

Mitwirken

Beiträge sind willkommen. Bitte öffne ein Issue oder reiche einen Pull Request ein.

Lizenz

MIT