Dokumentation

Kontextprofile

Deklarative, versionierbare Kontextstrategien für lean-ctx

Kontextprofile bestimmen, wie lean-ctx Inhalte für verschiedene Szenarien verarbeitet: Exploration, Debugging, Hotfixes, CI, Code Reviews und mehr. Denk daran als "Context as Code" - versionierbare Strategien, die dein Team teilen kann.

Was sind Profile?

Ein Profil ist eine TOML-Datei, die Lesemodi, Kompressionseinstellungen, Token-Budgets, Pipeline-Schichten und Autonomie-Verhalten steuert. Profile können von anderen Profilen erben und bestimmte Felder überschreiben.

Eingebaute Profile

lean-ctx liefert 5 eingebaute Profile für gängige Workflows:

exploration

Breiter Kontext zum Verstehen von Codebasen. Map-Modus, 200K Token-Budget, Cache bevorzugt.

bugfix

Fokussiertes Debugging im Auto-Modus. Knappe Ausgabe, 100K Token-Budget, Checkpoints alle 10 Aufrufe.

hotfix

Minimaler Kontext für dringende Fixes. Signaturen-Modus, ultrakompakte Ausgabe, 30K Tokens, $1 Kostenlimit.

ci-debug

CI/CD-Debugging mit 200 Shell-Aufrufen. Knappe Ausgabe, 150K Token-Budget.

review

Code-Review mit breitem Nur-Lese-Kontext. Map-Modus, kompaktes CRP, 150K Token-Budget.

Profil aktivieren

Setze die LEAN_CTX_PROFILE Umgebungsvariable:

export LEAN_CTX_PROFILE=hotfix

Oder per CLI:

lean-ctx profile set hotfix

Oder zur Laufzeit per MCP wechseln:

ctx_session action=profile value=hotfix

Eigene Profile erstellen

Erstelle eine Profil-TOML-Datei in .lean-ctx/profiles/ (projektlokal) oder ~/.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

Oder per CLI ein Profil erstellen:

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

Profilvererbung

Profile können von jedem anderen Profil erben, indem das Feld inherits verwendet wird. Kind-Werte überschreiben Eltern-Werte; nicht gesetzte Felder werden vom Elternprofil übernommen.

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

[budget]
max_context_tokens = 80000
max_cost_usd = 1.0

Profilschema

Ein vollständiges Profil hat folgende Abschnitte:

  • [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 (boolesche Schalter)
  • [autonomy] - auto_dedup, checkpoint_interval

CLI-Referenz

  • lean-ctx profile list - Alle verfügbaren Profile anzeigen
  • lean-ctx profile show <name> - Profildetails anzeigen
  • lean-ctx profile diff <a> <b> - Zwei Profile vergleichen
  • lean-ctx profile create <name> - Neues Profil erstellen
  • lean-ctx profile set <name> - Aktivierungsanleitung anzeigen

Auflösungsreihenfolge

Profile werden in dieser Reihenfolge aufgelöst:

  1. LEAN_CTX_PROFILE Umgebungsvariable
  2. Projektlokale .lean-ctx/profiles/<name>.toml
  3. Globale ~/.lean-ctx/profiles/<name>.toml
  4. Eingebaute Standardwerte