Open SDKEigene agentische Apps entwickeln

Du bist mein Coding-Agent in Claude Code, Cursor oder einem vergleichbaren Agentic-IDE-Setup.

Ziel: Richte meine Entwicklungsumgebung ein und baue eine erste lauffähige Linkworld App mit dem Open SDK.

Kontext:
- Linkworld Apps bilden konkrete Geschäftsprozesse als agentische Apps ab.
- Ich konzentriere mich auf Prozess, App-Logik, Datenmodell, UI und fachliche Regeln.
- Linkworld übernimmt darunter Ausführung, Multi-LLM, Tenant-Isolation, Credentials, Tools, Security-Gates, Freigaben, Observability und Deploy.
- Die App soll später in der Linkworld Test-Console laufen und optional für den Marketplace paketiert werden.
- Die offizielle Dokumentation liegt unter https://docs.linkworld.ai/. Als LLM-Entry-Point gibt es https://docs.linkworld.ai/llms.txt.

WICHTIG — bevor du Architektur-Entscheidungen triffst, lies die Developer Patterns:
https://docs.linkworld.ai/developer/patterns/
Sie liefern für jeden gängigen Use-Case (Credentials speichern, Multi-Step-Workflows, auf E-Mails reagieren, Cross-App-Events, Drittanbieter-Integrationen, Mass-Sending) das richtige Linkworld-Primitive plus explizite Anti-Patterns mit Begründung. Generische Patterns ("State Machine für Cadences", "while-True-Polling", "API-Key in KV speichern") sind auf Linkworld die falsche Wahl — die Plattform hat erstklassige Primitive dafür (heartbeats, on_inbound + grants/wires, ctx.secrets, ctx.events.emit). Wenn du unsicher bist welches Primitive passt, ist die Antwort in den Pattern-Docs.

Vorgehen:
1. Prüfe zuerst, was lokal vorhanden ist: Node.js, npm/pnpm, Python/pip, Git, Docker, GitHub CLI und Linkworld CLI/SDK.
2. Installiere oder aktualisiere alles, was für die Linkworld SDK-Entwicklung notwendig ist. Nutze die offizielle Doku unter https://docs.linkworld.ai/ als Quelle.
3. Lies die Übersicht der Developer Patterns auf https://docs.linkworld.ai/developer/patterns/, bevor du die App-Architektur entwirfst.
4. Frage nach dem Geschäftsprozess, Zielnutzer, Eingabekanälen, benötigten Systemen, Datenquellen und Freigaben, falls diese Angaben fehlen.
5. Scaffolde die App mit dem Linkworld SDK:
   linkworld init <app-name> --lang typescript --github-owner <github-owner>
6. Definiere App-Modell, Manifest, Handler, Workflows, benötigte Tools, Berechtigungen und Human-in-the-Loop-Freigaben — entlang der relevanten Patterns. Überprüfe Manifest-Felder und Tool-Signaturen gegen die SDK-Reference, nicht extrapolieren.
7. Implementiere den wichtigsten Happy Path mit lokalen Mocks für Tool- und Secret-Aufrufe. Credentials gehen via ctx.secrets, nicht ctx.kv. Cadences laufen via manifest heartbeats, nicht via while-True-Loops. Externe API-Keys kommen aus install_settings + ctx.secrets.get(), nicht aus env oder Hardcode.
8. Führe `linkworld lint` aus. Beheben aller LWP-Findings (LWP001 blockt Deploy, LWP002-005 sind Warnings/Info). Jedes Lint-Issue verlinkt den passenden Pattern-Doc als Lösung. Verwende `# lwp:ignore=LWPxxx` (Python) / `// lwp:ignore=LWPxxx` (TypeScript) nur bei echten False-Positives mit Begründung im Code.
9. Ergänze Tests oder Prüfschritte für echte Beispieldaten und kritische Sonderfälle.
10. Erstelle eine kurze README mit Setup, lokalen Tests, Test-Console-Deploy, relevanten Docs-Links und Marketplace-Checkliste.
11. Halte die Implementierung klar, mandantenfähig und auditierbar. Keine echten API-Keys in Code oder Tests.

Starte mit dem Setup-Check. Wenn etwas fehlt, installiere es oder gib mir den exakten Befehl. Wenn genug Kontext vorhanden ist, lies die Pattern-Übersicht und lege dann Dateien an.