Businesses now give AI tools their policies, figures and step-by-step guides. Each tool can want them in a different shape. In June 2026 Google Cloud published an open format to fix that, the Open Knowledge Format (OKF). Each piece of knowledge is a plain text file with a short labelled header at the top. A folder of these files is called a bundle. People can read it, and any AI tool can too.
The mistake most people make
They keep knowledge files with no source, no date and no status, so neither people nor the AI can tell which one is current.
“A distributor keeps two returns policy files in a shared folder. They asked the AI: 'How many days does a customer have to return goods?'”
“Customers have 30 days to return goods.”
How it works: the shipping container
Before the standard container, every cargo was packed differently: sacks, crates, jars. Each piece was loaded by hand. Then came the standard steel box. Any crane, lorry or ship could move it without opening it. OKF aims to be that box for knowledge. Every card has the same labelled header, so any tool knows where to find its type, its sources and its status.
What is on an OKF card
1. The header
A few labelled lines at the top of the file, between two lines of '---'. Only one label is required: 'type', a short word such as policy or metric. 'title' and 'description' are recommended.
2. Where it came from
'sources' lists the documents the card is based on. Each entry has a 'resource': a link or a file path.
3. Who wrote it and who checked it
'generated' records who or what wrote the card and when. 'verified' records who checked it and when. A person is written as 'human:' followed by a name or ID.
4. Is it still current
'status' is draft, stable or deprecated. 'stale_after' is the date after which the card needs checking again.
5. Links between cards
Cards link with ordinary links, such as '[Freight terms](/policies/freight-terms.md)'.
How to keep a bundle
Turn this document into a knowledge card in Google Cloud's Open Knowledge Format (OKF v0.2).
Here is the document:
"""
[Paste your policy, process note or business rule here]
"""
Where it lives: [link or file path of that document]
Write the card exactly in this shape:
---
type: [policy | metric | process | concept]
title: [short title]
description: [one sentence on what this card covers]
tags: [two or three short tags]
sources:
- resource: [link or file path given above]
title: [name of the document]
generated: { by: [name of the AI tool]/[version], at: [today, YYYY-MM-DDTHH:MM:SSZ] }
status: draft
stale_after: [a date I choose, YYYY-MM-DDT00:00:00Z]
---
# [Title]
[One short paragraph on what this card covers.]
## Rules and figures
[Bullets or a table, using only what the document says]
## Related
[Two or three links to related cards, written as [Name](/folder/card-name.md)]
Rules:
1. Use only facts from the pasted document. Mark anything unclear or missing [CHECK].
2. Don't add a "verified" line. The person who checks the card adds it.
3. Leave status as draft.The AI drafts a card in the published format, with its source and an expiry date. It stays a draft until a named person checks it and marks it stable.
Why does an OKF card carry 'status', 'stale_after' and 'verified' in its header?
Show the answer
So a person or an AI reading it can tell if it is current, when it needs checking again, and who checked it. That stops an old policy being used as if it were today's.