paveman
Erkennt Aufträge, eine Regel- oder Gedächtnisdatei zu kürzen ("kürze meine CLAUDE.md", "MEMORY.md ist zu lang", "komprimiere die Doku, ohne Technik anzutasten", "diese Regeldatei wird über die Zeichen
SKILL.mdskills/utilities/paveman/SKILL.md
GitHub<img src="banner.png" width="100%" alt="paveman banner">
Paveman — Regel- und Gedächtnisdateien deterministisch kürzen
Dünner, nutzerneutraler Skill-Wrapper um das separat bereitgestellte Modul
paveman. Der Skill erkennt, wann das Werkzeug passt, und beschreibt dessen sicheren Ablauf. Er setzt weder einen bestimmten Rechner noch einen festen Installationspfad oder ein persönliches Profil voraus.
Wann dieser Skill greift
Trigger sind Nutzersätze, die eine bestehende Regel-, Konventions- oder Gedächtnisdatei kürzen wollen, ohne ihren fachlichen Inhalt zu verändern:
- „Kürze
<Datei>“ / „diese Datei ist zu lang“ / „wird bei X Zeichen oder Zeilen abgeschnitten“ - „Komprimiere die Doku, ohne Technik oder Code anzutasten“
- „MEMORY.md oder CLAUDE.md ist zu voll geworden“
- „Mach diese Regeldatei knapper, aber lass die Bedeutung unverändert“
- Jede Variante, die das Kürzen einer bestehenden Datei meint, nicht neues Schreiben und nicht Übersetzen (siehe Abgrenzung unten)
Nicht dieser Skill:
knappform— ändert, wie das Modell selbst in der laufenden Konversation spricht (LLM-Kommunikationsstil, modellbasiert, kein Dateizugriff).pavemanändert stattdessen den Inhalt einer bestehenden Datei deterministisch und ohne Modellaufruf. Beide können nebeneinander bestehen; sie sind technisch und funktional getrennt.bilingual-doc-sync— zieht fehlende Sprachfassungen nach.pavemankürzt eine Fassung und übersetzt nichts.llm-text-hygiene— entfernt KI-Spuren oder Chat-Reste aus Texten. Das ist ein anderer Zweck als Kürzen.- Neuen Inhalt schreiben oder erfinden —
pavemankürzt nur, was schon da ist.
Was das Modul kann
paveman ist ein regelbasierter, deterministischer Prosa-Kürzer für Markdown- und Textdateien:
kein Modellaufruf, keine Tokens und kein Netzwerkversand. Die Bereitstellung kann je System
unterschiedlich sein; maßgeblich ist der dort autorisierte Modul- oder Paketstand.
| Flag | Wirkung |
|---|---|
| (kein Flag) | Trockenlauf (Standard). Zeigt Diff und Zeichenersparnis, schreibt nichts. |
--apply |
Schreibt wirklich; vorher wird automatisch eine Sicherung angelegt. |
--rollback |
Stellt die letzte Sicherung wieder her. |
--locker |
Meldet Pfad- oder Überschriftenabweichungen nur als Warnung statt als Fehler. |
--kontext N |
Legt die Anzahl der Diff-Kontextzeilen fest. |
Der Schutz-Validator läuft bei jedem Aufruf. Codeblöcke, Pfade und Überschriften dürfen nicht verändert werden. Im Standardmodus verhindert eine Abweichung das Schreiben, statt sie nur zu melden.
Ablauf — immer in dieser Reihenfolge
- Zuerst Trockenlauf.
paveman <Datei>ohne--applyausführen. Zeichenersparnis, Diff und Validatorstatus („OK“ oder konkrete Fehlermeldung) dem Nutzer zeigen. - Nur nach ausdrücklicher Freigabe schreiben. Erst dann
paveman <Datei> --applyausführen; niemals automatisch vom Trockenlauf in den Schreibmodus wechseln. --rollbackvor dem Schreiben erwähnen. Der Nutzer soll vorher wissen, wie sich ein unerwünschtes Ergebnis zurücknehmen lässt.- Validatorfehler ernst nehmen.
--lockernicht verwenden, nur um einen Fehler zu umgehen. Zuerst prüfen, ob die Abweichung tatsächlich unschädlich ist; der weichere Modus erfordert eine bewusste Nutzerentscheidung. - Kuratierte Inhalte respektieren. Ein regelbasiertes Werkzeug erkennt nicht zuverlässig, ob eine Formulierung absichtlich ausführlich ist. Bei Unsicherheit den Trockenlauf-Diff sorgfältig prüfen.
Voraussetzung — Modulverfügbarkeit prüfen
- Mit
paveman --helpprüfen, ob das CLI in der aktuellen Umgebung verfügbar ist. - Fehlt der Befehl, den für dieses System autorisierten Modul- oder Paketweg ermitteln. Keine lokale Pfadstruktur, keinen Paketnamen und kein Repository erfinden.
- Ist keine autorisierte Quelle auflösbar, die fehlende Voraussetzung als eigenen Setup-Punkt melden, statt den Skill blind auszuführen oder ein paralleles Modul anzulegen.
- Nach einer Installation zunächst erneut
paveman --helpund anschließend einen harmlosen Trockenlauf ausführen; ein echter Schreibtest bleibt freigabepflichtig.
Beispiele
User: „Kürze meine CLAUDE.md, sie wird beim Sessionstart abgeschnitten.“
→ `paveman CLAUDE.md` (Trockenlauf)
→ Ergebnis: „12.400 → 9.800 Zeichen (-21 %), Validator: OK.“
→ Diff zeigen und auf `--rollback` hinweisen.
→ Nutzer bestätigt.
→ `paveman CLAUDE.md --apply`
User: „MEMORY.md ist zu voll, kürze sie bitte.“
→ Trockenlauf: „893 → 893 Zeichen, keine Regel griff — der Text ist bereits knapp.“
→ Kein `--apply` empfehlen; den fehlenden Mehrwert ehrlich melden.
Changelog
1.0.1 (2026-08-20)
- Öffentlichen Wrapper vollständig von Rechnernamen, lokalen Checkoutpfaden, Installationsdaten, privaten Ticketreferenzen und lokalen Testergebnissen entkoppelt.
- Nutzerneutralen Verfügbarkeits- und Installationsvertrag ergänzt und echte deutsche Umlaute hergestellt.
1.0.0 (2026-08-19)
- Öffentliche Erstversion des Wrappers mit Trockenlauf, Freigabeschritt, Rollback und Validatorgrenzen.
- Abgrenzung zu
knappform,bilingual-doc-syncundllm-text-hygiene.