28d3ba4836
- Move backend/frontend/messenger/ old paths to _archive/ - Reorganize scripts into scripts/deploy, check, push, setup, misc - Move docs (pptx, docx) to docs/ - Add .claude agents and skills for fullstack/folder-cleanup harness - workspace/ projects remain intact Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
91 lines
3.5 KiB
Markdown
91 lines
3.5 KiB
Markdown
---
|
|
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_`
|