TOON-Format — 22% weniger Tokens als JSON

Was ist TOON?

TOON (Token-Oriented Object Notation) ist ein Datenformat, das für LLMs entworfen wurde. Es verwendet ~22,5% weniger Tokens als JSON (gemessen mit gpt-tokenizer über repräsentative Einträge) bei gleichzeitiger verlustfreier Roundtrip-Unterstützung.

Vergleich

Format	Token-Anzahl	LLM-Genauigkeit
JSON	100	75%
YAML	95	72%
TOON	60	76,4%

Formatstruktur

version: 1
entries[3|]{id|category|key|content|file|tags|date|ttl|accessed|links|quality|confidence|lastAccessed|priority|path_scope|origin|status|supersededOn|importance}:
  a1b2c3d4|decision|use-zod|Use Zod for validation|src/types.ts|validation;types|2026-07-10||0|patterns/zod-schemas|0.80|1.00||0||agent|||
  e5f6g7h8|pattern|pydantic-configs|Project uses Pydantic v2|config.py|python;patterns|2026-07-10||0||0.72|1.00||0|||||high
  i9j0k1l2|bug|redis-pool-fix|Added max_connections=20|redis.ts|redis;fix|2026-07-10|7d|3||0.68|0.85||0||agent|obsolete||
summaries:
  src/services/redis.ts: Redis connection pool with retry logic

Komponenten

Komponente	Beschreibung
`version: 1`	Formatversion
`entries[N\|]{fields}:`	Kopfzeile mit Anzahl und Feldnamen
`id\|category\|key\|...`	Pipe-getrennte Werte
`ttl`	Optionale Lebenszeit (leer = kein Ablauf)
`accessed`	Zugriffszähler (für Wichtigkeits-Rangfolge)
`links`	Semikolon-getrennte Eintragsschlüssel (Graph-Kanten)
`quality`	Qualitätsscore 0-1 (automatisch berechnet)
`confidence`	Konfidenzscore 0-1 (1,0=behauptet, <1,0=inferiert)
`lastAccessed`	ISO-Zeitstempel des letzten Zugriffs (für Wichtigkeits-Rangfolge)
`priority`	Pin-Priorität 1-5 (0 = nicht angepinnt)
`path_scope`	Optionaler Dateipfad-Scope (globMatch-kompatibel)
`origin`	Eintragsherkunft: `human`, `agent` oder leer (inferiert)
`status`	Eintragsstatus: `active`, `obsolete`, `suppressed` oder leer
`supersededOn`	Datum, an dem der Eintrag superseded wurde
`importance`	Explizite Wichtigkeit: `critical`, `high`, `medium`, `low` (leer = automatisch)
`summaries:`	Optionale Dateizusammenfassungen

Eintragsfelder

Feld	Erforderlich	Beschreibung	Beispiel
`id`	Ja	8-Zeichen Hex-ID	`a1b2c3d4`
`category`	Ja	`decision`, `pattern`, `bug`, `knowledge`, `warning`	`decision`
`key`	Ja	Kebab-Case-Titel	`use-zod`
`content`	Ja	Detaillierte Beschreibung	`Use Zod for validation`
`file`	Nein	Zugehöriger Dateipfad	`src/types.ts`
`tags`	Nein	Semikolon-getrennte Tags	`validation;types`
`date`	Ja	JJJJ-MM-TT	`2026-07-10`
`ttl`	Nein	Ablauf: `7d`, `30d` oder `2026-12-31`	`7d`
`accessed`	Nein	Zugriffszähler (automatisch bei Abruf incrementiert)	`3`
`links`	Nein	Semikolon-getrennte Eintragsschlüssel (Graph-Kanten)	`patterns/zod-schemas`
`quality`	Nein	Qualitätsscore 0-1 (automatisch berechnet)	`0,80`
`confidence`	Nein	Konfidenzscore 0-1 (1,0=behauptet)	`1,00`
`lastAccessed`	Nein	ISO-Zeitstempel des letzten Zugriffs (automatisch aktualisiert)	`2026-07-10T12:00:00Z`
`priority`	Nein	Pin-Priorität 1-5 (0 = nicht angepinnt)	`0`
`path_scope`	Nein	Dateipfad-Scope für glob-basierten Abruf	`src/`
`origin`	Nein	Eintragsherkunft: `human`, `agent` oder leer	`agent`
`status`	Nein	Eintragsstatus: `active`, `obsolete`, `suppressed`, leer	`obsolete`
`supersededOn`	Nein	Datum, an dem der Eintrag superseded wurde	`2026-08-01`
`importance`	Nein	Explizite Wichtigkeit: `critical`, `high`, `medium`, `low` (leer = automatisch, Aktualität + Zugriffshäufigkeit)	`critical`

Vorteile

Weniger Tokens — Effizienter für LLM-Kontext
Bessere Genauigkeit — LLMs verstehen es besser als JSON
Verlustfrei — Kein Datenverlust bei der Konvertierung
Menschenlesbar — Einfach zu lesen und manuell zu bearbeiten