한줄 요약
Google Cloud는 LLM-wiki 패턴을 표준화한 오픈 스펙 Open Knowledge Format(OKF) v0.1를 공개했고, 마크다운 + YAML 기반 지식 번들을 에이전트와 사람이 함께 읽고 교환할 수 있게 하겠다고 제안한다. moc-llm-wiki moc-ai-agents
배경: 왜 필요한가
- 조직의 핵심 컨텍스트는 데이터 카탈로그, 위키, 코드 주석, 노트북 셀, 시니어 엔지니어의 머릿속 등에 흩어져 있다.
- AI 에이전트가 정확한 답을 내기 위해서는 이런 파편화된 정보를 매번 다시 조립해야 하는데, 벤더마다 API·SDK·스키마가 달라 재사용이 어렵다.
OKF의 핵심 아이디어
- 지식을 “살아 있는 위키”처럼 다루자는 접근이다. 에이전트가 문서를 읽고, 보강하고, 업데이트하는 공동 저장소로 운영한다.
- Karpathy가 말한 LLM Wiki 패턴을 일반화해, 서로 다른 생산자와 소비자 사이에서 그대로 주고받을 수 있는 포터블한 형식으로 정의한다.
- 기본 단위는 디렉터리 안의 markdown 파일이며, YAML frontmatter로
type,title,description,resource,tags,timestamp같은 구조화 필드를 담는다.
설계 원칙
- 최소한의 규칙만 강제한다. 문서마다 사실상
type하나만 강하게 요구하고, 나머지는 생산자가 정한다. - 생산자와 소비자를 분리한다. 사람이 만든 번들, 파이프라인이 만든 번들, LLM이 만든 번들 모두 같은 형식으로 교환 가능해야 한다.
- 플랫폼이 아니라 형식이다. 특정 클라우드, DB, 모델, 에이전트 프레임워크에 종속되지 않는다.
함께 공개한 것
- BigQuery 테이블/뷰를 훑어 OKF 문서를 자동 초안 작성한 뒤, 신뢰할 수 있는 문서와 교차 검증해 보강하는 enrichment agent
- OKF 번들을 인터랙티브 그래프로 보여 주는 정적 HTML visualizer
- GA4 이커머스, Stack Overflow, Bitcoin 공개 데이터셋 샘플 번들
앞으로의 방향
- OKF v0.1은 시작점이며, 실제로 어떤 지식 표현이 필요한지는 producer/consumer 생태계가 커지며 다듬어질 것이다.
- Google은 저장소, 스펙, 샘플 번들을 공개했고, Google Cloud Knowledge Catalog도 OKF를 ingest/serve할 수 있도록 업데이트했다고 밝힌다.
이 노트의 해석
- 이 글은 “새로운 지식 서비스”보다 “교환 가능한 지식 형식”이 필요하다는 주장이다.
- 위키, 카탈로그, 에이전트 메모리를 한 형식으로 묶는다면, 데이터 공유와 에이전트 운영 모두가 쉬워질 수 있다.
관련 노트
- moc-llm-wiki: LLM Wiki 패턴과 위키형 지식베이스 노트 모음
- moc-ai-agents: 에이전트 오케스트레이션과 컨텍스트 관리 관련 허브