# 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 Zeichengrenze abgeschnitten") und nutzt dafür das Modul paveman — ein deterministisches, modellfreies CLI-Werkzeug zum Kürzen von Prosa in Markdown-/Textdateien mit Trockenlauf als Standard, Rollback und strengem Schutz-Validator für Pfade, Überschriften und Code. Nutze diesen Skill bei Sätzen wie "kürze ", "diese Datei ist zu lang/wird abgeschnitten", "shrink this rule file", "komprimiere ohne Inhalt zu verändern" oder wenn eine Regel-/Gedächtnisdatei erkennbar an eine Zeichen- oder Zeilengrenze stößt. - Skill: `ellmos-ai/paveman` (Agent Skill, multi-file: 3 files) - Install (CLI): `npx skillmds@latest add ellmos-ai/paveman` - Raw SKILL.md: https://api.skillmd.com/api/skills/ellmos-ai/paveman/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Docs & Writing - Author: ellmos-ai (https://skillmd.com/u/ellmos-ai) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/ellmos-ai/paveman --- 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 ``“ / „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. `paveman` kü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 — `paveman` kü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 1. **Zuerst Trockenlauf.** `paveman ` ohne `--apply` ausführen. Zeichenersparnis, Diff und Validatorstatus („OK“ oder konkrete Fehlermeldung) dem Nutzer zeigen. 2. **Nur nach ausdrücklicher Freigabe schreiben.** Erst dann `paveman --apply` ausführen; niemals automatisch vom Trockenlauf in den Schreibmodus wechseln. 3. **`--rollback` vor dem Schreiben erwähnen.** Der Nutzer soll vorher wissen, wie sich ein unerwünschtes Ergebnis zurücknehmen lässt. 4. **Validatorfehler ernst nehmen.** `--locker` nicht 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. 5. **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 1. Mit `paveman --help` prüfen, ob das CLI in der aktuellen Umgebung verfügbar ist. 2. Fehlt der Befehl, den für dieses System autorisierten Modul- oder Paketweg ermitteln. Keine lokale Pfadstruktur, keinen Paketnamen und kein Repository erfinden. 3. 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. 4. Nach einer Installation zunächst erneut `paveman --help` und anschließend einen harmlosen Trockenlauf ausführen; ein echter Schreibtest bleibt freigabepflichtig. ## Beispiele ```text 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` ``` ```text 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-sync` und `llm-text-hygiene`.