đ Open Knowledge Format (OKF)
âSpezifikation und Anleitung fĂŒr das Open Knowledge Format â der Standard fĂŒr Emmas Wissensbasis
format
okf
spezifikation
standard
wissensbasis
Aktualisiert: 04.07.2026, 00:49
lortner
2 Revisionen
# Open Knowledge Format (OKF) â Referenz
> Diese Datei dokumentiert wie unsere Wissensbasis aufgebaut ist und wie neue Konzepte hinzugefĂŒgt werden.
> VollstÀndige Spezifikation: [OKF Spec v0.1 (GitHub)](https://github.com/google/open-knowledge-format)
## Was ist OKF?
Ein **offener, vendor-neutraler Standard** (Version 0.1, Google Cloud) fĂŒr WissensreprĂ€sentation, der sowohl von Menschen als auch von AI-Agents gelesen werden kann.
**Kernprinzip**: Ein Ordner mit Markdown-Dateien, jede mit YAML Frontmatter.
## Grundregeln
### 1. Jede Datei = ein Konzept
Ein Konzept kann alles sein: eine Person, ein Tool, ein Projekt, eine Organisation, ein Runbook.
### 2. YAML Frontmatter ist Pflicht
Jede `.md`-Datei (auĂer `index.md` und `log.md`) braucht einen YAML-Block:
â`yaml
â
type:
title: âAnzeigenameâ
description: âEinzeilige Beschreibungâ
resource: âURI der beschriebenen Ressource (optional)â
tags: [tag1, tag2]
timestamp: 2026-06-29T12:00:00+02:00
â
â`
**Einzig pflichtiges Feld**: `type` â alles andere ist optional aber empfohlen.
### 3. Unsere verwendeten Types
| Type | Verwendung | Beispiel
|ââ|ââââ|âââ-
| `person` | Einzelpersonen | Leoâs Profil
| `person-group` | Personengruppen | Familie Ortner
| `profile` | Persönlichkeits-/Interessenprofile | Hobbys, Personality
| `goals` | Ziele & Ambitionen | Leos Ziele
| `organization` | Unternehmen/Organisationen | bĂŒro ortner, Cloud Company
| `team` | Teams innerhalb einer Org | CC Team
| `customer-directory` | Kundenlisten | CC Kunden
| `tool` | Skills & Tools | Email, Jira, WhatsApp
| `contact-directory` | Kontaktverzeichnisse | Telefonbuch
| `project-list` | Projektlisten | bĂŒro ortner Projekte
| `project-group` | Projektgruppen | Pro-Bono Projekte
| `reference` | Referenzdaten | Jira IDs & Keys
| `specification` | Spezifikationen & Doku | Diese Datei
| `index` | Einstiegspunkt/Verzeichnis | knowledge/index.md
### 4. Verlinkung
Konzepte verlinken sich gegenseitig mit Standard-Markdown-Links:
â`markdown
Siehe [Cloud Company](../unternehmen/cloud-company.md) fĂŒr Details.
â`
â **Relative Links** (`./` oder `../`) â empfohlen fĂŒr unsere Struktur
â **Bundle-relative Links** (`/`) â ab Bundle-Root
### 5. Reservierte Dateinamen
| Dateiname | Zweck
|ââââ|ââ-
| `index.md` | Verzeichnislisting fĂŒr Progressive Disclosure
| `log.md` | Chronologische Update-Historie
### 6. Body-Struktur
Der Body ist Standard-Markdown. Empfohlene Konventionen:
â **Strukturiertes Markdown** bevorzugen (Ăberschriften, Listen, Tabellen)
â **`# Schema`** â fĂŒr strukturierte Beschreibungen
â **`# Examples`** â fĂŒr konkrete Beispiele
â **`# Citations`** â fĂŒr externe Quellen
## Neues Konzept hinzufĂŒgen
1. Passenden Ordner wÀhlen (oder neuen erstellen)
2. `.md`-Datei mit YAML Frontmatter anlegen
3. `type` setzen (aus obiger Tabelle oder neuen sinnvollen Type wÀhlen)
4. Inhalt als strukturiertes Markdown schreiben
5. Relevante Cross-Links zu anderen Konzepten setzen
6. `knowledge/index.md` aktualisieren
## Bundle-Struktur
â`
knowledge/
âââ index.md # Einstiegspunkt
âââ leo/ # Persönliches
âââ unternehmen/ # Organisationen & Teams
âââ skills/ # Tools & FĂ€higkeiten
âââ kontakte/ # Kontaktdaten
âââ projekte/ # Projekt-Verwaltung
âââ jira/ # Jira-spezifische Referenzen
âââ meta/ # Meta-Dokumentation (diese Datei)
â`
## Conformance-Regeln (aus der Spec)
Ein Bundle ist **konform** wenn:
1. Jede nicht-reservierte `.md`-Datei YAML Frontmatter hat
2. Jeder Frontmatter-Block ein nicht-leeres `type`-Feld enthÀlt
3. Reservierte Dateien (`index.md`, `log.md`) dem definierten Format folgen
**Toleranz**: Fehlende optionale Felder, unbekannte Types, kaputte Links â alles OK. OKF ist absichtlich permissiv.
## Extensions
| Extension | Version | Description
|ââââ|âââ|ââââ-
| [OKF Attachments](./okf-attachments-spec.md) | v0.1 | BinÀrdateien (PDFs, Bilder, CSV etc.) via `_assets/` Konvention und `attachments` Frontmatter-Feld
# Citations
[1] [OKF Spezifikation v0.1](../../OKF-SPEC.md)
[2] [Google Cloud Blog â How OKF can improve data sharing](https://cloud.google.com/blog/products/data-analytics/how-the-open-knowledge-format-can-improve-data-sharing)