Loslegen

Mit KI bauen

Die Doku als reiner Text, damit dein Coding-Assistent die Anbindung für dich schreibt.

Die ganze Dokumentation gibt es als reinen Text. So kann ein Coding-Assistent wie Claude Code oder Cursor sie lesen und die Anbindung für dich schreiben.

1. Packlet anlegen

Das Packlet legst du selbst in der App an, wie im Schnellstart beschrieben. Den Schlüssel legst du als Umgebungsvariable SAMY_KEY ab. Gib ihn nicht in den Chat mit der KI.

Die App zeigt beim Verbinden unter Claude Code auch einen fertigen Auftrag, passend zur gewählten Kanal-Art.

2. Der KI die Doku geben

Adresse	Inhalt
/llms-full.txt	Die ganze Dokumentation in einer Datei. Im Zweifel diese.
/llms.txt	Kurzes Inhaltsverzeichnis mit Links auf alle Seiten als Markdown.
`/docs/<seite>.md`	Jede einzelne Seite als Markdown, zum Beispiel /docs/senden.md.

Auf jeder Seite der Doku steht oben außerdem der Knopf Seite für KI kopieren.

3. Auftrag geben

Kopier diesen Auftrag und ersetz den Teil in eckigen Klammern:

Text

Lies zuerst die Samy-Dokumentation unter https://packlets.app/llms-full.txt.

Baue dann in dieses Projekt eine Anbindung an Samy ein:
- Eine Funktion, die eine Nachricht über POST https://api.packlets.app/v1/push schickt.
- Der Schlüssel kommt aus der Umgebungsvariable SAMY_KEY und steht nie im Code.
- Fehler (400, 401, 409, 429) werden sichtbar gemeldet und nicht verschluckt.
- [Beschreibe hier, wann eine Nachricht kommen soll und welche Knöpfe sie hat.
  Bei einer App: welche Seite sie zeigen soll, zum Beispiel offene Rechnungen
  zum Freigeben.]

Wenn Knöpfe ohne url, Elemente oder ein Chat vorkommen: Baue zusätzlich einen
Webhook-Endpunkt, der die Signatur im Header X-Samy-Signature prüft und auf
type (button, ui, message) reagiert.

Bei einer App: Baue eine eigene Webseite mit samy.css und samy.js, setze sie
einmal mit PUT https://api.packlets.app/v1/ui und {"page": "https://…"}, und prüfe auf
deinem Server bei jeder Anfrage das Session-Token aus samy.fetch().

4. Prüfen

Lass die KI eine Testnachricht schicken und sieh in der App nach.
Kommt nichts an, zeigt das Protokoll in den Einstellungen des Packlets die letzten Aufrufe. Mehr dazu unter Fehlersuche.
Sieh nach, dass der Schlüssel nicht im Code oder im Repository gelandet ist.