MarieKondo­FürAgenten

Euer Agent ist nur so gut wie die Ablage, aus der er liest.

Deutsch · English

Ein KI-Agent, der auf euer SharePoint, euer CRM und eure Netzlaufwerke losgelassen wird, findet dort angebot_final_v3(2).docx, drei Preislisten aus drei Jahren und eine Kundentabelle, die zuletzt 2021 jemand gepflegt hat. Dann antwortet er überzeugt und falsch. Das liegt selten am Modell, sondern meist an den Daten.

Das KonMari-Kit räumt genau das auf, mit der Methode von Marie Kondo, übersetzt für Daten: erst entscheiden, wofür aufgeräumt wird, dann aussortieren, nach Kategorie ordnen, jedem Teil einen Platz und eine verantwortliche Person geben und erst danach anschließen. Am Ende steht ein MCP-Server, über den eure Agenten nur noch aktuelle, freigegebene, gut beschriebene Daten sehen, und der „Ich weiß es nicht“ sagen darf, statt zu raten.

Ein Projekt des KI Klub Werder e. V., Apache-2.0.

Macht es eurem Agenten Freude?

Jede Datei, jede Tabelle und jede Quelle muss durch denselben Test. Sechs Fragen, jede mit 0 bis 3 Punkten bewertet, mit Belegen:

Das Ergebnis ist ein Vorschlag behalten, reparieren oder aussortieren. Den Vorschlag bestätigt immer ein Mensch, und jede Entscheidung lässt sich rückgängig machen.

Vorher und nachher

So räumt ihr auf

Neun Schritte, immer für einen Anwendungsfall, zum Beispiel einen FAQ-Assistenten für die Geschäftsstelle. Jeder Schritt prüft, ob der vorige sauber abgeschlossen ist. Das Kit lässt euch also nicht anreichern, was ihr noch nicht aussortiert habt.

 1  charter      Wofür räumen wir auf? Anwendungsfall, Rollen, Datenschutz, Erfolgskennzahlen
 2  inventory    Was liegt wo? Quellen über alle Systeme, sortiert nach Kategorie statt Ablageort
 3  score        Macht es Freude? Sechs Fragen, Vorschlag behalten / reparieren / aussortieren
 4  discard      Danke und tschüss: Dubletten, alte Fassungen, Irrelevantes ins Archiv
 5  normalize    Eine Wahrheit: Datumsangaben, IDs und Namen vereinheitlichen, führende Quelle festlegen
 6  chunk/enrich Ordnen: Abschnitte schneiden, Metadaten anheften, Glossar pflegen
 7  govern       Absichern: Rechte, Maskierung personenbezogener Daten, manipulationssicheres Protokoll
 8  product/serve Anschließen: Datenprodukte und ein MCP-Server nur zum Lesen
 9  eval/monitor Prüfen: echte Fragen, Belege, Abstinenz, Aktualität laufend überwachen

Die Reihenfolge der Kategorien folgt dem Risiko: erst die öffentliche FAQ, dann die Verträge, ganz zum Schluss alles mit besonders schützenswerten Daten nach Art. 9 DSGVO.

Schnellstart

Voraussetzungen: Python 3.12 und uv. Das Beispiel ist ein erfundener Sportverein mit einem FAQ-Assistenten für die Geschäftsstelle.

git clone https://github.com/KI-Klub-Werder-e-V/MarieKondoFuerAgenten
cd MarieKondoFuerAgenten && uv sync
cd examples/verein-faq-assistant

uv run konmari charter validate          # Charta prüfen: Rollen, Datenschutz, Datenumfang
uv run konmari charter approve --as anna # die verantwortliche Person gibt frei
uv run konmari metrics validate          # Erfolgskennzahlen und Fragenkatalog prüfen
uv run konmari metrics approve --as ben
uv run konmari charter gate --step inventory

Das letzte Kommando scheitert, und das ist Absicht:

unmet: metrics: must_have metric 'answer_accuracy' has no baseline or measurement plan

Ohne Ausgangswert gibt es keinen Aufräumbeginn, denn sonst weiß hinterher niemand, ob es etwas gebracht hat. Wie es weitergeht, steht Schritt für Schritt in der Anleitung. Alle Befehle auf einen Blick: docs/cli.de.md.

Was drinsteckt

• Ein Katalog für alle Entscheidungen. DuckDB lokal, Postgres 16 im Betrieb, dieselben Migrationen. Jede Entscheidung mit Person, Rolle, Zeitpunkt und Begründung.
• Menschen entscheiden, das Kit schlägt vor. Aussortieren, Maskieren, Löschen und Veröffentlichen brauchen eine Freigabe der zuständigen Rolle aus der Charta.
• Alles umkehrbar, alles protokolliert. Archiv statt Papierkorb, Wiederherstellen per Befehl, ein hash-verkettetes Prüfprotokoll (konmari audit verify).
• Dubletten auf drei Ebenen: identische Dateien, fast gleiche Texte (MinHash) und inhaltlich gleiche Texte (Embeddings, optional).
• Datenschutz eingebaut. Personendaten werden lokal mit Presidio und spaCy erkannt, Löschfristen und Aufbewahrungspflichten je Kategorie, Pseudonymisierung mit Schlüssel statt Rückübersetzungstabelle, Verzeichnis der Verarbeitungstätigkeiten als Export.
• Offene Standards statt Eigenbau: DCAT für das Inventar, OpenLineage für die Herkunft, ODPS und ODCS für Datenprodukte, SKOS für das Glossar, MCP für Agenten.
• Selbst gehostet, ohne Pflicht-Cloud. Modelle für Embeddings und Bewertung laufen lokal; eine gehostete API ist per Konfiguration möglich.

Für wen ist es gedacht?

• Vereine, Verbände, kleine und mittlere Unternehmen und Verwaltungen, die einen ersten Agenten auf ihre eigenen Daten loslassen wollen
• Freiwillige, IT-Verantwortliche und Berater:innen, die so ein Projekt begleiten
• alle, die vorher wissen wollen, welche Daten der Agent sieht, und das belegen müssen

Gearbeitet wird auf der Kommandozeile. Für die Freigaben braucht es keine Programmierkenntnisse, aber jemanden, der die Befehle ausführt.

Ehrlicher Stand

Das Projekt ist jung (Version 0.1, Oktober 2026). Es wurde spezifikationsgetrieben mit OpenSpec gebaut: neun Changes, jeder mit Anforderungen, Szenarien und Recherche-Notizen samt Quellen in research/.

Gebaut und getestet

• Alle neun Schritte sind umgesetzt, von der Charta bis zur Überwachung: 22 Befehlsgruppen, 686 automatische Tests (DuckDB und Postgres 16), jedes Spec-Szenario mit eigenem Test.
• Jeder Schritt wurde nach dem Bauen von einem unabhängigen Prüfdurchlauf gegen die Spezifikation gelesen; dabei wurden 6 echte Fehler gefunden und behoben, darunter einer, bei dem gelöschte Daten beim nächsten Scan wieder aufgetaucht wären.
• Drei Aufgaben sind bewusst offen: ein optionaler Debezium-Adapter für Echtzeit-Änderungen, die Abstimmung einer Schnittstelle zwischen den Schritten und ein Test der Anleitung durch eine Person ohne Programmierkenntnisse.

Noch nicht erprobt

• Kein Lauf gegen echte Systeme. SharePoint, CRM, Netzlaufwerke und Modelle sind gegen Attrappen getestet. Empfehlung: zuerst mit einer Kopie und einem kleinen Anwendungsfall.
• Die Schwellenwerte (zum Beispiel ab wann zwei Texte Dubletten sind) sind begründete Annahmen aus der Recherche, keine Messwerte. Sie sollen nach dem ersten Pilot kalibriert werden.
• Das deutsche spaCy-Modell de_core_news_lg wird in den Tests nicht geladen.

Datenschutz

Das Kit hilft beim Nachweis, ersetzt aber keine datenschutzrechtliche Prüfung. Die Charta fragt DSFA und Einstufung nach EU AI Act ab und blockiert die Freigabe, solange sie offen sind.

Mitmachen

Gesucht sind vor allem Pilot-Erfahrungen. Wenn ihr das Kit an einem echten Anwendungsfall ausprobiert, schreibt uns, was geklemmt hat. Außerdem willkommen: weitere Konnektoren (Nextcloud, Confluence, Google Drive, weitere CRMs), bessere deutsche Beispiele und Übersetzungen. Fehler und Ideen bitte als Issue.

uv sync && uv run pytest -q              # Tests; Postgres-Tests nutzen KONMARI_TEST_PG_URL oder ein lokales Postgres 16
openspec validate --all --strict         # Specs prüfen

Neue Funktionen beginnen als OpenSpec-Change. Wie das geht und welche Regeln für Menschen und Agenten gelten, steht in CONTRIBUTING.md und AGENTS.md. Echte personenbezogene Daten gehören nie ins Repository.

Dokumentation

Lizenz

Apache-2.0, siehe LICENSE.