# Milestone: 장기 기억과 RAG 업데이트 사이클 (2차)

## 위치

- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
- Phase: [PHASE.md](../PHASE.md)

## 목표

특정 repo에 대한 장기 기억 저장소, RAG 검색, update cycle, MCP 기반 context 절약을 MVP 이후 2차 후보로 스케치한다.
이 Milestone은 knowledge ingestion/update loop의 필요성과 책임 경계만 잡고, embedding/index 저장소나 worker 배치 구현은 후속 검토 전까지 확정하지 않는다.

## 상태

[스케치]

## 승격 조건

- [ ] 장기 기억을 repo 단위, workspace 단위, organization 단위 중 어디서 시작할지 결정한다.
- [ ] RAG update cycle의 trigger와 freshness 기준을 결정한다.
- [ ] MCP를 context 절약 경계로 사용할지, IOP native knowledge endpoint를 우선할지 결정한다.
- [ ] worker/background job 경계와 저장소 후보를 결정한다.

## 구현 잠금

- 상태: 잠금
- 결정 필요: 아래 체크리스트
  - [ ] 장기 기억의 첫 저장 단위를 결정한다.
  - [ ] RAG update cycle을 수동, watcher, scheduler 중 어디서 시작할지 결정한다.
  - [ ] embedding/index 저장소와 권한 metadata 동기화 기준을 결정한다.

## 범위

- 특정 repo 장기 기억 저장소의 2차 후보 정리
- RAG ingestion/update loop, chunking, embedding, vector index, incremental reindex의 경계 초안
- MCP를 통한 context size 절약 또는 IOP native knowledge endpoint 후보
- 권한 metadata와 freshness 관리의 검토 항목

## 기능

### Epic: [rag-memory] Long-Term Memory

MVP 이후 장기 기억/RAG 라인을 구체화하기 위한 최소 산출물을 묶는다.

- [ ] [memory-scope] 장기 기억 저장 단위와 제외 범위가 정리되어 있다.
- [ ] [update-loop] RAG update cycle과 freshness 기준 후보가 정리되어 있다.
- [ ] [mcp-context] MCP context 절약과 IOP native knowledge endpoint 후보가 비교되어 있다.
- [ ] [second-review] 사용자가 2차 RAG/장기 기억 범위와 우선순위를 검토했다.

## 완료 리뷰

- 상태: 없음
- 요청일: 없음
- 완료 근거: 스케치 Milestone이며 기능 Task가 아직 충족되지 않았다.
- 리뷰 필요:
  - [ ] 사용자가 완료 결과를 확인했다
  - [ ] archive 이동을 승인했다
- 리뷰 코멘트: 없음

## 범위 제외

- 1차 MVP 구현
- embedding/index 저장소 확정
- worker/background job 구현
- 모든 repo 권한 모델 확정

## 작업 컨텍스트

- 관련 경로: `apps/worker`, `packages/go/jobs`, `packages/go/metadata`, `packages/go/policy`, `apps/edge`, `apps/control-plane`
- 표준선(선택): 기본 모델 serving/load routing과 단계 호출 MVP가 먼저 안정화된 뒤 RAG/장기 기억을 붙인다.
- 선행 작업: 단계 호출과 검증 최적화 MVP, 운영 관측과 Provider 관리
- 후속 작업: [누적 요청 컨텍스트 구성과 최적화](request-context-assembly-optimization.md) 연동, 품질 기반 retrieval 평가
- 확인 필요: 저장 단위, update trigger, MCP/native 경계, storage/worker 후보
