Open Knowledge Format · v0.2 · Google Cloud

에이전트가 출처를 밝힐 수 있는 지식

OKF는 에이전트가 쓰고 사람이 믿고 쓰는 지식을 위해 Google Cloud가 만든 공개 사양이에요. 마크다운 파일이 담긴 폴더이고, 각 파일은 주장이 어디서 왔는지, 누가 확인했는지, 언제 만료되는지 알려 줘요. Knowtarium은 OKF 위에 만들어졌어요.

GitHub에서 사양 읽기 무료로 시작하기

번들

마크다운 폴더. 그게 전부예요.

OKF 번들은 YAML frontmatter가 있는 마크다운 파일들의 디렉터리예요. 데이터베이스도, 스키마 레지스트리도, 꼭 필요한 도구도 없어요. 텍스트 파일을 열 수 있으면 읽을 수 있고, 폴더를 복사하거나 저장소를 클론할 수 있으면 공유할 수 있어요.

파일 하나가 개념 하나예요. 지표, 정책, 고객 인터뷰, 런북 같은 것들이요. 필수 필드는 type 하나뿐이에요. 폴더는 팀에 맞는 방식으로 개념을 묶고, 파일 이름 두 개는 예약되어 있어요. index.md는 폴더에 무엇이 있는지 보여 주고, log.md는 무엇이 바뀌었는지 기록해요.

bundle

~/kb/
  index.md                  # what's in this folder (optional)
  log.md                    # what changed, newest first (optional)
  company/
    mission.md
    glossary.md
  metrics/
    revenue.md              # one concept per file
    churn.md
    computations/
      quarterly-revenue.md  # an attested computation
  customers/
    segments.md
    interviews/
      northwind-traders.md

문서 안을 보면

frontmatter가 답하는 네 가지 질문.

에이전트가 지식 베이스의 대부분을 쓰면, 읽는 사람에게는 본문 이상의 정보가 필요해요. OKF v0.2는 몇 가지 선택형 필드 묶음을 더해서 모든 문서가 같은 질문에 답하게 해요. 모두 선택 사항이에요. type만 있는 문서도 유효하고, 빠진 묶음은 그저 답을 모른다는 뜻이에요.

본문의 주장은 [^billing-export]처럼 id로 연결된 각주로 출처를 밝혀요. 그래서 에이전트가 목록 순서를 바꿔도 링크가 살아 있어요.

metrics/revenue.md

---
type: Metric
title: Quarterly revenue
tags: [finance, revenue]
status: stable
generated: { by: claude-code/2.1, at: 2026-09-26T07:42:00Z }
verified:
  - { by: human:maya, at: 2026-09-26T10:05:00Z }
stale_after: 2026-12-31T00:00:00Z
sources:
  - id: billing-export
    resource: exports/billing/2026-09.csv
    author: process:billing-sync
owner: human:maya          # your own keys are kept as written
---
 
Q3 revenue was €112,400, up 12% on Q2.[^billing-export]

provenance

어디서 왔나요?

주장마다 id로 출처를 밝혀요. 출처에는 누가 썼는지, 얼마나 자주 쓰이는지, 언제 바뀌었는지가 담겨요.

sources · usage_window

trust

누가 확인했나요?

누가 문서를 썼는지, 그리고 그 뒤로 확인한 모든 사람이나 프로세스가 시간과 함께 남아요.

generated · verified

lifecycle

아직 유효한가요?

draft, stable, deprecated 상태, 그리고 문서를 더 이상 안심하고 인용할 수 없게 되는 시점.

status · stale_after

attestation

이 숫자는 승인된 방식으로 계산됐나요?

계산은 별도 문서에 있어요. 에이전트가 매개변수를 채우고, 결정론적 검사가 승인된 쿼리가 실행됐는지 확인해요.

runtime · parameters · executor · attester

신뢰 등급

선언하지 않고, 도출해요.

어떤 문서도 스스로 믿을 만하다고 말할 수 없어요. 읽는 쪽이 verified에 누가 있는지 보고 등급을 판단하고, stale_after로 오래됐는지 판단해요. 검토를 켜면 Knowtarium은 오직 이 규칙에 따라 모든 노트에 색을 입혀요.

unverifiedverified 항목이 하나도 없어요.

machine-confirmedprocess:ci처럼 에이전트나 프로세스만 확인했어요.

human-reviewedhuman:maya처럼 적어도 한 사람이 확인했어요.

stale등급과 상관없이 현재 시각이 stale_after를 지났어요.

누가 했나요

모든 by 필드는 세 가지 형식 중 하나로 행위자를 적어요. human: 접두사가 있어야 그 확인이 사람의 검토로 인정돼요.

claude-code/2.1: 에이전트나 도구, 그리고 그 버전
human:maya: 사람
process:finance-nightly: 자동화된 프로세스

Knowtarium과 OKF

앱이 읽고 쓰는 것.

Knowtarium은 모든 노트를 OKF로, 내 기기에서 암호화해서 저장해요. 사양을 충실히 따르기 때문에, 가져온 것은 다른 모든 OKF 도구가 쓸 수 있는 번들로 다시 나와요.

어떤 번들이든 가져와요

OKF 번들이나 Obsidian 볼트를 워크스페이스로 가져오세요. 빠진 필드, 모르는 type, 모르는 키, 깨진 링크가 있어도 노트를 못 읽게 되는 일은 없어요.

내보내면 그냥 OKF예요

모든 워크스페이스를 OKF 번들 zip 하나로 내보내요. 브라우저에서 복호화되고, 다른 어떤 OKF 도구에서도 바로 쓸 수 있어요.

내 키는 그대로 남아요

직접 만든 frontmatter 키, 주석, 서식은 사양이 요구하는 대로 쓴 그대로 유지돼요.

사람의 이름에는 서명이 필요해요

human: 항목은 그 사람이 직접 서명한 변경으로 확인될 때만 인정돼요. 그래서 에이전트가 자기 작업을 내 것처럼 꾸밀 수 없어요.

검토는 선택이고, 항목 하나만 써요

워크스페이스나 폴더에 검토를 켜면, 변경을 승인할 때 verified에 내 이름이 시간과 함께 추가돼요. 검토가 쓰는 필드는 이것 하나뿐이에요.

기록은 노트 밖에 있어요

버전, 댓글, 서명은 각 노트 옆에 암호화되어 저장돼요. 그래서 노트 자체는 깔끔한 OKF로 남아요.

Obsidian에서 온다면

내 볼트는 이미 거의 준비돼 있어요.

Obsidian 볼트는 이미 frontmatter가 있는 마크다운 폴더예요. 워크스페이스로 가져오거나, 사본을 로 오프라인에서 변환하세요. 내가 쓴 글은 건드리지 않고 OKF 필드를 더하고, 위키링크를 마크다운 링크로 바꾸고, 인덱스를 써 줘요.

OKF는 Google Cloud가 GitHub의 open-knowledge-format 저장소에 공개한 열린 형식이에요. Knowtarium은 독립적인 앱이며 Google과 제휴하거나 Google의 보증을 받지 않았어요.