sylius-a2a — eine Karte, die sich nicht selbst widerspricht.

Drei handgepflegte Listen laufen zuverlässig auseinander

Dieselben Fähigkeiten eines Shops erscheinen an drei Stellen: in der Agent Card, im Agent-Skills-Index und in der MCP Server Card. Jedes dieser Formate hat eine eigene Struktur, aber keines hat einen eigenen Inhalt. Deshalb liest die Agent Card ihre Skills aus der gemeinsamen Registry, statt eine eigene Liste zu führen.

Drei Kopien von Hand zu pflegen ist der Weg, auf dem sie anfangen, sich zu widersprechen — nicht sofort, sondern beim zweiten oder dritten Skill, wenn eine der drei Stellen beim Nachtragen vergessen wird. Der Widerspruch fällt intern nicht auf, weil jede Datei für sich betrachtet gültig bleibt. Er fällt einem Client auf, der zwei davon abruft und sich entscheiden muss, welcher er glaubt.

Die Karte unter /.well-known/agent-card.json wird auch dann ausgeliefert, wenn kein Skill registriert ist. Sie ist Discovery, keine Fähigkeit: Sie beantwortet die Frage, ob dieser Shop überhaupt über A2A ansprechbar ist und wie. Ein 404 würde diese Frage mit Nein beantworten — obwohl die Antwort Ja lautet und nur die Liste der Fähigkeiten gerade leer ist.