# 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](https://packlets.app/docs/schnellstart.md) 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](https://packlets.app/llms-full.txt) | Die ganze Dokumentation in einer Datei. Im Zweifel diese. |
| [/llms.txt](https://packlets.app/llms.txt) | Kurzes Inhaltsverzeichnis mit Links auf alle Seiten als Markdown. |
| `/docs/<seite>.md` | Jede einzelne Seite als Markdown, zum Beispiel [/docs/senden.md](https://packlets.app/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](https://packlets.app/docs/fehlersuche.md).
- Sieh nach, dass der Schlüssel nicht im Code oder im Repository gelandet ist.