3.6 KiB
3.6 KiB
Milestone: 지속 갱신 Orchestration
위치
- Roadmap: ROADMAP.md
- Phase: PHASE.md
목표
source 변화와 정기 schedule을 기준으로 수집·정제·인덱싱·평가를 반복하고 candidate release까지 만드는 표준 갱신 workflow를 제공한다. 초기 운영에서 production 승격은 자동화하지 않고 명시적 gate 뒤에 둔다.
상태
[스케치]
승격 조건
- schedule, source event와 수동 실행의 trigger 중복 제거 규칙을 확정한다.
- knowledge base별 refresh policy와 동시 실행 제한을 정의한다.
- 실패 지점부터 재개할 artifact·revision 기준을 정의한다.
- 평가와 승격 Gate의 candidate handoff 계약을 연결한다.
- lifecycle·schedule·candidate handoff를 다루는 SDD 필요성을 확정하고 SDD를 작성했다.
구현 잠금
- 상태: 잠금
- SDD: 필요
- SDD 문서: SDD.md
- SDD 사유: trigger deduplication, 동시 실행, checkpoint·resume과 candidate handoff 상태 계약을 정의한다.
- 잠금 해제 조건:
- SDD 잠금이 해제되어 있다.
- SDD 사용자 리뷰가 없거나 승인/해결되었다.
- Acceptance Scenario가 Milestone 기능 Task와 연결되어 있다.
- Evidence Map이 완료 시 Roadmap Completion과 최종 검증 evidence로 검증 가능하게 연결되어 있다.
- 모든 승격 조건이 해소되고 Milestone 상태가
[계획]이다.
- 결정 필요: 없음
범위
- schedule, source event와 수동 trigger의 표준 입력
- source revision 기반 deduplication과 concurrent run 제한
- 수집부터 candidate evaluation까지의 reference workflow
- 단계별 artifact checkpoint와 실패 재개
- refresh history, 비용·duration·freshness 지표
기능
Epic: [refresh] 반복 갱신 루프
프로젝트마다 재구현하지 않아도 되는 기본 RAG 최신화 workflow를 정의한다.
- [trigger-policy] schedule·event·manual trigger를 정규화하고 같은 source revision의 중복 run을 막는다.
- [reference-flow] ingest, normalize, dataset, index, evaluate 단계를 versioned reference workflow로 제공한다.
- [checkpoint-resume] 완료 artifact와 revision을 재사용해 실패 단계부터 안전하게 재개한다.
- [candidate-handoff] 통과·실패한 평가 결과와 candidate release를 승격 gate에 전달한다.
- [refresh-observability] freshness lag, 처리량, 비용, 실패 단계와 다음 예정 실행을 노출한다.
완료 리뷰
- 상태: 없음
- 요청일: 없음
- 완료 근거: 스케치 단계이며
[계획]승격 뒤 기록한다. - 검토 항목: 승격 조건과 후속 SDD gate
- agent-ui 상태 반영: 해당 없음
- 리뷰 코멘트: 없음
범위 제외
- evaluation 통과만으로 production release 자동 승격
- 외부 범용 workflow 제품의 모든 기능 재구현
- 무제한 병렬 refresh
작업 컨텍스트
- 관련 경로:
packages/go/workflow/,packages/go/controlplane/,db/ - 표준선(선택): candidate build와 explicit promotion 분리, revision 기반 idempotency
- 선행 작업: 내구성 있는 Workflow Runtime, 평가와 승격 Gate
- 후속 작업: Drift와 선별 Feedback
- 확인 필요: 없음