구글의 OKF, AI 에이전트가 매번 설명을 덜 듣게 하는 방식

OKF는 의 줄임말로, 구글 클라우드가 2026년 6월 12일 공개한 용 공개 형식이다. 핵심은 코드베이스나 시스템 설명을 매번 에게 다시 입력하지 않고, 프로젝트 안에 `.okf/` 폴더를 두어 지식 파일을 쌓는 것이다. 각 파일은 마크다운으로 쓰고 를 붙이며, 필수 항목은 `type` 하나뿐이다.

별도 SDK, 스키마 등록소, 특정 회사 도구에 묶이는 벤더 종속 없이 파일만 있으면 된다. 처럼 한 장짜리 안내문을 두는 방식과 달리, OKF는 관련 개념끼리 마크다운 링크로 연결되는 지식 그래프에 가깝다. 이 파일들은 코드와 함께 깃에서 버전 관리할 수 있고, Claude Code, Cursor, Codex 같은 여러 에이전트가 함께 읽는 것을 목표로 한다.

RAG와의 차이도 중요하다. OKF는 사람이 정리한 프로젝트 지식을 오래 유지하는 데 맞고, RAG는 많은 문서에서 필요한 내용을 찾아오는 문제에 더 맞는다는 관점이다.

핵심 포인트

  • OKF는 구글 클라우드가 2026년 6월 12일 공개한 용 공개 형식이다.
  • 프로젝트 안의 `.okf/` 폴더에 마크다운 지식 파일을 두어 에이전트가 읽게 한다.
  • 필수 항목은 `type` 하나이며, SDK나 스키마 등록소가 필요 없다는 점을 내세운다.
  • 한 장짜리 안내문보다 지식 그래프처럼 개념끼리 연결하는 구조에 가깝다.
  • 반복 설명을 줄일 수 있어 구축과 토큰 절감에 연결될 수 있다.

이 사건을 다룬 원문 (4)

원문 보기