GitLab OKF 전달과 Runtime 소비

okf-syncer가 리뷰된 지식과 summary contract를 검증된 snapshot으로 나눠 Agent와 data-summary에 제공합니다.

01 / 운영자 · 리뷰 02 / GitLab SSOT 03 / okf-syncer Event Loop 04 / 일반 Agent Runtime 05 / data-summary Runtime MR 리뷰 · 승인 이벤트 · 검증 · snapshot 선택적 조회 · 안전한 소비 MR 리뷰 승인 · rollback 수동 게이트 wiki OKF prose 지식 summary OKF contract 전용 Webhook · Poll push · periodic reconcile 검증 Snapshot selector · ETag · atomic last-known-good Knowledge cache snapshot overlay Agent Runtime 검색 · prompt 주입 Contract cache contract overlay data-summary facts → summary.v1 A2A Agent push event knowledge snapshot contract snapshot semantic DataPart Legend User UI Agent logic Policy Tool action Context / trace

GitLab은 리뷰 SSOT

  • • wiki 지식과 summary contract를 별도 repo와 MR로 검토합니다.
  • • GitLab Deploy Token은 okf-syncer만 read_repository 범위로 보유합니다.
  • • Agent와 data-summary는 GitLab 주소나 토큰을 알지 않습니다.

okf-syncer Event Loop

  • • Webhook은 즉시 reconcile을 예약하고 polling은 누락 이벤트를 보완합니다.
  • • type·path·schema·크기 제한을 통과한 snapshot만 원자적으로 게시합니다.
  • • GitLab 또는 검증 실패 시 직전 성공 snapshot을 계속 제공합니다.

서로 다른 Runtime 소비자

  • • 일반 Agent는 prose 지식을 검색해 prompt context로만 사용합니다.
  • • data-summary는 contract로 DataPart facts를 투영해 llamon.work-summary.v1을 만듭니다.
  • • 원격 snapshot을 끄거나 실패해도 각 이미지의 immutable local baseline으로 동작합니다.

Workflow diagram • Built with Archify • Press T for theme and E for export