toki/rara
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
rara/agent-roadmap/ROADMAP.md
toki d4546ecbfd
Some checks are pending
ci / validate (push) Waiting to run
Details
add agent-roadmap
2026-07-18 19:31:48 +09:00

4.7 KiB
Raw Permalink Blame History

로드맵

고정 실행 순서

  • 전역 Milestone 실행 순서는 전역 마일스톤 실행 순서를 먼저 확인한다.
  • 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 문서로 연결한다. 실제 다음 작업 선택은 전역 마일스톤 실행 순서의 위아래 순서를 우선한다.

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

로딩 정책

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