Jede gezielte Abkürzung wird mit einem shortcut:-Kommentar markiert, der ihren Zweck und ihren Upgrade-Pfad benennt (älterer Code verwendet möglicherweise ponytail:). Dies sammelt sie in einem unvergesslichen Schuldenbuch, damit eine Verzögerung nicht stillschweigend dauerhaft wird.
Scannen
Durchsuche das Repository nach Kommentarmarkern, überspringe .git und alles, was die .gitignore-Dateien ignorieren (Abhängigkeiten, Build-Ausgabe, Caches, in jedem Stack):
git grep --no-index --exclude-standard -nE '(#|//|/[*]) ?(shortcut|ponytail):' (füge bei Bedarf andere Kommentarpräfixe für deinen Stack hinzu)
Falls der Benutzer ein eigenes Markerwort angibt (/ponytail-debt TODO), suche stattdessen nach diesem Wort.
Jeder Treffer ist eine Zeile im Schuldenbuch. Das Kommentarpräfix verhindert, dass Prosa, die lediglich die Konvention erwähnt, ins Buch aufgenommen wird. Überspringe Treffer, die keine Verzögerung darstellen, z. B. einen Hinweis auf eine Tastenkombination.
Ausgabe
Eine Zeile pro Marker, gruppiert nach Datei:
<datei>:<zeile>, <was vereinfacht wurde>. ceiling: <benannte Grenze>. upgrade: <Auslöser für erneute Überprüfung>.
Die Konvention lautet shortcut: <ceiling>, <upgrade path>, also ziehe den Grenzwert und den Auslöser direkt aus dem Kommentar. Möchtest du auch einen Besitzer pro Zeile? Füge git blame -L<zeile>,<zeile> hinzu.
Kennzeichne das Risiko von Veraltung: Jeder Marker-Kommentar, der keinen Upgrade-Pfad oder Auslöser benennt, erhält ein no-trigger-Tag – diese verrotten stillschweigend.
Beende mit <N> Marker, <M> ohne Auslöser. Nichts gefunden: No shortcut debt. Clean ledger.
Grenzen
Nur lesen und berichten, nichts ändern. Um es dauerhaft zu speichern, frage danach und es schreibt das Schuldenbuch in eine Datei (z. B. PONYTAIL-DEBT.md). Einmaliger Bericht.