Agent Guide

Ein eigenständiger Verhaltens-Leitfaden für KI-Agenten, die über MCP mit LedgerLou arbeiten. Legen Sie die Datei im Kontext-Fenster Ihres Agenten ab — als CLAUDE.md, .cursorrules oder im System-Prompt — um die Einhaltung der Buchhaltungsregeln clientseitig sicherzustellen.

Download

agent-guide.md (English) | agent-guide-german.md (Deutsch)

Sofort einsetzbar. Im Projekt-Root oder Agent-Konfigurationsverzeichnis ablegen.

MCP-Ressource

Der Leitfaden ist auch als MCP-Ressource verfügbar. Clients mit resources/read-Unterstützung können ihn zur Laufzeit abrufen:

URI: ledgerlou://agent-guide      (English)
URI: ledgerlou://agent-guide/de   (Deutsch)
MIME: text/markdown

Skills vs. dieser Leitfaden

Über diesen übergreifenden Leitfaden hinaus liefert der MCP-Server aufgaben-spezifische Playbooks als MCP-Prompts. Der Leitfaden vermittelt das Verhalten (Bestätigungen, Kontensuche, Steuerdisziplin); die Skills erklären konkret, wie ein Workflow auszuführen ist (Monatsabschluss, Rechnung verarbeiten, Bank abstimmen).

Wann was geladen wird

Diesen Leitfaden immer laden — im System-Prompt ablegen, damit jeder Turn die Grundregeln respektiert.
Skill bei Bedarf laden — prompts/list zur Entdeckung, dann prompts/get vor dem jeweiligen Workflow.
Scope-gated — ein Skill erscheint nur in prompts/list, wenn der Aufrufer alle erforderlichen Scopes hält.
Locale-aware — der Server wählt EN/DE automatisch anhand der Mandanten-Locale; Agenten können mit args.locale überschreiben.

Integrierte Skills

process_incoming_invoice — Kreditoren-Workflow (OCR → Lieferant → Aufwandskonto → Steuer-Szenario → Buchung → Rechnungssatz).
process_outgoing_invoice — Debitoren-Workflow inkl. Gutschriften.
reconcile_bank_transactions — candidate_kind-Semantik, Splits, Bulk + Recovery.
tenant_setup_migration — Neumandanten-Bootstrap + Migration (nur admin, benötigt config:write).

Clients ohne Prompt-Unterstützung

Wenn Ihr Client MCP-Prompts nicht anzeigt, können Sie den Skill-Markdown direkt als Ressource abrufen:

URI: ledgerlou://skills/process_incoming_invoice         (English)
URI: ledgerlou://skills/process_incoming_invoice/de      (Deutsch)
URI: ledgerlou://skills/process_outgoing_invoice[/de]
URI: ledgerlou://skills/reconcile_bank_transactions[/de]
URI: ledgerlou://skills/tenant_setup_migration[/de]
MIME: text/markdown

Pro Skill stehen eine englische und eine deutsche Variante bereit. Das /de-Suffix liefert das deutsche Playbook.

Verwendungsbeispiele

Claude CLAUDE.md

Datei als CLAUDE.md im Projekt-Root ablegen. Claude Code und Claude Desktop laden sie automatisch in den Kontext.

cp agent-guide.md ./CLAUDE.md

Cursor .cursorrules

Cursor lädt .cursorrules aus dem Projekt-Root als Instruktionen auf System-Ebene.

cp agent-guide.md ./.cursorrules

Custom System-Prompt

Für eigene Agenten oder Frameworks den Inhalt des Leitfadens im System-Prompt einbinden oder zur Laufzeit über die MCP-Ressource-URI laden.

const guide = await mcpClient.readResource("ledgerlou://agent-guide");
systemPrompt += guide.contents[0].text;

Warum clientseitiges Prompting?

Server-Instruktionen allein reichen nicht aus

Nicht alle MCP-Clients zeigen server_instructions prominent an — manche Clients ignorieren oder depriorisieren sie, was die Einhaltung verringert.
Clientseitiger Kontext ist immer geladen — ob als CLAUDE.md, .cursorrules oder System-Prompt, die Regeln sind ab dem ersten Turn präsent.
Übergeordneter Kontext — der Leitfaden erklärt, was LedgerLou ist, wie deutsche Buchführung funktioniert, typische Fehler und die Fachbegriffe. Die Protokoll-Instruktionen konzentrieren sich auf Tool-spezifische Regeln.
Redundanz verbessert die Einhaltung — die Wiederholung kritischer Regeln in Server- und Client-Kontext reduziert halluzinierte Kontonummern, übersprungene Bestätigungen und fehlerhafte Steuerbehandlung signifikant.

Vollständiger Leitfaden

Der komplette Leitfaden ist unten dargestellt. Für die Markdown-Rohdatei den Download-Link oben verwenden.

Grundregeln

Immer bestätigen lassen vor Schreibvorgängen — Zusammenfassung zeigen und auf explizite Freigabe warten.
Konten immer nachschlagen — search_accounts / list_accounts verwenden. Niemals Kontonummern raten.
Steuerschlüssel immer nachschlagen — list_tax_codes aufrufen. Niemals Steuerschlüssel annehmen.
Steuerliche Behandlung bestätigen lassen — Steuersatz, Klassifikation, Schlüssel und Beträge zeigen. Pflicht.
Lesende Tools brauchen keine Bestätigung — Abfrage-Tools dürfen frei aufgerufen werden.

Automatische Steuerzeilen

Wenn tax_code an einer Buchungszeile gesetzt ist, erzeugt LedgerLou die Steuerkonteneinträge automatisch. Nur Sachkontozeilen mit Bruttobeträgen angeben. Niemals manuelle Steuerzeilen (1406, 3806 usw.) zusammen mit tax_code verwenden.

Wichtige Workflows

Eingangsrechnung: list_inbox_documents → list_vendors → create_vendor → search_accounts → Steuer bestätigen → post_booking → create_invoice → confirm_inbox_document → reconcile (open_liability)
Ausgangsrechnung: list_customers → create_customer → search_accounts → Steuer bestätigen → post_booking → create_outgoing_invoice → reconcile (open_receivable)
Gutschrift: post_booking (Storno) → create_outgoing_invoice (type=credit_note)

Bankabstimmung

Transaktionstyp	candidate_kind
Kreditorenzahlung	`open_liability`
Debitorenzahlung	`open_receivable`
Gebühren, Umbuchungen, Sonstiges	`bank_booking`

Häufige Fehler

bank_booking für Kreditoren-/Debitorenzahlungen verwenden (Rechnung bleibt dauerhaft offen)
Kontonummern raten statt nachschlagen
Steuerbestätigung überspringen
Manuelle Steuerzeilen zusammen mit tax_code verwenden
Abstimmung vor Buchung + Rechnungserstellung