From 2f4984dd68e747c21ba72df8ef5b81c1befdf653 Mon Sep 17 00:00:00 2001 From: happybell80 Date: Tue, 3 Mar 2026 23:56:55 +0900 Subject: [PATCH] docs: add ivada core-brain repo reorg plan (no execution) --- ...ada_코어브레인_레포정리_계획.md | 50 +++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 journey/plans/260303_ivada_코어브레인_레포정리_계획.md diff --git a/journey/plans/260303_ivada_코어브레인_레포정리_계획.md b/journey/plans/260303_ivada_코어브레인_레포정리_계획.md new file mode 100644 index 0000000..08a495e --- /dev/null +++ b/journey/plans/260303_ivada_코어브레인_레포정리_계획.md @@ -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. 실험 영역과 운영 영역이 혼재되지 않음 + +## 완료 조건 +- 분류표(전체 폴더 매핑) 완료 +- 정리 우선순위(저위험/고위험) 완료 +- 실제 실행용 후속 계획 문서로 분리 완료