feat: Beratungsumgebung (CLAUDE.md, Skills finanz-api/finanzberatung/auszug-import)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

.claude/skills/finanzberatung/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: finanzberatung
+description: Fünf-Schritte-Workflow für Finanzberatung mit dem Finanzberatungs-Tool — Lage erfassen, Basis-Szenario, Varianten (Kredit/Kürzungen) durchrechnen, vergleichen, Empfehlung mit Zahlen begründen. Use when der Nutzer eine Finanzeinschätzung, Kreditberatung, Sparempfehlung oder Liquiditätsplanung ("reicht das Geld", "brauche ich einen Kredit", "wo kann ich kürzen") anfragt.
+---
+
+# Finanzberatung
+
+Beratung erfolgt datengetrieben über das Finanzberatungs-Tool (Skill
+`finanz-api` für die API-Details). Kein Rat ohne durchgerechnetes Szenario.
+
+## 1. Lage erfassen
+
+- Konten und aktuelle Salden abrufen (`GET /api/accounts`).
+- Unkategorisierte bzw. auffällige Buchungen prüfen (`GET /api/transactions`
+  ohne `category_id`-Filter bzw. mit `q`), damit Auswertungen nach Kategorie
+  belastbar sind.
+- Prüfen, ob wiederkehrende Posten gepflegt sind (`GET /api/recurring`); falls
+  lückenhaft, `GET /api/recurring/suggestions` durchgehen und mit dem Nutzer
+  bestätigen/verwerfen, bevor weitergerechnet wird.
+
+## 2. Basis-Szenario anlegen/durchrechnen
+
+- Falls noch nicht vorhanden: Basis-Szenario anlegen (`POST /api/scenarios`,
+  ohne Modifikatoren, mit vorhandenen wiederkehrenden/geplanten Posten).
+- Durchrechnen (`POST /api/scenarios/{id}/project`) und Ergebnis als
+  Referenzlinie festhalten (Tiefpunkt, Unterschreitungsdatum falls vorhanden).
+
+## 3. Fragestellung in Varianten übersetzen
+
+- Kreditbedarf: Kredit anlegen (`POST /api/loans` mit Betrag, Zinssatz,
+  Laufzeit, Auszahlungsdatum, Tilgungsart) und dem Szenario zuordnen
+  (`POST /api/scenarios/{id}/loans/{loan_id}`).
+- Kürzungspotenzial: Modifikatoren je Kategorie oder wiederkehrendem Posten
+  anlegen (`POST /api/scenarios/{id}/modifiers`, `target_type`
+  `category`|`recurring`, `kind` `percent`|`absolute`|`remove`).
+- Für jede Fragestellung ein eigenes Szenario (Kopie der Idee, nicht das
+  Basis-Szenario verändern), damit Varianten unabhängig vergleichbar bleiben.
+
+## 4. Varianten durchrechnen
+
+- Jede Variante mit `POST /api/scenarios/{id}/project` (gleicher Horizont wie
+  das Basis-Szenario, damit die Vergleichswerte konsistent sind) durchrechnen.
+- Bei Kredit-Varianten zusätzlich den Tilgungsplan ziehen
+  (`GET /api/loans/{id}/schedule`) für Gesamtzinskosten und Ratenhöhe.
+
+## 5. Vergleichen und Empfehlung formulieren
+
+- Vergleichstabelle je Variante: Tiefpunkt (Datum + Betrag),
+  Unterschreitungsdatum (Null bzw. Warnschwelle), bei Krediten
+  Gesamtzinskosten und monatliche Rate aus dem Tilgungsplan.
+- Empfehlung immer mit diesen Zahlen begründen, nicht nur qualitativ.
+- Hinweis an den Nutzer: Das Grafana-Dashboard „Szenario-Vergleich“
+  (http://127.0.0.1:8097) zeigt die Verlaufskurven der Varianten übereinander
+  mit Nulllinie und Warnschwelle — für die visuelle Gegenprobe verlinken bzw.
+  empfehlen, dort nachzusehen.
+
+## Grundregeln (siehe auch CLAUDE.md)
+
+- Echte, bestätigte Buchungen nie ändern — Korrekturen nur als
+  Kategorie-Anpassung.
+- Zukunftsplanung ausschließlich über Szenarien, nie am Basis-Datenbestand.