Open Knowledge Format: пераносная памяць для AI-агентаў кадавання
Open Knowledge Format захоўвае тое, чаму вучацца агенты кадавання, як звязаныя Markdown-файлы. Чым ён адрозніваецца ад CLAUDE.md і MCP і як пачаць ім карыстацца ўжо сёння.
Крыніцы: Google Just Quietly Released the Missing Piece for AI Agents. It’s Called OKF.
Фармат Open Knowledge — гэта стандарт, які мае на меце зробіць памяць агента перэносным, версіяваным і чытальным для кожнага інструмента ў комплексе распрацоўшчыка.
Проблема пачатку з нуля ў кожны ранак
Кожны, хто вікорыстоўвае AI-агента для кодавання, сталкнуўся з тым самым працягам. Сесія заканчваецца, і наступнага дня агент нічога не памятае. Ён зноў адкрывае працэс аўтэнтыфікацыі, знову намагаецца зрозумець прычыны рашэння, прынятага тры гады тыму, і зноў чытае тыя ж пяць файлоў, каб воссстанавіць кантэкст, які ўчора трэба было поясняць гадзіну.
Звычным спосабам рашэння являюцца файлы CLAUDE.md або AGENTS.md — дакументы кантэксту, якія чытуюцца на пачатку кожнай сесіі. гэта прымітныя інструменты. Яны запоўнююцца всімі данымі праз кожны запуск, незалежна ад таго, чы рэальна гэта неабходна, яны напісаны для аднаго агента на адной платформе і парадоксальна паслужаюць эфектыва. Кроме таго, яны сумішваюць інструкціі па поведэнцыі, такія як «заўжды пісаць тэсты», з фактамі, такімі як «табліца замовленняў з’яўляецца ў спілкуванні з табліцай кліентаў праз поле customer_id», што быстра прыводзіць да хаосу.
12 чэрвеня 2026 года Google Cloud выпусціла спецыфікацыю, створаную для падрыхтавання гэтага прыему, якая называецца Open Knowledge Format (OKF). Гэта найболей адорганізаваны спосаб рашэння проблемы памяці агентаў на сягоднішні дзень.
Дзе сёньня знаходзіцца знанні
Падазроўваючы, што агенту трэба адпаведзець на пытанне, як вылічваюцца ўсё актыўныя корыстувальнікі на тыдзень на адной струе адбываючыхся здарэнняў, адпаведзь распадзяецца прынеймна на чатыры месца:
+-----------------------+--------------------------------------------+
| WHERE IT LIVES | WHAT'S THERE |
+-----------------------+--------------------------------------------+
| Metadata catalogs | Table schemas (but vendor-locked APIs) |
| Wiki / Notion | Runbooks, metric definitions |
| Code comments | Docstrings, inline notes |
| People's heads | Join paths, deprecation warnings |
+-----------------------+--------------------------------------------+
Нічыя з элементаў тут не рухаецца разам з кодам, і нічыя не застаецца пасля закрыцця новага вікна кантэксту. Кожны стваральнік агента зноў рашае тую ж задачу складання кантэксту, а кожны продавец каталага стварае свае схемы.
OKF верыць, што тут не хапае фармата, а не ўсё новай платформы.
Што такое фармат
Версія 0.1 фармата адкрытых ведамаў — гэта адкрытая, нейтральная па відношэнню да продавцоў спецыфікацыя, ліцензаваная пад Apache 2.0. Ведамы зберагаюцца у відпаведным каталозе файлаў у фармаце markdown, кожны з якіх мае YAML-фронтматэр. Гэта звучыць проста, таму што так і ёсць, і гэта ўмышлена.
Няма рэжыстрару схем, няма двайхародкі гэнератора і няма обавязковага SDK. Любы прыстрой, які можа выкарыстоўваць cat для чытання файла, можа яго прачытаць, а любы прыстрой, які можа выкарыстоўваць git clone для копіювання рэпазітарыю, можа яго адправіць. Весь спектакль пасядае на адной сторонцы і мае роўна адна обавязковая польна, прычым усе іншае ёсць необавязковым або залічваецца за рашэнне таго, хто стварае пакет.
Структура пакета
Пакет — гэта проста папка, а шлях да файла служыць як ідэнтыфікатар яго канцэпцыі.
.okf/
+-- index.md <- progressive entry point
+-- log.md <- dated change history, newest first
+-- services/
| +-- index.md
| +-- auth-api.md <- one concept = one file
| +-- payments-service.md
+-- datasets/
| +-- index.md
| +-- orders-db.md
+-- metrics/
| +-- index.md
| +-- weekly-active-users.md
+-- decisions/
+-- index.md
+-- why-we-use-postgres.md
У кожнай пакетнай структуры зарэзерваваны два імены файла:
index.mdадмініструець прогрэсіўную адкрыць інфармацыі. Агенты пераходзяць праз пакет, чытаючы індэкс на кожным рэвэлі і спускаючыся ніжэй толькі тады, калі гэта неабходна задачу. Гэта той самы поэтапны завантажэння, які дапамагае Claude Skills эканомічна вікорыстоўваць токены.log.md— гісторыя змян з датамі па стандарту ISO, новейшыя ентры першыя. Людзі і агенты, якія адтулькуюць пакет, дадаюць да яго новыя ентры, калі змінююцяся канцэпцыі.
Усі іншыя файлы ўжо ёсць дакументамі канцэпцый, ідэнтыфікаванымі ўжо ўжо ў сваёй шырокаспектной дорозе. Џедынай часткай фронтматэру, якая павінна быць у канцэпцыі, ёсць непустое поле type.
---
type: Service
title: "Auth API"
description: "Issues and verifies short-lived access tokens."
resource: https://github.com/acme/auth
tags: [auth, platform]
timestamp: 2026-06-14T10:00:00Z
---
Потым тэкст параграфа мае звычны фармат Markdown, уключаючы таблыцы.
## Endpoints| Method | Path | Description |
|--------|----------|---------------------------|
| POST | /token | Exchange creds for a JWT. |
| GET | /verify | Validate a token. |## Why This ExistsSee the decision at [decisions/why-we-separated-auth.md](../decisions/why-we-separated-auth.md).
Joins with [datasets/orders-db.md](../datasets/orders-db.md) for user scoping.
Следзее выконуецца главны ўзрошэнні ў дызайне. Канцэпцыі з’яўляюцца ў зв’язку адна з іншайчыма за дапамогою стандартных спыяў Markdown. Гэта прыводзіць да таго, што каталог стае графам, сумкай тыпаваных, перакінутых адносоўна знанняў з чыста выражанымі адносамі, якія можна праходзіць, замест таго, каб быў проста плоскі накуп дакументаў.
[auth-api.md]
/ \
links links
/ \
[decisions/why-separated-auth.md] [datasets/orders-db.md]
|
links
|
[datasets/customers-db.md]
Інструмент, які можа працаваць з маркдаун-супягоў, можа пераходзіць па графе, а агент з правамі на доступ да файлаў можа яго як чытаць, так і пісаць.
Паколькі трэба толькі type, вырабнік сам выбірае, якія тыпы існуюць (Service, Dataset, Metric, Decision, Runbook і т. д.), якія неабяжныя полья вжываць і якія часткі тэла включыць. OKF вялічыць інтэроперабельнасць, а не модэлі кантэнту.
Вырабнікі і спожытчыкі
Фармат працуе аднакова на обох канцах, таму замена вырабніка або спожытчыка не паспрабоўвае зламаць структуру даных.
PRODUCERS CONSUMERS
--------- ---------
Human authors ----> AI agents
BigQuery pipelines ----> HTML visualizers
LLM-generated ----> Search indexes
Wiki exports ----> Other agents / tools
Няма прыватных абанкаў, няма SDK і няма цэнтральнага рэжыстру. Якосць вырастае ў залежнасці ад шырокай адымкі вжывання, а не за дапамогою прыкрэплення да паводліва. Гэта адпавядае філасофіі git, markdown і JSON — фарматаў, якія перазсталі, таму што для ўжывання не выклікалі жадных трэбаванняў.
Як гэта адносіцца да CLAUDE.md і MCP
Большасць плутанняй выходзіць самэ гэтам. OKF не заменяе вядомыя ўжо інструменты. Ён заполняе адзін конкрэтны прызнак.
+---------------------+---------------------------+---------------------------+
| TOOL | PURPOSE | SCOPE |
+---------------------+---------------------------+---------------------------+
| CLAUDE.md | How the agent behaves | Per-project, one agent |
| AGENTS.md | Repo instructions | Per-repo, tool-specific |
| Karpathy LLM wiki | Agent-maintained notes | Pattern, not a spec |
| MCP | Live tool access | Runtime connections |
| OKF | What the team knows | Cross-project, any agent |
+---------------------+---------------------------+---------------------------+
Чыстая ментальная мадэль раздзеляе тры пытанні:
- CLAUDE.md адказвае на тое, як агент павінен себе вядзець.
- OKF адказвае на тое, што команда ведае пра гэтыя сістэму.
- MCP адказвае на тое, якія жывыя інструменты агент можа выклікваць у даны момент.
Яны работаюць разам. У рэядку CLAUDE.md можа быць напісана просьба прачытаць .okf/metrics/ перад выкананнем будзь-яго аналітычнага задання. Пакет OKF пасля чаго супліквае структураваныя знанні, на якія паказуе CLAUDE.md, а з’ўязкі MCP суплікваюць жывыя джэрэлы дадзэнняў, якія опісваюць дакументы OKF.
Ідэя вікі, якая яе падтрымлівае
Андрэй Карпаты, які запрацаваў тэрмін «vibe coding», а сэрцы ўжо вярнуўся да фразы «agentic engineering», опублікаваў артыкул на wiki пра LLM, якая здобыла больш чым 5 000 звёзд. Яго аргумент просты: люды застаўляюць вікі, калі ўтрыманне іх стае клопатам, але агенты не вяргаюцца, не забываюць пераадрасавання чы не маюць проблем з рэдагаванням 15 файлоў за раз.
Той самы патэрн паўтараўся незалежна — у Obsidian у поўнай зусіме з агентамі для кодавання, у рэпазітарыях, заполненых файламі AGENTS.md, а таксама у файлах index.md і log.md у дзесятках праектаў. Люды проста перазнаходзілі тое ж самае. OKF даўае адпаведнасць у тым, якія даны носіць кожны документ і што значаюць імены файлоў, тады розныя вікі, а паўтара ўывод з каталогу BigQuery, можу працаваць разам без патрэбы ў перакладзе.
Спраўа адпаведнасці між гэтымі двума элементамі складаецца з трохоў слоёў:
KARPATHY LAYER OKF EQUIVALENT
-------------- --------------
Raw sources (immutable) --> External datasets, docs, APIs
(OKF bundles are the compiled layer)
Wiki (LLM-maintained) --> OKF bundle (*.md + frontmatter)
(OKF adds type, resource, tags, timestamp)Schema (CLAUDE.md) --> Producer/consumer conventions + okf/SPEC.md
(org-wide spec replaces per-vault bespoke rules)
Як праект Karpathy, так і OKF выдзеляюць index.md і log.md для адзінаковых задач, і гэта супаданне не было прыгодай.
Што дастала Google
OKF — гэта спецыфікацыя, пры тым Google выдала тры практычныя інструменты разам з яю:
- Агент для адгэтування дадзэнайнаў у BigQuery. Указавшы набор дадзэнайнаў, ён стварае документ з концэпцыяй OKF для кожнай табелі і відображэння, а пасля выкарыстоўвае другі алгорытм LLM, які дадае цітаты, схемы і шляхі з’еднання, взятыя з дасяглібнай документацыі. Рэзультатам для складу дадзэнайнаў стае заполнены каталог
.okf/. - Статычны візуалізатор HTML. Ён ператварае будзь-які пакет OKF у інтэрактыўную дыяграму ў аднам самодостатнім файле HTML, без бэкэнда і без чаго-небудзь, што выходзіць за межы стораніцы. Канцэпцыі праказуюцца як вузлы, а звязкі у фармаце markdown — як рэшткі, пры кліканні на вузел ачынаецца панель у стылі wiki з адрасаваным тэкстам у фармаце markdown і зворотнымі звязкамі, пазначанымі як „Звязкі да / Цітаванае“.
- Прыклады пакетаў. Тры рэальныя пакеты на GitHub выкарыстоўваюць публічныя наборы дадзэнняў BigQuery:
+--------------------+----------------------------------+
| BUNDLE | WHAT IT DOCUMENTS |
+--------------------+----------------------------------+
| GA4 e-commerce | Analytics tables and metrics |
| Stack Overflow | Public dataset concepts |
| Bitcoin | Blockchain dataset structure |
+--------------------+----------------------------------+
Яны служаць як шаблоны-прыемнікі для копіювання, а таксама як доказ таго, што фармат застаецца аднаковым у разных доменах.
Калі OKF — правы выбор
Ён падходзіць, калі проблема з ведамасцю выглядае так:
- Тыя ж адказы павтараюцца ў кожнай новай сесіі агента. Калі якісь блакіт кантэкста постаўляецца ў CLAUDE.md, яго трэба размясціць у OKF.
- Ведамасць распрастраńваецца між кількама праектамі аб командамі. CLAUDE.md прыязначаны для аднаго праекту і аднаго агента, тады як OKF дазволяе перамешчаць даны між рэпазітарыямі, агентамі і інструментамі.
- Дакументы праекта павінны маты версіі. OKF знаходзіцца ў git разам з кодам, які ён опісвае; кожныя змены паказваюцца ў фармаце diff, а запросы прыўязкі можу несці апошнія змены ведамасці разам з змінамі коду.
- Сістэма хранення дадзейна — Google Cloud і BigQuery. Існуее прымытая інтэграцыя з каталогам дадзейна Google, які прыймае пакеты і перадае іх агентам GCP.
- Патрэбны графы знанняя, а не простая вікі. Граф звязей у фармаце markdown задае адносіны між канцэпцыямі без выкарыстоўвання базы дадзейна графаў.
У дзеякых случаях гэты выбар ўскладнюе працу:
- Патрэбны дадзейны у рэальным часе, для чаго неабходны тэхналогіі MCP.
- Правіла поведзення трэба кодаваць, і гэта ў прыметах CLAUDE.md.
- Прэкт просты і паслядае за адну сесію, тады дастатнек ад CLAUDE.md самога.
Пачатак работы
За прыметамі дызайну настройкі мінімальныя.
З Claude Code
Плагін okf-skills аб’яднвае тры навыкі. /okf:okf стварае і падтрымлівае аб’яднанні, /okf:validate пераканальваецца, чы рэшта аб’яднання паспаўляе стандартам, а /okf:visualize стварае інтэрактыўную дыяграму. Яго можна установіць так:
/plugin marketplace add scaccogatto/okf-skills
/plugin install okf@scaccogatto
Будзь-які агенты, укладаючы Claude Code, Cursor, Codex і ўсьмох іншых у лісты, могу заместа таго выкарыстоўваць npm:
npx skills add scaccogatto/okf-skills
Потым запускайце навыкі:
/okf:okf produce .okf # create your first bundle
/okf:validate .okf --strict # check conformance
/okf:visualize .okf # generate viz.html
Ёнколі хочаце, каб усё адмініструвалася аўтаматычна, так што Claude чытаў бы файлы з .okf/ перад выкананнем задач і запісваў тое, што выучыў, копіюйце шаблон templates/CLAUDE-okf.md у файл CLAUDE.md праекта. Нічога не змушвае выпалняць гэты крок.
Рэчыпісанне вручную
Створыце каталог .okf/ і дадзіце файл index.md. Потым дадзіце по аднаму файлу з канцэпцыямі для кожнай важлівай дзеянні сістэмы. Файл з рэшэнням выглядае так:
---
type: Decision
title: "Why we use Postgres over MySQL"
description: "JSONB support and row-level security were decisive."
timestamp: 2026-03-01T00:00:00Z
tags: [infrastructure, database]
---
Следуець тэкст:
## ContextIn early 2026 we evaluated both options. MySQL's JSON support was insufficient for our metadata schema...## DecisionPostgres 16. See [datasets/primary-db.md](../datasets/primary-db.md) for schema docs.
Этага ўсё, што трэба. Будзь-яны агент з правамі да файлу можа зараз жа прачытаць яго, а яго таксама можна пераглядзець у PR і прабачыць у git.
Весь комплекс
Ось як OKF стоіць паляглы ўсім іншым у сесіі:
+--------------------------------------------------+
| AGENT SESSION |
+--------------------------------------------------+
| CLAUDE.md / AGENTS.md |
| (behavioral rules - how agent acts) |
+--------------------------------------------------+
| OKF BUNDLE (.okf/) |
| (curated team knowledge - what we know) |
| - index.md: entry points per domain |
| - concepts/*.md: services, datasets, decisions |
| - log.md: change history |
+--------------------------------------------------+
| AUTO-MEMORY (memory.md) |
| (what the agent picked up implicitly) |
+--------------------------------------------------+
| MCP CONNECTIONS |
| (live tool access - what the agent can do) |
+--------------------------------------------------+
| SKILLS (.claude/skills/) |
| (reusable SOPs - how to do specific tasks) |
+--------------------------------------------------+
Кожны слой адаптуецца да адпаведным пытанню. Яны не перакрываюцца, а складаюцца ў ўзеўзе.
Што застаеся нерашаным у v0.1
Google адкрыта называе v0.1 пачатковай точкай, калі спачатку была рашана прыемнасць міжсістэмнага вярнага працавання. Існуе калькі пытанняў дызайну:
- Суперсечанні. Калі два дакументы OKF не пагадваюцца ў чым-небудзь, яшчэ не існуе семантыкі злучэння.
- Застарэлыя даны. Пакалі OKF базуецца на файлах, дакумент, які не быў зменены, калі сістэма развівалася далей, ўзначае абыяковасць працы, а не проблему фармата.
- Тыпаваныя адносы. Сучасныя спецыфікацыі вікорыстоўваюць звычайныя гіпертэкстовыя звязкі, а болей дэталізаваныя тыпы адносаў, такія як суперсечанне, пашырэнне чы абмянуванне, разрабатываюцца спільнай адукацыяй.
- Пошук па аспектах. Дзеяныя спецыялісты жадаюць больш атрыбутаў, чым прысутнае мінімальнае спецыфікацыя.
Версія v0.2, верагчы, будзе рашыць калькі з гэтых проблем на адказ на адзінкіяў, а рэпазітарыю спецыфікацыі ўсі можаць адвідаваць і там прыймаюць прыбылі і патрэцы.
Чаму выграюць нудныя фарматы
Фарматы, якія стаюць частынай інфраструктуры, зазвычай ўсё простае. JSON выграў таму, што быў самым простым спосабам, які работаў і не касаўся нічога у ўжыцці, а не таму, што быў хітрым. Markdown выграў таксама.
OKF падходзіць пад гэтыя апісанні. Яго лёгка чытаць, лёгка пісаць, і ён працуе з будзь-якім інструментам для адработкі файлоў. Яго цэннасць расце з колькасцю тых, хто яго стварае і вжывае, і рашэнні аднае фірмы не можа яго направіць. Ён таксама фіксуе шаблон, да якога людзі власноруч дасяглі за дапамогою Karpathy's gist, прычынкі AGENTS.md і самастраўленых іерархій index.md, што являецца найлепшым доказам таго, што рашаецца рэальная проблема.
Карпаты стверджваў, што агенты лепшая ад людзей адтулькуюць вікі, бо ў іх немаў нуды. OKF сакмуе, што вікі набірае ценнасці толькі тады, калі можа распространяцца. Разам этыя два падходы могу стаць аднай з адной з фундаментальных частак развіцця пад адказом агентаў за калькі гадоў. Іх стварэнне зараз, калі ўсё ў новінку, прынесе плоды як для вас, так і для кожнага агента, якога вы будзеце кераваць.