# 로드맵

## 고정 실행 순서

- 전역 Milestone 실행 순서는 [전역 마일스톤 실행 순서](priority-queue.md)를 먼저 확인한다.
- Phase는 도메인/책임 영역이며 순차 실행 게이트가 아니다.
- Phase 흐름과 상태는 로드맵 구조를 설명하고, 실제 다음 작업 선택은 `priority-queue.md`의 위아래 순서를 우선한다.
- `priority-queue.md`는 순서 전용 문서이며, 상태, 목표, 범위, 잠금, 기능, 완료 근거는 각 Milestone 문서를 원본으로 삼는다.
- `priority-queue.md` 항목은 Milestone 제목 링크와 식별용 한 줄 설명만 둔다.
- `priority-queue.md`는 사용자가 순서 조정을 요청한 경우, Milestone archive 시 완료 항목 제거가 필요한 경우, 큐에 있는 Milestone이 폐기, 경로 변경, split/merge, 또는 실행 의미가 바뀔 정도로 수정된 경우에만 재정렬한다.

## 전체 목표

RARA는 프로젝트마다 달라지는 저장소와 모델 제품을 교체 가능한 integration 뒤에 두면서, 소스 수집부터 검색·응답·평가·릴리스·지속 갱신까지 RAG 수명주기를 표준화하는 운영 플랫폼이 된다. 검증된 데이터는 선택적으로 LoRA/QLoRA adaptation으로 승격할 수 있지만, 주 책임은 최신성과 품질이 관리되는 RAG 운영에 둔다.

## Phase 흐름

Phase는 실행 순서가 아니라 도메인/책임 영역의 구조적 지도다.
완료된 Phase도 로드맵에서 제거하지 않고, archive의 Phase 문서로 연결한다.
실제 다음 작업 선택은 [전역 마일스톤 실행 순서](priority-queue.md)의 위아래 순서를 우선한다.

- [진행중] 플랫폼 기반
  - 경로: [PHASE.md](phase/platform-foundation/PHASE.md)
  - 요약: integration 카탈로그, secret·artifact 경계와 project-scoped Control Plane API를 제품 중립적으로 고정한다.
- [계획] 워크플로우 자동화
  - 경로: [PHASE.md](phase/workflow-automation/PHASE.md)
  - 요약: 장시간 실행과 재시도에 안전한 workflow runtime과 지속 갱신 루프를 제공한다.
- [계획] 지식 수명주기
  - 경로: [PHASE.md](phase/knowledge-lifecycle/PHASE.md)
  - 요약: 소스 변경을 정규화된 버전 데이터셋과 lineage로 전환한다.
- [계획] RAG 서빙
  - 경로: [PHASE.md](phase/rag-serving/PHASE.md)
  - 요약: 후보 인덱스 게시부터 버전이 식별되는 retrieve·answer까지 온라인 경로를 완성한다.
- [계획] 품질 거버넌스
  - 경로: [PHASE.md](phase/quality-governance/PHASE.md)
  - 요약: 평가, retrieval 정책 최적화, 승격, 롤백, drift와 feedback으로 품질 변화를 통제한다.
- [스케치] 선택적 adaptation
  - 경로: [PHASE.md](phase/selective-adaptation/PHASE.md)
  - 요약: 검증된 데이터만 훈련 데이터셋과 선택적 LoRA/QLoRA 실행으로 승격한다.
- [스케치] 운영 제품화
  - 경로: [PHASE.md](phase/operations-productization/PHASE.md)
  - 요약: identity·권한·감사, 운영 UI와 production 신뢰성 경계를 완성한다.

## 로딩 정책

- 일반 작업에서는 [ROADMAP.md](ROADMAP.md)를 매번 읽지 않는다.
- Phase를 가로지르는 다음 작업 후보를 고를 때는 [전역 마일스톤 실행 순서](priority-queue.md)를 먼저 확인한다.
- 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 [current.md](current.md)를 먼저 읽는다.
- `current.md`는 현재 작업 위치가 아니라 활성 Phase와 활성 Milestone 후보 목록이다.
- `current.md`는 브랜치별 로컬 포인터이며 git 추적 대상이 아니다.
- 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Phase와 Milestone 문서를 같은 세션에서 1회 읽는다.
- 상세 작업은 각 Milestone 문서의 `기능`으로 관리한다. 검증이 필요한 기능만 같은 Task 안에 `검증:`으로 통합한다.
- 큰 Milestone의 설계 게이트는 [SDD 디렉터리](sdd/)에 두고, Milestone `구현 잠금`의 SDD 조건과 연결한다.
- `[스케치]` Phase/Milestone은 구현 계획 생성 대상이 아니며 `승격 조건`을 해소한 뒤 `[계획]`으로 전환한다.
- 모든 기능 Task와 검증이 충족된 Milestone은 먼저 `[검토중]`으로 두고, 완료 근거와 archive 조건이 정리되면 `[완료]`로 전환한다.
- `agent-roadmap/archive/**`는 일반 작업에서 읽지 않는다.
- 선택된 Milestone의 `구현 잠금`이 `잠금`이거나 미완료 `결정 필요` 항목이 있으면 구현 계획과 코드 구현을 시작하지 않는다.
- `SDD: 필요` Milestone은 SDD 상태가 `[승인됨]`이고 SDD 잠금이 해제되었으며 사용자 리뷰가 없어야 구현 계획을 만들 수 있다.