---
name: folder-cleanup-orchestrator
description: "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: 정리 대상 탐지

```bash
# 루트에 새로 쌓인 파일 확인
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 반영

```bash
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_`