比較ページ
OKF vs AGENTS.md
AGENTS.md はコードエージェントにリポジトリ指示を与えます。OKF はより広く、製品、API、データ、運用知識を型付き Markdown ファイルで扱います。
Open Knowledge Format (OKF)
カタログ化、検索、検証、ツール間再利用ができる独立した知識オブジェクト。
- Markdown と YAML frontmatter
- 概念単位のファイル
- カタログとエージェント検索に有用
AGENTS.md
リポジトリ固有の指示、コーディング規約、テストコマンド、エージェント運用ルール。
- 元の形式は本来の役割に使う
- 知識にメタデータが必要なとき OKF を追加
- 異なる検索課題を解くなら両方使う
推奨
AGENTS.md は repo behavior に、OKF は単一コードベースの外でも残すべきポータブル知識に使います。
Open Knowledge Format の他の比較
FAQ
OKF vs AGENTS.md はいつ使うべきですか？
AGENTS.md は repo behavior に、OKF は単一コードベースの外でも残すべきポータブル知識に使います。
Open Knowledge Format (OKF) は置き換えになりますか？
通常はいいえ。OKF は、知識をエージェントやカタログが扱いやすくする補完として有効です。
最も始めやすい方法は何ですか？
まずテンプレートを使い、検証し、ユーザーがすでに検索するドキュメントの近くに公開します。