Zum Inhalt springen

Projekt-Konfiguration

Dein Projekt.Deine Regeln.

Architektur, Konventionen und Freigaben gehören nicht in jeden neuen Prompt. Gib Lurus Code einen nachvollziehbaren Projektrahmen – von LURUS.md bis zu Tools und Berechtigungen.

Ein Rahmen, der im Projekt bleibtIllustrativer Workflow
LURUS.md

Architektur

TypeScript im Strict Mode

Konventionen

Bestehende Projektmuster verwenden

Qualitätskontrolle

Änderungen mit Tests prüfen

Der Rahmen für deine Arbeit

Projektwissen statt Wiederholung

Einmal festhalten. Bei der nächsten Aufgabe darauf aufbauen.

Projektkontext und Regeln stehen direkt neben der Arbeit. Du legst den Standard fest – statt ihn bei jedem neuen Prompt erneut zu erklären.

Bestehende Lurus-Code-Aufnahme als Einblick in die Produktoberfläche und die Arbeit im Projekt.
Ein Blick auf Lurus Code
Bestehende Lurus-Code-Aufnahme als Einblick in die Produktoberfläche und die Arbeit im Projekt.
Ein Blick auf Lurus Code

Der Rahmen für deine Arbeit

Konfigurations-Hierarchie

Jede Ebene überschreibt die vorherige. Von global bis Environment - volle Kontrolle über jeden Aspekt.

Layered Configuration mit LURUS.md, Settings, Rules und Hooks. Globale Defaults, projektspezifische Overrides und Environment-Variablen - alles perfekt orchestriert.

  • 5 Konfigurations-Layer
  • 30+ Optionen
  • Hot-Reload

Vom globalen Standard zum konkreten Projekt

  1. 01

    Global Settings

    ~/.lurus/settings.json

    Benutzerweite Einstellungen die für alle Projekte gelten. API-URL, Standard-Model, Plugins und mehr.

  2. 02

    Project Settings

    .lurus/settings.json

    Projektspezifische Einstellungen die globale überschreiben. Permissions, Hooks und MCP-Server.

  3. 03

    LURUS.md

    LURUS.md

    Projekt-Instruktionen in Markdown. Beschreibt Architektur, Konventionen und Workflows für die KI.

  4. 04

    Rules

    .lurus/rules/*.md

    Modulare Regeln mit YAML-Frontmatter. Glob-Patterns, Prioritäten und bedingte Aktivierung.

  5. 05

    Environment

    LURUS_* env vars

    Umgebungsvariablen überschreiben alle anderen Einstellungen. Ideal für CI/CD und Secrets.

Projektwissen statt Wiederholung

Projekt-Instruktionen in Markdown

Die LURUS.md Datei ist das Herzstück deiner Projekt-Konfiguration. Hier beschreibst du Architektur, Konventionen und Workflows - die KI versteht und befolgt sie.

  • Projekt-Architektur dokumentieren
  • Coding-Konventionen definieren
  • Workflow-Beschreibungen
  • Wichtige Hinweise und Warnungen
  • @import für externe Dateien
LURUS.mdCodebeispiel
# Project: E-Commerce Platform

## Architecture
- Next.js 14 with App Router
- TypeScript strict mode
- Prisma ORM with PostgreSQL
- Tailwind CSS for styling

## Conventions
- Use Server Components by default
- Client Components only when needed
- All API routes in /app/api/
- Zod for validation

## Compact Instructions
When context is limited, focus on:
1. Type safety first
2. Server-side rendering
3. Prisma schema changes

## Workflow
1. Create feature branch
2. Write tests first (TDD)
3. Implement feature
4. Run `npm run lint && npm test`

@./docs/api-guidelines.md
@./docs/database-schema.md

Regeln dort, wo sie gebraucht werden

Modulare Rules mit Frontmatter

Organisiere Projekt-Regeln in separaten Markdown-Dateien. YAML-Frontmatter für Metadaten, Glob-Patterns und Prioritäten.

  1. 01

    YAML Frontmatter

    Jede Rule-Datei kann Metadaten im YAML-Format enthalten: description, globs, alwaysApply und priority.

  2. 02

    Glob Patterns

    Rules können auf bestimmte Dateitypen beschränkt werden: ["*.tsx", "src/components/**"]

  3. 03

    Prioritäten

    Höhere Priorität = früher im Kontext. Wichtige Rules werden zuerst geladen.

  4. 04

    Bedingte Aktivierung

    alwaysApply: false - Rule wird nur bei passenden Globs aktiviert.

.lurus/rules/react-components.md
---
description: "React component conventions"
globs: ["*.tsx", "src/components/**"]
alwaysApply: false
priority: 10
---

# React Component Rules

## File Structure
- One component per file
- Use named exports
- Co-locate styles and tests

## Naming
- PascalCase for components
- camelCase for hooks
- Prefix hooks with "use"

## Props
- Define interface above component
- Use destructuring
- Provide default values

## State
- Prefer useState for simple state
- useReducer for complex state
- Avoid prop drilling — use context

Werkzeuge mit klaren Leitplanken

Model Context Protocol

Erweitere Lurus Code mit externen MCP-Servern. Filesystem, Datenbanken, APIs - alles integrierbar.

mcpServers · settings.json
{
  "filesystem": {
    "command": "npx",
    "args": [
      "-y",
      "@modelcontextprotocol/server-filesystem"
    ],
    "env": {
      "NODE_ENV": "production"
    },
    "cwd": "/path/to/project",
    "timeout": 30000,
    "trust": true,
    "includeTools": [
      "read_file",
      "write_file"
    ],
    "excludeTools": [
      "delete_file"
    ]
  }
}

Pre & Post Hooks

Führe automatisch Befehle vor oder nach Tool-Aufrufen aus. Linting, Formatting, Tests - alles automatisiert.

hooks · settings.json
{
  "hooks": {
    "pre:Write": [
      {
        "matcher": "*.ts",
        "hooks": [
          {
            "type": "command",
            "command": "eslint --fix ${file}",
            "timeout": 10000
          }
        ]
      }
    ],
    "post:Bash": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "echo 'Command completed'"
          }
        ]
      }
    ]
  }
}

Du bestimmst den Spielraum

Berechtigungen konfigurieren

Definiere erlaubte und verbotene Tools und Befehle. Projekt-spezifisch oder global - volle Kontrolle über die KI.

  • allow/deny für Tools
  • allowedCommands für Bash
  • deniedCommands blocken
  • bashAutoApprove für CI/CD
permissions · settings.json
{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep"
    ],
    "deny": [
      "rm -rf",
      "sudo"
    ],
    "allowedCommands": [
      "npm test",
      "npm run build",
      "git status"
    ],
    "deniedCommands": [
      "rm -rf /",
      "chmod 777"
    ],
    "bashAutoApprove": false
  }
}

Technische Referenz

Alle Konfigurations-Optionen

Über 30 Optionen für maximale Kontrolle. In settings.json oder als Environment-Variable.

Modelle & API
apiUrl
API-Endpunkt string · Standardwert: https://api.lurus.ai
model
Standard-Modell string · Standardwert: sonnet
fallbackModel
Fallback bei Überlastung string
utilityModel
Modell für interne Tasks string · Standardwert: haiku
compactionModel
Modell für Komprimierung string
modelAliases
Eigene Modell-Aliase object · Standardwert: {}
Kontext & Tokens
maxTokens
Max. Output-Tokens number
contextBudget
Token-Budget für Kontext number · Standardwert: 15000
truncateToolOutput
Tool-Output kürzen number
promptCaching
Prompt-Caching aktivieren boolean · Standardwert: true
Thinking & Effort
thinkingMode
auto | adaptive | enabled | off string · Standardwert: auto
thinkingBudget
Token-Budget für Thinking number
effort
high | medium | low string
maxMode
Volles Context-Window nutzen boolean · Standardwert: false
Automatisierung
autoLint
Auto-Lint nach Änderungen string|boolean · Standardwert: false
autoTest
Auto-Test nach Änderungen string|boolean · Standardwert: false
autoTypeCheck
Auto-TypeCheck string|boolean · Standardwert: false
tddGuard
off | warn | strict string · Standardwert: off
Kosten & Limits
costWarningThreshold
Warnung bei Kosten (EUR) number
costLimit
Hartes Kostenlimit (EUR) number
Sicherheit
security.injectionScanner
Injection-Scanner boolean · Standardwert: true
security.secretMasking
Secret-Maskierung boolean · Standardwert: true
security.customPatterns
Eigene Regex-Patterns string[] · Standardwert: []
disableBypassPermissions
Bypass verbieten boolean · Standardwert: false

Konfiguration verwalten

Slash-Commands für schnellen Zugriff

/config

Aktuelle Konfiguration anzeigen

/rules

Geladene Rules auflisten

/rules show <name>

Rule-Inhalt anzeigen

/rules create

Neue Rule erstellen

/init

LURUS.md generieren

/mcp

MCP-Server Status

/mcp restart <name>

MCP-Server neustarten

/model <name>

Modell wechseln

/utilitymodel <name>

Utility-Modell setzen

Mach aus Projektwissen einen gemeinsamen Standard.

Beginne mit den Konventionen, die dein Team ohnehin nutzt. Ergänze Regeln, Tools und Freigaben genau dort, wo dein Workflow sie braucht.

Eine bewusste Entscheidung

Vor dem ersten Prompt.

Interaktive Demo
Lurus Codeprivacy-demo · beispielhafter Workspace

Demo-Sitzung bereit. Modellwahl und Datenweg sind getrennte Entscheidungen.

Inszeniertes Beispiel. Keine echte Anmeldung, Sicherheitsprüfung oder Codeübertragung.

Bildvorschau