I Found 2,000 Loose Scripts in My Repo and It Was All My Fault

Описание и применение

В репозитории накопилось более 2000 одноразовых скриптов, что создало шум и усложнило поиск инструментов. Решением стало скрипт quarantine_record.py, который перемещает файлы в архив, создает SHA256‑манипест и устанавливает правило: новые .py в корне вызывают тревогу и перемещаются в рабочее пространство задачи. Теперь в корне нет лишних файлов.

Задача

A shared project root accumulated over 2,000 one‑off Python probe scripts, creating a noisy, unmaintainable state and making it hard for agents to find reusable tools.

Результат

The repository now has zero loose files in the root, a reversible and auditable cleanup process, and a clear rule preventing future accumulation.

Рабочий процесс

• Identify orphaned probe scripts in the root directory
• Run quarantine_record.py with move action, specifying source files, timestamp, reason, and task ID
• Verify files are moved to the archive and a manifest is created
• Set a hard rule: any new .py in the root triggers an alert and must be quarantined
• Monitor the root for new loose files and maintain zero count

Доказательства

I did not delete the pile by hand. Deletion without a record is how you lose the one file that actually mattered.

Источник

The discipline is now a hard rule: a new .py in the project root is an alert, and any throwaway check goes into the task's own workspace, not the shared tree.

Источник