Kai Ole Hartwig

sylius-llms-txt — eine Landkarte, kein Katalog.

llms.txt beschreibt, wie der Shop aufgebaut ist: Kategorien, Inhalte und die maschinenlesbaren Endpunkte. Nicht jedes einzelne Produkt — dafür gibt es Sitemap und Taxon-Seiten. llms-full.txt ist doppelt begrenzt, hört zwischen zwei Einträgen auf statt mitten in einem und sagt, dass es aufgehört hat.

Ein vollständiger Katalog wird zu einem abgeschnittenen Dokument

Die naheliegende Lesart von llms.txt ist ein Inhaltsverzeichnis aller Produkte. Bei zehntausend Produkten entsteht daraus ein Dokument, das jeder Crawler an irgendeiner Stelle abschneidet — und welche Stelle das ist, entscheidet nicht der Shop. Deshalb ist llms.txt hier eine Landkarte: Kategorien, Inhalte und die maschinenlesbaren Endpunkte. Produkte bleiben über Sitemap und Taxon-Seiten vollständig erreichbar, nur eben über die Wege, die dafür gebaut sind.

llms-full.txt ist doppelt begrenzt, über die Produktzahl und über ein Byte-Budget. Zwei Grenzen deshalb, weil eine allein nicht trägt: Eine reine Produktgrenze sagt nichts über die Größe, wenn die Beschreibungen lang sind, und ein reines Byte-Budget liefert bei kurzen Beschreibungen eine unabsehbar lange Liste. Erreicht das Dokument eine der beiden Grenzen, hört es zwischen zwei Einträgen auf und nicht mitten in einem — ein halb geschriebener Eintrag ist für einen Parser von einem vollständigen nicht zu unterscheiden. Und es sagt, dass es aufgehört hat, damit ein Client weiß, dass er einen Ausschnitt in der Hand hält.

Ausgeliefert wird nur aus dem Store, nie im Request erzeugt. Ein Dokument, das über den gesamten Katalog iteriert, gehört nicht in den Antwortpfad — dort ist es ein Werkzeug, mit dem sich der Shop von außen ausbremsen lässt, und zwar von genau den Clients, für die es gebaut wurde.

Vorberechnet ausgeliefert, begrenzt und über die eigene Grenze ehrlich

Sylius: 2.0+ · PHP: 8.2+ · Lizenz: MIT · Stand: 1.0.0

Quellcode & Doku

Composer-Paket

MIT · Sylius 2.0+ · PHP 8.2+

composer require koh/sylius-llms-txt

Gebaut, getestet und unter MIT veröffentlicht. Die öffentliche Distribution über Packagist wird vorbereitet (coming soon).

Teil der Familie

MIT

Dieses Paket gehört zu koh/sylius-agent-ready — siebzehn Bundles, die einen Sylius-Shop für KI-Agenten benutzbar machen. Jedes ist einzeln einsetzbar.

Zur Übersicht
Teil der Familie