docs: add ivada core-brain repo reorg plan (no execution)

This commit is contained in:
happybell80 2026-03-03 23:56:55 +09:00
parent 44ab6fb4a1
commit 2f4984dd68

View File

@ -0,0 +1,50 @@
# 260303 ivada 코어브레인 레포 정리 계획 (실행 보류)
## 목적
- `ivada`를 로빙 코어 브레인 플랫폼 관점으로 재정렬하기 위한 기준을 먼저 고정한다.
- 현재 단계에서는 **실제 폴더 이동/삭제/병합은 수행하지 않는다**.
## 범위
- 포함: 분류 체계 정의, 레포 경계 원칙, 단계별 실행 순서
- 제외: 실제 파일 이동, 원격 변경, 서비스 경로 변경
## 분류 체계 (논리 구조)
1. `core`: 로빙 핵심(brain/memory/policy/runtime)
2. `gateway`: 외부 진입/인증/프록시
3. `skills`: 도메인별 skill 서비스
4. `interfaces`: 사용자/운영 인터페이스
5. `ops`: 배포/관측/운영 도구
6. `experiments`: 실험/학습/프로토타입
## 레포 정리 원칙
1. 독립 git 레포는 즉시 물리 이동하지 않고 인덱스 문서로 먼저 정리
2. 비레포 폴더만 저위험 순서로 이동 검토
3. 레포 간 합치기 금지, 변경은 레포별 단일 커밋
4. 로컬 검증 후 원격 반영, 운영 서버 반영은 별도 승인 절차
## 단계별 계획
1. Phase A: 인벤토리 확정
- 현재 `ivada` 하위 폴더를 6개 분류 체계에 매핑
- 미분류/중복 폴더 목록 작성
2. Phase B: 문서 진입점 정리
- `ivada` 루트 안내 문서에 논리 구조 반영
- 상세는 `DOCS` 링크로만 연결
3. Phase C: 저위험 정리
- 독립 git이 아닌 보조 폴더만 이동 후보 선정
- 서비스 영향 없는 항목부터 순차 정리
4. Phase D: 고위험 정리
- 독립 git 레포는 이동 대신 링크/명명 정리 우선
- 필요 시 레포별 개별 이전 계획을 별도 문서로 분리
## 검증 기준
1. 신규 참여자가 3분 내 구조와 책임 경계를 설명 가능
2. 배포 경로와 책임 경로가 문서상 1:1 대응
3. 실험 영역과 운영 영역이 혼재되지 않음
## 완료 조건
- 분류표(전체 폴더 매핑) 완료
- 정리 우선순위(저위험/고위험) 완료
- 실제 실행용 후속 계획 문서로 분리 완료