Cada atajo deliberado de coleta se marca con un comentario shortcut: que nombra
su techo y su ruta de mejora (el código antiguo puede usar ponytail:). Esta skill los recolecta en un libro contable para que una postergación
no pueda convertirse silenciosamente en permanente.
Escaneo
Haz grep en el repositorio buscando los marcadores de comentario, omitiendo .git y todo lo que
los archivos .gitignore ignoran (dependencias, artefactos de compilación, cachés, en cualquier stack):
git grep --no-index --exclude-standard -nE '(#|//|/[*]) ?(shortcut|ponytail):' (agrega otros prefijos de comentario si tu stack los usa)
Si el usuario indica su propia palabra clave (/ponytail-debt TODO), haz grep por esa palabra en su lugar.
Cada coincidencia es una fila del libro contable. El prefijo del comentario evita que el texto que simplemente mencione la convención entre al libro. Salta las coincidencias que no sean una postergación, como una nota sobre un atajo de teclado.
Salida
Una fila por marcador, agrupada por archivo:
<archivo>:<línea>, <qué simplifica>. techo: <el límite nombrado>. mejora: <el desencadenante para revisitar>.
La convención es shortcut: <techo>, <ruta de mejora>, así que extrae el techo
y el desencadenante directamente del comentario. ¿Quieres un propietario por fila también? agregar
git blame -L<línea>,<línea>.
Señala el riesgo de deterioro: cualquier comentario marcador que no nombre una ruta de mejora o
desencadenante recibe una etiqueta no-trigger, esos son los que se deterioran en silencio.
Termina con <N> marcadores, <M> sin desencadenante. Si no se encuentra nada: Sin deuda de shortcut. Libro limpio.
Límites
Solo lee y reporta, no cambia nada. Para persistir, pídelo y escribe el
libro contable en un archivo (p. ej. PONYTAIL-DEBT.md). Una sola ejecución.