DOCS/journey/plans/260303_ivada_코어브레인_레포정리_계획.md

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. 실험 영역과 운영 영역이 혼재되지 않음

완료 조건

• 분류표(전체 폴더 매핑) 완료
• 정리 우선순위(저위험/고위험) 완료
• 실제 실행용 후속 계획 문서로 분리 완료