/cleanup

Простым языком

Когда отлаживаешь баг — оставляешь в коде временные пометки: «выведи это в консоль», «остановись тут». Они помогают во время работы, но на сайте им не место. /cleanup находит весь этот мусор и аккуратно убирает.

Напиши /cleanup перед отправкой кода — Claude покажет список всего что нашёл и спросит разрешения удалить. Ничего не удаляется молча. Умеет отличить отладочные пометки от настоящих сообщений об ошибках.

Что делает

/cleanup ищет и удаляет отладочный и мёртвый код: console.log, debugger, print(), закомментированные блоки, неиспользуемые импорты. Показывает что нашёл перед удалением и спрашивает подтверждение. Не трогает легитимные console.error и console.warn.

Синтаксис

# Чистка всего проекта
/cleanup

# Чистка конкретного файла
/cleanup src/api/auth.ts

# Чистка директории
/cleanup src/components/

Пошаговый процесс

1. Сканирует указанный путь (или весь проект) рекурсивно
2. Находит console.log, console.debug (JS/TS) и print(), breakpoint() (Python)
3. Находит закомментированные блоки кода (3+ строки подряд)
4. Находит неиспользуемые импорты через eslint-plugin-unused-imports
5. Находит TODO/FIXME без привязки к бэклогу (предлагает добавить)
6. Показывает полный список находок с контекстом (строка, файл)
7. После подтверждения — удаляет, запускает prettier на изменённых файлах

Примеры использования

Чистка перед коммитом

Отладили баг, оставили несколько console.log. Перед коммитом — /cleanup находит всё за секунды.

/cleanup

Найдено 7 проблем:

src/api/reactions.ts:45    console.log('reaction data:', data)
src/api/reactions.ts:67    console.log('fingerprint:', fp)
src/components/FeedCard.tsx:23  // console.debug('render', props)
src/lib/jwt.ts:12          // старая реализация verify
src/lib/jwt.ts:13          // const decoded = jwt.verify(token, SECRET)
src/lib/jwt.ts:14          // return decoded

Не трогаю:
src/lib/logger.ts:8    console.error('DB connection failed:', err)
src/lib/logger.ts:15   console.warn('Rate limit approaching')

Удалить найденное? [да/нет]

Чистка после рефакторинга

После крупного рефакторинга остаётся мусор: старые импорты, закомментированные блоки. /cleanup src/ делает полный проход по директории.

/cleanup src/

Найдено 12 неиспользуемых импортов:
  src/components/Header.tsx — import { useState } from 'react' (не используется)
  src/pages/index.tsx — import AnimatedContent from './AnimatedContent' (удалён)
  ...

Найдено 3 закомментированных блока (>3 строк):
  src/seed/index.ts:45-52
  ...

Удалить? [да/нет]

Автоматизация

Хук stop-check-debug.sh автоматически сканирует staged файлы при завершении сессии. Если находит console.log или debugger — предупреждает. Полный /cleanup запускается вручную или как часть /pre-commit-check.

# Хук автоматически проверяет staged файлы:
# .claude/hooks/stop-check-debug.sh
git diff --staged --name-only | xargs grep -l "console.log|debugger"

# Если найдено:
[WARN] Debug-код в staged файлах:
  src/api/auth.ts — console.log на строке 45
  Запустите /cleanup перед коммитом

console.log в production — это не просто шум в логах. Это утечка внутренней информации.