로컬 작업 폴더를 자동으로 정리하는 스크립트는 만들기 쉬워 보입니다. 확장자별로 나누고, 오래된 파일을 옮기고, 임시 파일을 지우면 될 것 같습니다.

하지만 실제로는 조심해야 합니다. 파일 정리는 작은 자동화처럼 보여도, 잘못 움직이면 다시 찾는 비용이 큽니다.

Daejin Lab에서도 블로그 글, raw 자료, wiki, 프로젝트 저장소, 빌드 산출물이 섞이기 때문에 먼저 기준을 정하는 쪽이 맞다고 봤습니다.

자동 정리 전에 정할 것

파일을 옮기는 스크립트를 만들기 전에 최소한 아래는 정해야 합니다.

정리 대상 폴더
절대 건드리면 안 되는 폴더
파일을 옮길 기준
중복 파일 처리 방식
되돌리기 로그 위치
dry-run 지원 여부

특히 src/content/blog처럼 실제 사이트에 반영되는 폴더는 조심해야 합니다. 글 파일 하나가 사라지면 빌드가 깨지거나 URL이 바뀔 수 있습니다.

바로 삭제하지 않는다

자동 정리에서 가장 위험한 동작은 삭제입니다. 처음 버전에서는 삭제보다 이동이 안전합니다.

삭제하지 않는다.
먼저 _review 또는 _archive로 옮긴다.
옮긴 파일 목록을 로그로 남긴다.
같은 이름이 있으면 덮어쓰지 않는다.
빌드 산출물과 원본 파일을 구분한다.

예를 들어 Astro 블로그에서는 dist/는 다시 만들 수 있는 산출물이지만, src/content/blog/의 Markdown은 원본입니다. 둘을 같은 기준으로 정리하면 안 됩니다.

dry-run을 먼저 둔다

파일을 실제로 옮기기 전에 dry-run이 필요합니다.

python organize_files.py --dry-run

이 모드에서는 실제 이동 없이 아래처럼 출력만 합니다.

MOVE draft-a.md -> blog/Draft/draft-a.md
SKIP .env
SKIP src/content/blog/post.md
ARCHIVE old-screenshot.png -> _archive/old-screenshot.png

출력을 보고 이상한 이동이 없을 때만 실제 실행으로 바꿉니다.

블로그 운영 폴더에 적용할 기준

Daejin Lab 기준으로는 아래처럼 나누는 편이 안전합니다.

절대 자동 이동 금지:
- src/content/blog
- src/pages
- src/components
- public/robots.txt
- sitemap 관련 설정
- .env 계열 파일

정리 후보:
- 임시 캡처 이미지
- 사용하지 않는 초안 메모
- 오래된 빌드 로그
- 실험용 출력 파일

즉, 사이트를 구성하는 원본은 사람이 확인하고, 임시 자료만 자동 정리 대상으로 두는 방식입니다.

지금 남긴 기준

폴더 자동 정리는 “깨끗하게 만들기”보다 “잃어버리지 않기”가 먼저입니다. 특히 블로그처럼 URL과 글 파일이 연결된 프로젝트에서는 파일 이동 하나가 검색 노출에도 영향을 줄 수 있습니다.

그래서 첫 자동 정리 스크립트는 아래 원칙으로 시작하려고 합니다.

dry-run 먼저
삭제 금지
이동 로그 필수
원본 폴더 보호
빌드 후 확인

작은 자동화라도 되돌릴 수 있게 만들면, 나중에 블로그가 여러 개로 늘어났을 때 더 안전하게 재사용할 수 있습니다.

자동 정리 전에 묶은 보호 구역

파일 자동 정리는 편해 보이지만, Daejin Lab에서는 먼저 건드리면 안 되는 구역을 정했습니다. 특히 wiki, raw 자료, 프로젝트 저장소는 한 번 섞이면 되돌리는 비용이 큽니다.

구역	자동화 허용 범위	금지선
블로그 저장소	글 수, frontmatter, 내부 링크 점검	자동 삭제, 자동 발행
raw 자료	새 캡처 파일 생성 보조	출처 없는 요약만 저장
wiki	승인된 지식 정리	임시 메모를 바로 장기 지식으로 승격
빌드 산출물	dist 재생성 확인	원본 Markdown 덮어쓰기

반복 점검은 반복 작업을 Python 스크립트로 줄인 사례처럼 읽기 전용부터 시작하고, 자동화 범위는 작은 자동화가 일을 더 늘리는 순간의 기준으로 한 번 더 걸러야 안전했습니다.