zioinfo-mail/.claude/skills/folder-cleanup-orchestrator/SKILL.md

name	description
folder-cleanup-orchestrator	GUARDiA 루트 폴더 정리 오케스트레이터. 루트에 임시 파일·스크립트·구버전 소스가 쌓일 때 정리한다. 다음 상황에서 반드시 사용: (1) '폴더 정리', '루트 정리', '파일 정리'; (2) '스크립트 정리', '임시 파일 정리'; (3) 다시 실행, 업데이트, 보완.

GUARDiA 폴더 정리 오케스트레이터

실행 모드: 서브 에이전트 (folder-organizer)

현재 확정된 구조 (2026-06-01 기준)

C:\GUARDiA\
├── workspace/           # 4개 프로젝트 소스 (불변)
│   ├── guardia-itsm/
│   ├── guardia-manager/
│   ├── guardia-messenger/
│   └── zioinfo-web/
├── repos/               # Gitea push용 bare repo (불변)
├── .claude/             # 하네스 (불변)
├── docs/                # 설계 문서 + .docx/.pptx
├── scripts/             # 임시 Python/JS 스크립트
│   ├── deploy/          # deploy_*.py (26개)
│   ├── check/           # check_*.py (16개)
│   ├── push/            # push_*.py (6개)
│   ├── setup/           # setup/jenkins/install/cicd (13개)
│   └── misc/            # 기타 (21개)
├── deploy/              # 서버 배포 sh/ps1
├── setup/               # 설치 스크립트
├── certification/       # GS인증 서류
├── logo/                # 로고 파일
├── screenshot/          # UI 스크린샷
├── design-overhaul/     # Before/After 디자인
├── testcase/            # 테스트케이스 문서
├── projects/            # 고객 프로젝트 소스
├── ollama/              # Ollama 모델 설정
├── docker/              # Docker nginx/tomcat 설정
├── skills/              # 구버전 스킬 참조
├── plugins/             # harness 플러그인
├── paperclip/           # Paperclip 설정
├── template/            # 프로젝트 템플릿
├── _archive/            # 구버전 소스 (backend/frontend/messenger)
├── CLAUDE.md            # Claude Code 진입점 (불변)
├── docker-compose*.yml  # Docker 설정 파일
├── Dockerfile           # Docker 이미지
├── start.ps1 / start.sh # 서비스 시작 스크립트
└── zio-server-key.pem   # 서버 SSH 키

Phase 0: 정리 대상 탐지

# 루트에 새로 쌓인 파일 확인
ls C:/GUARDiA/*.py 2>/dev/null
ls C:/GUARDiA/*.js 2>/dev/null
ls C:/GUARDiA/*.log 2>/dev/null
ls C:/GUARDiA/*.docx C:/GUARDiA/*.pptx 2>/dev/null

Phase 1: 분류 이동 규칙

패턴	이동 위치
deploy_*.py	scripts/deploy/
check_*.py	scripts/check/
push_*.py	scripts/push/
setup_*.py, jenkins_*.py, install_*.py, cicd_*.py	scripts/setup/
그 외 루트 .py	scripts/misc/
루트 .js	scripts/misc/
*.docx, *.pptx, *.pdf (설계문서)	docs/
*.log	삭제
새 프로젝트 소스 폴더	workspace/ 또는 _archive/

Phase 2: git 반영

cd C:/GUARDiA
git add scripts/ docs/ _archive/ -A
git commit -m "chore: 폴더 정리"

에러 핸들링

• _archive/에 이미 있으면 덮어쓰지 않고 버전 접미사 추가
• git add 실패 시 수동 확인 요청

테스트 시나리오

• 정상 흐름: 루트에 fix_xxx.py 10개 생성 → scripts/misc/로 자동 분류
• 확인: ls C:/GUARDiA/scripts/misc/ | grep fix_