Cada atalho deliberado é marcado com um comentário shortcut: nomeando seu limite e caminho de atualização (códigos mais antigos podem usar ponytail:). Isso os coleta em um registro para que um adiamento não possa se tornar permanentemente esquecido.
Varredura
Faça uma busca no repositório pelos marcadores de comentário, ignorando .git e tudo o que os arquivos .gitignore ignoram (dependências, saída de build, caches, em qualquer pilha):
git grep --no-index --exclude-standard -nE '(#|//|/[*]) ?(shortcut|ponytail):' (adicione outros prefixos de comentário se sua pilha os usar)
Se o usuário nomear sua própria palavra de marcação (/ponytail-debt TODO), procure por essa palavra.
Cada ocorrência é uma linha do registro. O prefixo do comentário impede que prosa que meramente menciona a convenção entre no registro. Pule ocorrências que não são um adiamento, como uma nota sobre um atalho de teclado.
Saída
Uma linha por marcador, agrupada por arquivo:
<arquivo>:<linha>, <o que foi simplificado>. limite: <o limite nomeado>. atualização: <o gatilho para revisitar>.
A convenção é shortcut: <limite>, <caminho de atualização>, então extraia o limite e o gatilho diretamente do comentário. Quer um proprietário por linha também? Adicione git blame -L<linha>,<linha>.
Sinalize o risco de deterioração: qualquer comentário marcador que não nomeie um caminho de atualização ou gatilho recebe uma tag no-trigger; esses são os que se deterioram silenciosamente.
Termine com <N> marcadores, <M> sem gatilho. Nada encontrado: Nenhuma dívida de atalho. Registro limpo.
Limites
Apenas lê e reporta, não altera nada. Para persistir, é solicitado e grava o registro em um arquivo (ex.: PONYTAIL-DEBT.md). Único disparo.