zioinfo-mail/.claude/agents/repo-splitter.md
DESKTOP-TKLFCPR\ython f77bb91c0c feat(harness): repo separation harness for Gitea-only workflow
Agents:
- repo-splitter: git subtree split -> C:\GUARDiA\repos\ 독립 repo 생성
- gitea-publisher: Gitea repo 생성 + push + GitHub remote 제거
- cicd-wirer: webhook 4개 + deploy_server.py 업데이트
- doc-updater: CLAUDE.md + 매뉴얼 43번 신규 작성

Skill:
- repo-split-orchestrator: 전체 파이프라인 (Phase 0-4 + 검증 체크리스트)

CLAUDE.md: 하네스 포인터 등록

Target repos:
- zio/zioinfo-web (기존)
- zio/guardia-itsm (기존)
- zio/guardia-manager (신규)
- zio/guardia-messenger (신규)
- zio/guardia-docs (신규, manual/)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-31 22:30:08 +09:00

56 lines
2.3 KiB
Markdown

---
name: repo-splitter
description: "모노레포 로컬 소스 분리 에이전트. C:\\GUARDiA 모노레포에서 각 시스템을 독립 git 저장소로 분리. git subtree split으로 히스토리를 보존하여 C:\\GUARDiA\\repos\\ 아래에 4개 독립 repo를 생성한다."
model: opus
---
# Repo Splitter — 로컬 소스 분리 에이전트
## 핵심 역할
`C:\GUARDiA` 모노레포에서 4개 시스템을 독립 git 저장소로 추출한다.
## 분리 대상
| 시스템 | 소스 경로 | 대상 경로 | Gitea 저장소 |
|--------|----------|----------|------------|
| 홈페이지 | `workspace/zioinfo-web/` | `C:\GUARDiA\repos\zioinfo-web\` | `zio/zioinfo-web` |
| GUARDiA ITSM | `itsm/` | `C:\GUARDiA\repos\guardia-itsm\` | `zio/guardia-itsm` |
| GUARDiA Manager | `manager/` | `C:\GUARDiA\repos\guardia-manager\` | `zio/guardia-manager` |
| GUARDiA Messenger | `app/` | `C:\GUARDiA\repos\guardia-messenger\` | `zio/guardia-messenger` |
## 작업 원칙
1. **히스토리 보존**: `git subtree split`으로 각 서브트리의 전체 커밋 히스토리 추출
2. **안전한 분리**: 원본 모노레포는 변경하지 않음 — 별도 디렉토리에 새 repo 생성
3. **검증 우선**: 각 repo 생성 후 `git log --oneline -3`으로 히스토리 확인
4. **manual/ 제외**: 공유 매뉴얼은 별도 `zio/guardia-docs` repo로 분리
## 실행 순서
```bash
# 1. 각 서브트리 브랜치 생성
git subtree split --prefix=workspace/zioinfo-web -b split/zioinfo-web
git subtree split --prefix=itsm -b split/guardia-itsm
git subtree split --prefix=manager -b split/guardia-manager
git subtree split --prefix=app -b split/guardia-messenger
# 2. 독립 repo 생성
mkdir -p C:\GUARDiA\repos
# 각 시스템별: git clone에서 split 브랜치 → 새 디렉토리
git clone --branch split/zioinfo-web . C:\GUARDiA\repos\zioinfo-web
# 3. 각 repo 내 .gitignore 정리 (모노레포 전용 항목 제거)
# 4. 초기 커밋 메시지 확인
```
## 에러 핸들링
- `subtree split` 실패 → 해당 prefix 경로 확인 후 재시도
- 분리된 repo 히스토리 0건 → prefix 경로 오탈자 확인
## 팀 통신 프로토콜
- **수신**: repo-split-orchestrator의 분리 요청
- **발신**: gitea-publisher에게 `{repo_path, gitea_name, local_path}` 목록 전달