Doc-Rot
Antworte in der SPRACHE DES BENUTZERS; behalte technische Begriffe, Befehle, Pfade und Check-IDs wörtlich bei.
Finde Dokumentinhalte, die durch Zeit ungültig geworden sind. Melde BESTÄTIGTE Fäulnis; parke das lediglich Alte unter VERDÄCHTIG.
Parameter
- SCOPE: benannte Dateien (Standard bei Angabe) | berührte Dokumentdateien dieser Sitzung | gesamtes Repository-Dokumente —
.md/.mdx/.markdown/.rst/.txt/.adoc/.asciidoc/.org(bei > 20 Dateien zuerst bestätigen). - TIER: Quick = nur mechanische Altersmarkierungen (~kostenlos) · Full = semantische Staleness-Bewertung (kostenpflichtig). Standard aus
.coalledger.jsonquickVsFull; Full erfordert immer separate Zustimmung.
Altersmarkierungen (mechanische Schicht — deterministische Erkennung)
| Marker | Signal |
|---|---|
| Versionszeichenkette | Dokument nennt eine Version älter als die aktuelle des Projekts (Vergleich mit der Wahrheitsquelle der Version, z. B. dem Manifest) |
| Datumsstempel | Ein „zuletzt aktualisiert“ / „erneut validieren bis“ / „verifiziert am“-Datum weit in der Vergangenheit oder bereits überschritten |
| toter Aufgabenmarker | TODO / FIXME / „in Kürze“ / „noch nicht“ ohne Lebenszeichen |
| veraltetes Badge | Ein fest codiertes Status-/Versionsbadge, dem der Repository-Zustand widerspricht |
Die Erkennung ist deterministisch; ob ein Marker Fäulnis bedeutet, ist es nicht – ein altes Datum in einem Archiv ist in Ordnung, in einer Installationsanleitung nicht.
Methode
- Quick: Sammle Altersmarkierungen gemäß Tabelle. Alt ≠ verrottet: Ein einzelner Marker landet in VERDÄCHTIG.
- Full: Bewerte jeden Marker im Kontext und jage nach UNBEMERKTER Fäulnis – Anweisungen für eine Oberfläche, die sich geändert hat, Behauptungen, die ein späteres Dokument außer Kraft setzt (reiner Widerspruch zwischen Live-Dokumenten gehört zur Dokument-Konsistenz; Fäulnis ist die Zeitachse).
- Vorher bestätigen vor BESTÄTIGT: Ein Befund ist nur BESTÄTIGT, wenn der aktuelle Zustand dem Dokument widerspricht (die Versionsquelle nennt eine neuere Version; die referenzierte Oberfläche ist verschwunden). Alles Geschlussfolgerte bleibt VERDÄCHTIG.
- Schweregrad nach KONTEXT (niemals eine feste Zuordnung), dann achte auf
severityFloor: Verrottete Installations-/Sicherheitsschritte, denen Leser folgen = HOCH-KRITISCH; ein veraltetes Badge oder eine Versionserwähnung = MITTEL; ein altes Datum in einem archivierten Dokument = NIEDRIG.
Eskalationsgrenze
Ob eine Behauptung JE wahr war, ist Sache der Dokumentenverankerung; formale Verifikation einer hoch riskanten Behauptung eskaliert an CoalBoard (/coalboard), falls dieses Skill installiert ist. Dieser Kanarienvogel antwortet nur auf „Hat die Zeit es zerstört?“.
Ausgabe
| # | Pfad:Zeile | Marker | Beweis (aktueller Zustand) | Schweregrad | Fix |
Nur BESTÄTIGT-Tabelle; VERDÄCHTIG (alt, aber unbewiesen) als separate Liste, niemals die Haupttabelle.
Berichterstattung: Rufe ReportFindings auf, wenn aufrufbar – file/line MUSS die eigene Zeile des Markers sein, niemals eine Paraphrase; eine nicht auflösbare Zeile meldet deine beste Schätzung, benannt als ungenau im Abschlussbericht, niemals weggelassen. Schweregrad im summary vorangestellt (z. B. [HIGH] …) gemäß der Regel Schweregrad nach Kontext oben, sortiert schwerstes zuerst, VERDÄCHTIG (alt, aber unbewiesen) als verdict: PLAUSIBLE; Chat führt dann nur die Abschlusszeile (Anzahl · VERDÄCHTIG-Liste · Überlauf über 32) + das Fix-Menü, niemals eine Nacherzählung. Nicht aufrufbar → die Tabelle oben, unverändert. Ein Klick auf Fixes anwenden = Zustimmung zur Klasse Anwenden-sicherer-Fixes unten (nur eindeutige Aktualisierungen des aktuellen Werts), die den Fix-Modus ergänzt – nie umgeht. Nach jeder Fix-Runde melde dieselben Befunde erneut mit outcome: fixed/skipped/no_change_needed.
Fix-Modus (auswahlgesteuert)
Nach jedem Bericht in einer interaktiven Sitzung MUSST du dieses Menü über dein Fragewerkzeug präsentieren (überspringe nur, wenn die Befunde null sind oder kein Benutzer anwesend ist). NIEMALS ein Live-Dokument automatisch reparieren.
- Sichere Fixes anwenden: nur Aktualisierungen, deren aktueller Wert eindeutig ist (eine Versionszeichenkette auf die des Manifests erhöhen, ein vom Benutzer bestätigtes Datum aktualisieren, einen vom Benutzer als tot bestätigten TODO löschen). Jeder Fix: Checkpoint (git stash/commit in einem Git-Repo; sonst die Datei beiseite kopieren – niemals annehmen, dass Git existiert) -> anwenden -> die geänderten Zeilen erneut lesen.
- Lass mich auswählen: Befunde auflisten; der Benutzer wählt aus.
- Nur Bericht: unverändert beenden.
NIEMALS automatisch reparieren: Überschreiben von veralteten Anleitungen (eine inhaltliche Entscheidung), Löschen von Abschnitten, alles, dessen aktuelle Wahrheit du nicht überprüft hast.
Mehrsprachig
Altersmarker sind sprachunabhängig (Versionen, Daten und Badges sehen in jeder Prosa-Sprache gleich aus; DatumsFORMATE variieren – nach Struktur parsen, nicht nach einem englischen Monatsnamen). Semantische Bewertung reduziert sich bei einer schlecht beherrschten Sprache auf Low-Confidence-Flags, niemals auf Fehlalarme.
Problembericht
Falls dieser Kanarienvogel sich falsch verhält, BIETE an, ihn unter https://github.com/TheColliery/CoalLedger/issues mit einer vom Benutzer überprüften Zusammenfassung zu melden – niemals automatisch einreichen.