모든 고의적인 단축 댓글은 shortcut: 주석으로 표시되며, 이는 한계(ceiling)와 업그레이드 경로(upgrade path)를 명시합니다. (이전 코드는 ponytail:을 사용할 수 있습니다.) 이 명령은 이를 하나의 장부로 수집하여, 미뤄둔 작업이 조용히 영구화되지 않도록 방지합니다.
스캔
리포지토리에서 주석 마커를 검색하되, .git 디렉토리와 .gitignore 파일에 명시된 모든 항목(의존성, 빌드 출력물, 캐시 등, 모든 스택)은 제외합니다:
git grep --no-index --exclude-standard -nE '(#|//|/[*]) ?(shortcut|ponytail):' (사용 중인 스택에 따라 다른 주석 접두사를 추가하세요)
사용자가 자신의 마커 단어(예: /ponytail-debt TODO)를 지정하면 해당 단어를 대신 검색합니다.
각 검색 결과는 장부의 한 행이 됩니다. 주석 접두사는 단순히 관례를 언급하는 내용을 장부에서 제외합니다. 키보드 단축키에 대한 메모와 같이 연기(deferral)가 아닌 결과는 건너뜁니다.
출력
파일별로 그룹화된 각 마커에 대해 한 행씩 출력:
<파일>:<줄>, <단순화된 내용>. ceiling: <명시된 한계>. upgrade: <재검토 트리거>.
관례는 shortcut: <ceiling>, <upgrade path>이므로, 한계와 트리거를 주석에서 직접 가져옵니다. 행별로 소유자를 추가하려면 git blame -L<줄>,<줄>을 사용하세요.
부패 위험 플래그: 업그레이드 경로 또는 트리거가 명시되지 않은 모든 마커 주석에는 no-trigger 태그가 붙습니다. 이것들이 조용히 부패하는 항목입니다.
<N> markers, <M> with no trigger.로 마무리합니다. 발견된 항목이 없으면 No shortcut debt. Clean ledger.를 출력합니다.
경계
읽기 및 보고만 수행하며, 아무 것도 변경하지 않습니다. 지속적으로 기록하려면 요청 시 장부를 파일(예: PONYTAIL-DEBT.md)에 저장합니다. 일회성 명령입니다.