# task-1003.1: WAV 파일 정리 + 오디오 파일 자동 삭제 규칙 문서화/코드화 **팀**: dev2-team (오딘 팀장) **작업자**: 토르(스크립트/삭제), 미미르(정책 문서), 헤임달(테스트) **완료일**: 2026-03-25 --- ## SCQA **S**: 유튜브 요약 작업 시 다운로드한 오디오 파일(WAV/MP3)이 시스템에 잔류하며, audio.wav(1.5GB) 등 대용량 파일이 git push를 차단하고 디스크를 비대하게 만들고 있었다. **C**: 50MB 이상 오디오 파일 2개(총 1.55GB)가 workspace에 남아 있었고, 24시간 이상 경과한 오래된 오디오 파일 23개가 projects 하위에 방치되어 있었다. 자동 정리 메커니즘이 부재했다. **Q**: 현재 잔류 파일을 정리하고, 향후 오디오 파일이 시스템을 비대하게 만들지 않도록 자동화된 정리 체계를 구축할 수 있는가? **A**: 4단계 작업을 완료했다. Phase 1에서 대용량 파일 2개 삭제, Phase 2에서 정책 문서 작성, Phase 3에서 자동 정리 스크립트 + cron 등록, Phase 4에서 git 추적 상태를 확인했다. 총 25개 오디오 파일(약 1.58GB) 삭제, 6시간 주기 자동 정리 체계가 가동 중이다. --- ## 작업 상세 ### Phase 1: 50MB 이상 WAV 파일 전수 조사 및 삭제 **발견 파일:** - `/home/jay/workspace/teams/dev4/task-932.1/audio.wav` — 1.5GB - `/home/jay/workspace/teams/dev4/task-932.2/test_5min.wav` — 55MB **조치**: 두 파일 모두 삭제 완료. task-timers.json에서 running 상태인 task와 무관함을 확인 후 삭제. ### Phase 2: 규칙 문서화 - `/home/jay/workspace/memory/specs/audio-file-policy.md` 신규 작성 (v1.0) - 대상 확장자 6종 (wav, mp3, m4a, ogg, flac, aac) - 즉시 삭제 원칙 + 최대 24시간 보존 + 50MB 자동 삭제 - Git 추적 금지 규칙, 자동 정리 시스템 안내 - `MEMORY.md`에 오디오 정책 요약 3줄 추가 ### Phase 3: 코드화 — 자동 정리 스크립트 **스크립트**: `/home/jay/workspace/scripts/cleanup-large-audio.sh` - 대상: workspace + projects 하위 오디오 파일 6종 - 삭제 조건: 50MB 이상 또는 24시간 이상 경과 - running task 보호: task-timers.json에서 running 상태 task_id가 파일 경로에 포함되면 스킵 - 로깅: `/home/jay/workspace/memory/logs/audio-cleanup.log` - dry-run 모드 (`--dry-run`) 지원 **.gitignore 업데이트**: 기존 `*.wav` 외 `*.mp3`, `*.m4a`, `*.ogg`, `*.flac`, `*.aac` 5개 패턴 추가 **cron 등록**: ID `02A713FA`, `30 */6 * * *` (매 6시간 30분) ### Phase 4: git 히스토리 정리 - `git ls-files`로 확인: wav/mp3/m4a 파일 중 git에서 추적 중인 파일 **0건** - `git rm --cached` 불필요 - `.gitignore`에 6종 오디오 확장자 등록 확인 완료 --- ## 추가 정리: 오래된 오디오 파일 스크립트 실제 실행으로 24시간 이상 경과한 오디오 파일 23개 추가 삭제: - `/home/jay/projects/ThreadAuto/output/` 하위 mp3 파일 (173~430시간 경과) - `/home/jay/projects/ThreadAuto/.worktrees/` 하위 mp3 파일 - `/home/jay/projects/ThreadAuto/remotion/node_modules/` 내 beep.wav (354시간 경과) --- ## 생성/수정 파일 목록 - 신규: `/home/jay/workspace/scripts/cleanup-large-audio.sh` - 신규: `/home/jay/workspace/memory/specs/audio-file-policy.md` - 수정: `/home/jay/workspace/.gitignore` (오디오 확장자 5종 추가) - 수정: `/home/jay/workspace/memory/MEMORY.md` (오디오 정책 요약 3줄 추가) - 삭제: `teams/dev4/task-932.1/audio.wav`, `teams/dev4/task-932.2/test_5min.wav` - 삭제: `projects/ThreadAuto/` 하위 오디오 파일 23개 --- ## 테스트 결과 (헤임달) - dry-run 모드: PASS (삭제 없이 대상 목록만 출력) - 로그 파일 생성: PASS (포맷 정상) - running task 보호: PASS (로직 코드 리뷰 통과) - 실제 삭제 모드: PASS (23개 파일 정상 삭제) --- ## 발견 이슈 및 해결 ### 자체 해결 (3건) 1. **스크립트 오디오 확장자 불일치** — 최초 스크립트가 wav/mp3/m4a만 검색했으나 정책 문서는 6종 포함. ogg/flac/aac 추가하여 일관성 확보. 2. **.gitignore 구조화** — 기존 `*.wav`가 `# OS` 섹션 아래 산재해 있었음. `# 오디오 파일` 섹션으로 그룹핑하여 가독성 개선. 3. **ThreadAuto 방치 파일** — projects/ThreadAuto 하위에 24시간 이상 경과한 오디오 파일 23개 발견. 스크립트 실제 실행으로 정리 완료. ### 범위 외 미해결 (0건) --- ## QC 검증 결과 **Overall: PASS** (5 PASS, 7 SKIP) - file_check: PASS — 3개 파일 존재 및 크기 정상 (스크립트 4873B, 정책문서 2096B, .gitignore 428B) - data_integrity: PASS — task-timers.json 상태 정상 - critical_gap: PASS — 보고서에 CRITICAL 이슈 없음 - spec_compliance: PASS — 미완료 체크리스트 항목 없음 - duplicate_check: PASS — 유사도 최대 7.8% (임계값 이내) - pyright_check: SKIP — Python 파일 아닌 bash/md 파일만 변경 - test_runner: SKIP — 관련 테스트 파일 0개 (정당한 SKIP) - tdd_check: SKIP — Lv.1 문서/스크립트 작업으로 TDD 비적용