Open Knowledge Format
概略：LLM wikiみたいな仕組みはいいけども、そのマークダウンファイルって書式が一定していないよな。その場合、ファイルを共有したりするの面倒じゃね？ 今必要なのは、それを一般化できるフォーマットっしょ。
An OKF bundle is a directory of markdown files representing concepts: anything you want to capture, including tables, datasets, metrics, playbooks, runbooks, and APIs. Each concept is one file. The file path is the concept's identity:
OKFバンドルは、概念を表すMarkdownファイルのディレクトリです。テーブル、データセット、メトリクス、プレイブック、ランブック、APIなど、キャプチャしたいあらゆるものを表現できます。各概念は1つのファイルで表されます。ファイルパスは概念の識別子です。
code:.sample
sales/
├── index.md
├── datasets/
│ ├── index.md
│ └── orders_db.md
├── tables/
│ ├── index.md
│ ├── orders.md
│ └── customers.md
└── metrics/
│ ├── index.md
└── weekly_active_users.md
code:sample.md
---
type: BigQuery Table
title: Orders
description: One row per completed customer order.
timestamp: 2026-05-28T14:30:00Z
---
# Schema
| Column | Type | Description |
|---------------|-----------|------------------------------------------|
| order_id | STRING | Globally unique order identifier. |
| customer_id | STRING | FK to customers(/tables/customers.md). | # Joins
Joined with customers(/tables/customers.md) on customer_id. wikiリンクではなく、マークダウンリンクを使う
明示的だし、フォルダで分かれているので同名のmdファイルも区別できる
1. 少なくともtypeだけは持たせる
Textboxと同じだ
2. 作り手と使い手を完全に独立させる
あるツールで作ったから、そのツールでしか使えない、みたいなことにしない
3. プラットフォームじゃなくフォーマット